dsh-commandcode-plans-provider

配置 API Key

在 dsh 里进入 插件 → 本插件 → 配置：

API 密钥   [粘贴你的 key]                    [保存] [清除]
           ● 已保存（来源：file）· user_xxxx…ABCD

套餐档位   ( Go ) ( GOAT ) ( Pro ) ( ●Max )
           显示该档位及更低档位 · 配置状态 ready

           [测试连接]   网关可达 · 5 小时用量 0%

几点说明：

• 密钥写进 dsh 的凭据库（引用名 COMMANDCODE_API_KEY），不写进设置文档
• 读路径不返回明文 —— 这是 dsh 凭据服务的设计（"Secret values cross in one direction only"）。所以界面只显示掩码指纹 user_xxxx…ABCD，用来确认"当前用的到底是哪把 key"，而不是把密钥显示出来
• 测试连接会真的拿你的 key 打一次计费接口，成功/失败都给出原文（例如 key 失效会显示上游的 401）
• 不想用界面也可以：把 COMMANDCODE_API_KEY 写进 ~/.dsh/.credentials.yaml，或设为环境变量

---

使用

1. 选模型

设置 → 模型 → Command Code，然后选一个模型。名字后面的 [1M] 就是它的上下文容量，取自模型列表接口的 context_length（真实逐模型值，不是固定值）。

2. 选档位

在插件卡片里点档位按钮。语义是「显示该档位及以下包含的全部模型」：

档位	显示范围
Go	所有 Go 模型
GOAT	所有 Go + GOAT 模型
Pro	所有 Go + GOAT + Pro 模型
Max（默认）	全部（凡 catalog 标了已知档位的模型）

默认 max + 「档位未知的模型也显示」两者合起来 = 开箱不隐藏任何模型。

这是刻意的设计：不少同类实现默认档位是 go，导致 GOAT 用户看不到自己有权使用的模型。

3. 推理等级

模型选择器里的「推理等级」由本插件逐模型填充，列出该模型真实支持的档位（来自官方 CLI catalog 的 Efforts 列，比如 Low / Medium / High / X-High / Max）。

另有 Off —— 它表示不发送 reasoning_effort 字段，也就是让模型自己决定。

如果某个模型没有推理等级可选，选择器会显示"当前模型未提供推理等级"，这也是真实情况。

4. 用量

底部 composer 那一行会多出一个环：

Command Code ◯ 34%  2h13m

• 环 = 5 小时窗口的占用比例
• ≥90% 转红，用于提前发现"快用满了"
• 后面跟重置倒计时
• 点击展开：5 小时 / 周窗口 / 余额，以及各自的已用值与上限

注意：5 小时窗口用了 0% 时环是空的一圈，这是正常的，不是坏了。

5. 图片

支持视觉的模型可以直接贴图。

按官方 CLI 的分类，DeepSeek / GLM / Qwen / MiniMax / Grok 4.6 等是纯文本模型，给它们贴图会被明确拒绝（不是静默丢弃 —— 静默丢图会让你以为模型"看不见"是它笨）。换 Claude 或 Grok 4.5 这类模型即可。

关于图片有两个设计事实值得知道：

1. 网关是无状态的：不保存图片，也没有上传接口。所以每轮都要把整段历史里的图片重新内联发送（官方 CLI 同样是这个行为）。这意味着同一张图在第 3 轮对话里仍要再付一次开销。
2. 有总预算：一轮里内联的 base64 总量超过 maxRequestImageBytes（默认 2 MiB）时，插件不发请求，而是要求 dsh 先把最旧的图片 offload 掉再重试。所以没有图片会被无声地丢弃。

---