从 ~/.pi/agent/extensions/ 的本地实验文件收编为独立 pi 包: - extensions/commandcode-go.ts:provider commandcode-go,只走 CLI 内部端点 POST /alpha/generate;启动拉 /provider/v1/models 并过滤出 Go 套餐可用的 DeepSeek 模型;凭据按 env → ~/.commandcode/auth.json → pi auth.json 顺序验活 - extensions/commandcode-transient-retry.ts:把网关签名明确的偶发 400 改写为 可重试,复用 pi 内置退避重试 - 文档:README(安装/凭据/模型/风险/排查)、docs/protocol.md(线协议)、 LICENSE(MIT + 上游署名)
3.1 KiB
3.1 KiB
/alpha/generate 线协议要点
Command Code 官方 CLI 自己走的内网端点。它不是 OpenAI / Anthropic 兼容协议,models.json 无法表达,只能用 provider 扩展实现。以下事实来自逆向复验(command-code@1.88.5)与 MIT 许可的上游实现。
请求
POST https://api.commandcode.ai/alpha/generate
请求头:
| 头 | 值 |
|---|---|
Authorization |
Bearer user_... |
Content-Type |
application/json |
x-command-code-version |
1.88.5(伪装官方 CLI 版本) |
x-cli-environment |
production |
x-project-slug |
项目名 |
x-taste-learning |
false |
x-co-flag |
false |
User-Agent |
cli |
x-session-id |
会话 id |
x-cmd-zdr |
1(可选,零数据留存) |
请求体:
{
"config": { "workingDir": "...", "date": "...", "environment": {...}, "structure": "...", "isGitRepo": true },
"memory": "", "taste": "", "skills": [],
"permissionMode": "standard",
"params": {
"model": "deepseek/deepseek-v4.1-flash",
"messages": [...], // system 可用数组形式并带 cache_control
"tools": [...],
"system": [...],
"max_tokens": 131072,
"temperature": 0.2, // 可选
"stream": true,
"reasoning_effort": "high" // 可选,取值随模型目录的 reasoningEfforts
},
"threadId": "..."
}
约束:
- 工具参数 schema 必须是对象根(
type: "object")。 max_tokens服务端上限约 200K(实测 200 704 起 400),官方 CLI 取 131 072。tool-call id上限 64 字符;超长需确定性缩短,且调用与结果共用同一映射。- 历史 assistant 的
thinking必须回放为{ "type": "reasoning", "text": ... },否则 DeepSeek 思考模式的工具循环会被拒。
响应事件流
| 事件 | 含义 |
|---|---|
reasoning-start / reasoning-delta / reasoning-end |
思考块 |
text-start / text-delta / text-end |
正文 |
tool-input-start / tool-input-delta |
工具参数增量 |
tool-call |
完整工具调用 |
cache-write-tokens |
缓存写入计数 |
finish |
结束,带 totalUsage |
error |
错误,带 code(MODEL_NOT_IN_PLAN / UNAUTHORIZED / upgrade_required 等) |
abort |
中断 |
相关端点
| 端点 | 鉴权 | 用途 |
|---|---|---|
GET /alpha/whoami |
需要 | 验活 key(启动时逐把探测,5s 超时) |
GET /provider/v1/models?view=client |
不需要 | 能力元数据:minimumPlan、pricing、reasoningEfforts、context_length、inputModalities |
POST /provider/v1/* |
需要(且套餐要含 API 权限) | Go 套餐一律 403 upgrade_required |
上游来源
Mars-Sea/dsh-commandcode-provider(MIT):docs/agent-reference/adapter-protocol.md、buildCliBody()/handleCliEvent()。patlux/pi-commandcode-provider(MIT):0.7.12 的src/core.ts/src/converters.ts(序列化器、事件解码、reasoning 回放、tool-call 配对与 id 缩短)。
本项目是在这两份实现基础上裁剪出「只服务 Go 套餐」的单链路版本。