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

81 lines
3.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# `/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 套餐」的单链路版本。