docs: 更新 v0.2 设计 - 修正 GLM-5.2 端点,gotty 替换为 ttyd

- GLM-5.2 端点修正为: https://open.bigmodel.cn/api/paas/v4
- gotty 替换为 ttyd (C 实现,性能更好)
- 验证端点正确,API Key 有效但余额不足
- 更新实施状态: 环境准备完成
This commit is contained in:
2026-06-30 08:03:41 +08:00
parent b23773e9ad
commit 5810deb6ec
+58 -31
View File
@@ -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