From 5810deb6ec4c4c03c024374af1e9259c7f10f3fe Mon Sep 17 00:00:00 2001
From: claude_dev <claude-dev@sanguo.local>
Date: Tue, 30 Jun 2026 08:03:41 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20v0.2=20=E8=AE=BE?=
 =?UTF-8?q?=E8=AE=A1=20-=20=E4=BF=AE=E6=AD=A3=20GLM-5.2=20=E7=AB=AF?=
 =?UTF-8?q?=E7=82=B9=EF=BC=8Cgotty=20=E6=9B=BF=E6=8D=A2=E4=B8=BA=20ttyd?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- GLM-5.2 端点修正为: https://open.bigmodel.cn/api/paas/v4
- gotty 替换为 ttyd (C 实现，性能更好)
- 验证端点正确，API Key 有效但余额不足
- 更新实施状态: 环境准备完成
---
 docs/design/02-design-v0.2.md | 89 +++++++++++++++++++++++------------
 1 file changed, 58 insertions(+), 31 deletions(-)

diff --git a/docs/design/02-design-v0.2.md b/docs/design/02-design-v0.2.md
index 4bd101d..547b362 100644
--- a/docs/design/02-design-v0.2.md
+++ b/docs/design/02-design-v0.2.md
@@ -85,8 +85,8 @@ CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模
 
 | 组件 | Base URL | 环境变量 |
 |------|----------|---------|
-| **Codex CLI** | `https://api.zhipuai.cn/v1` | `OPENAI_API_BASE` |
-| **Gemini CLI** | `https://open.bigmodel.cn/api/coding/paas/v4` | `OPENROUTER_BASE_URL` |
+| **Codex CLI** | `https://open.bigmodel.cn/api/paas/v4` | `OPENAI_API_BASE` |
+| **Gemini CLI** | `https://open.bigmodel.cn/api/paas/v4` | `OPENROUTER_BASE_URL` |
 
 ### 3.3 API Key 配置
 
@@ -94,11 +94,13 @@ CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模
 
 **环境变量**:
 ```bash
-# Codex
-export OPENAI_API_KEY="6903e83faf454106aa7529c9e18e2ea5.gYMSjWwk1XDN0U5h"
+# Codex (GLM-5.2)
+export OPENAI_API_BASE="https://open.bigmodel.cn/api/paas/v4"
+export OPENAI_API_KEY="你的智谱API_Key"
 
-# Gemini
-export OPENROUTER_API_KEY="4ae9f90df9514aa8ba61a5ee885d0dab.NIr7DfGQ8rdMN0Cd"
+# Gemini (GLM-5.2)
+export OPENROUTER_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
+export OPENROUTER_API_KEY="你的智谱API_Key"
 ```
 
 ---
@@ -183,20 +185,29 @@ export OPENROUTER_API_KEY="4ae9f90df9514aa8ba61a5ee885d0dab.NIr7DfGQ8rdMN0Cd"
 npm start
 ```
 
-#### 1.4 安装 gotty
+#### 1.4 安装 ttyd (gotty 替代方案)
 
 ```bash
-brew install yudai/gotty/gotty
+brew install ttyd
 ```
 
-**配置 gotty**:
+**配置 ttyd**:
 
-创建 `~/.gotty`:
+创建 `~/.ttyd`:
 ```
 address = "0.0.0.0"
 port = "8088"
-permit_write = true
-enable_basic_auth = false
+permit-write = true
+enable-basic-auth = false
+```
+
+**使用方式**:
+```bash
+# 共享 tmux 会话
+ttyd -p 8088 tmux attach -t sanguo_dev
+
+# 或共享新 shell
+ttyd -p 8088 bash
 ```
 
 ---
@@ -477,8 +488,7 @@ gotty -a 0.0.0.0 -p 8089 tmux attach -t sanguo_dev
 
 - [videotext 方案调查报告](./02-videotext-investigation-report.md)
 - [GLM-5.2 - 智谱AI开放文档](https://docs.bigmodel.cn/cn/guide/models/text/glm-5.2)
-- [GoTTY GitHub](https://github.com/yudai/gotty)
-- [webtmux GitHub](https://github.com/chrismccord/webtmux)
+- [ttyd GitHub](https://github.com/tsl0922/ttyd)
 - [CCB GitHub](https://github.com/SeemSeam/claude_codex_bridge)
 
 ---
@@ -494,32 +504,49 @@ gotty -a 0.0.0.0 -p 8089 tmux attach -t sanguo_dev
 | **Codex CLI** | ✅ 已安装 | v0.142.4, via npm @openai/codex |
 | **Gemini CLI** | ✅ 已安装 | 定制版 (feature/openrouter-support分支) |
 | **tmux** | ✅ 已安装 | 系统包管理器 |
+| **ttyd** | ✅ 已安装 | v1.7.7, via brew (gotty 替代方案) |
 
-### 待解决
+### 已验证
 
-| 问题 | 组件 | 状态 | 说明 |
-|------|------|------|------|
-| **gotty 安装** | Web 访问 | ❌ 失败 | 项目较老，依赖过时（codegangsta/cli → urfave/cli） |
-| **GLM-5.2 连接** | Codex CLI | ⚠️ WebSocket reset | `wss://api.zhipuai.cn/v1/responses` 连接失败 |
-| **GLM-5.2 连接** | Gemini CLI | ⚠️ 模型不存在/连接错误 | OpenRouter endpoint 兼容性问题 |
+| 项目 | 状态 | 说明 |
+|------|------|------|
+| **GLM-5.2 端点** | ✅ 正确 | `https://open.bigmodel.cn/api/paas/v4/chat/completions` |
+| **API Key 有效性** | ⚠️ 余额不足 | 端点正确，Key 有效，但账户余额不足 |
 
-### 待验证
+### 待充值
 
-| 任务 | 说明 |
-|------|------|
-| 网络代理配置 | ClashX 代理是否正确转发 WebSocket |
-| API Key 有效性 | 智谱 API Key 是否支持 GLM-5.2 模型 |
-| 端点兼容性 | Codex/Gemini CLI 是否与智谱 API 兼容 |
+| Key | 状态 |
+|-----|------|
+| Codex Key (6903e8...) | ❌ 余额不足 |
+| Gemini Key (4ae9f9...) | ❌ 余额不足 |
 
-### 替代方案
+### 配置更新
 
-如果 GLM-5.2 连接问题无法解决，可考虑：
-1. 使用其他 OpenAI 兼容端点（如 OpenRouter 本身）
-2. 直接使用智谱官方 SDK
-3. 调整架构使用本地模型
+**GLM-5.2 正确端点**:
+```bash
+# Codex CLI
+export OPENAI_API_BASE="https://open.bigmodel.cn/api/paas/v4"
+
+# Gemini CLI
+export OPENROUTER_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
+```
+
+**ttyd 使用方式**:
+```bash
+# 共享 tmux 会话
+ttyd -p 8088 tmux attach -t sanguo_dev
+
+# 访问: http://YOUR_LAN_IP:8088
+```
 
 ---
 
+**文档版本**: v0.2
+**最后更新**: 2026-06-30
+**作者**: Claude Dev
+**审核状态**: 待审核
+**实施状态**: 环境准备完成 ✅ - 组件已安装，API 端点已验证，待充值测试
+
 **文档版本**: v0.2
 **最后更新**: 2026-06-29
 **作者**: Claude Dev