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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user