Files
cat-shark 657fe90fd3 feat: commandcode-pi 0.1.0 — Command Code Go provider over /alpha/generate
从 ~/.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 + 上游署名)
2026-11-16 18:17:49 +08:00

3.1 KiB
Raw Permalink Blame History

/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 套餐」的单链路版本。