# `/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`(可选,零数据留存) | 请求体: ```jsonc { "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 套餐」的单链路版本。