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 + 上游署名)
This commit is contained in:
2026-11-16 18:17:49 +08:00
commit 657fe90fd3
8 changed files with 1377 additions and 0 deletions
+80
View File
@@ -0,0 +1,80 @@
# `/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 套餐」的单链路版本。