前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。Command Code 订阅主要分为两类：Provider API 计划和 Go/GOAT/Pro/Max 计划。前者原生支持，后者调用标准 OpenAI 兼容端点会返回 403 upgrade_required，只能走私有网关 POST /alpha/generate。
本插件复刻了该私有网关的协议 —— 请求信封、逐行 JSON 流、事件映射 —— 把订阅变成一个 DSH 原生 Provider。使用者不需要安装 Command Code CLI，也不需要 Provider API。
核心功能¶
- 实时模型目录：启动时拉取，按档位过滤，默认不隐藏任何模型。
- 模型名标注上下文容量：如
Claude Sonnet 5.5 [1M]、GPT-5.5 [400K]，取自模型列表接口的真实值。 - 逐模型推理等级：只列出该模型真实支持的档位。
- 可视化配置 API Key：在插件卡片里粘贴保存即可，不用手改配置文件。
- 底部用量环：显示 5 小时窗口占用比例与重置倒计时（≥90% 时转红），点击可展开周窗口与余额。
- 支持图片输入、工具调用、流式输出。
安装与启用¶
通过 DSH 的插件管理器安装：
dsh plugin --profile web add github:freeqin123/dsh-commandcode-plans-provider
如果报 ERR_PNPM_ADDING_TO_ROOT，说明你的 profile 目录是一个 pnpm 工作区，需加上 -w：
dsh plugin --profile web add -w github:freeqin123/dsh-commandcode-plans-provider
安装后必须重启 DSH 才能生效。插件列表里会出现本插件（bundle id 为 commandcode-plans-provider）。
配置 API Key¶
在 DSH 里进入 插件 → 本插件 → 配置：
- API 密钥：粘贴你的 key 并点击保存。密钥写入 DSH 凭据库，引用名为
COMMANDCODE_API_KEY。界面只显示掩码指纹以确认身份。 - 测试连接：点击按钮可验证网关可达性，失败会返回上游原文（如
401）。 - 套餐档位：点击档位按钮（Go / GOAT / Pro / Max）选择套餐，配置状态会显示为 ready。
典型用法¶
1. 选模型¶
进入 设置 → 模型 → Command Code，选择一个模型。名字后面的 [1M] 代表上下文容量。
2. 选档位¶
在插件卡片里点档位按钮。语义是“显示该档位及以下包含的全部模型”：
- Go：所有 Go 模型
- GOAT：所有 Go + GOAT 模型
- Pro：所有 Go + GOAT + Pro 模型
- Max（默认）：全部（凡 catalog 标了已知档位的模型）
3. 选推理等级¶
模型选择器里的“推理等级”由本插件逐模型填充，列出该模型真实支持的档位（如 Low / Medium / High / Max）。如果模型不支持，选择器会显示“当前模型未提供推理等级”。
4. 查看用量¶
底部 composer 那一行会多出一个环，显示 5 小时窗口的占用比例。环 ≥90% 时会转红，后面跟重置倒计时。点击环可展开查看 5 小时/周窗口/余额的详情。
5. 处理图片¶
支持视觉的模型可以直接贴图。注意：
- 纯文本模型（如 DeepSeek / GLM / Qwen）会明确拒绝图片输入。
- 网关无状态，长对话中图片需重复内联发送。
- 一轮里内联的 base64 总量超过 2 MiB 时，会要求丢弃最旧的图片。
已知限制¶
- 未公开接口：使用的是
/alpha/generate私有网关，官方可能随时改动或封禁。 - 单账号：不支持多账号并行。
- 无自动重试：遇到
RATE_LIMIT不会自动重试，需手动重试。 - 图片重复开销：长对话中图片会重复内联，增加开销。
- 纯文本限制：部分模型明确拒绝图片输入。
生态背景¶
DSH 的插件目录由社区维护，与 DeepSeek 或幻方无官方从属关系。本插件代码托管在 GitHub，遵循 MIT 许可证。
