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:
@@ -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 套餐」的单链路版本。
|
||||
Reference in New Issue
Block a user