Mars-Sea/dsh-commandcode-provider

Command Code provider plugin for DeepSeek Harness (dsh). Adds Command Code model access, live model catalog, plan-aware model selection, reasoning effort, image input, web search, and multi-account support.

dsh‑commandcode‑provider – 这是什么

dsh‑commandcode‑provider 是一个非官方插件，让 DeepSeek Harness（用于 LLM 驱动代理的“dsh”UI 框架）能够与 Command Code 大型语言模型服务进行对话。它新增了一个名为 commandcode 的提供者，出现在 DeepSeek 内置模型旁边，让您可以选择 Command Code 模型、查看使用配额，甚至通过 Command Code 的 API 执行网络搜索。

为什么您会需要它

一键集成 – 使用单一 dsh plugin add 指令安装插件，提供者就会出现在模型选择器中。
完整 UI 支持 – 基于网页的 dsh UI 和仅限终端的 dsh‑TUI 都提供设置页面，您可以在其中登录、管理多个 Command Code 账号，并切换功能（配额卡、零数据保留、网络搜索等）。
多账号轮替 – 如果您有多个 Command Code 订阅，当当前账号达到配额时，插件会自动切换到下一个账号。
方案感知模型选择器 – 模型会标注方案等级、免费/付费标签、图像支持和推理工作量选项；超出方案的模型默认会隐藏。
成本估算 – Token 计数器会根据模型公布的费率显示每次请求的预估成本。
视觉支持 – 具备视觉能力的 Command Code 模型可接受图像；可选的缓存卸载设置可减少重复的图像缓存费用。
网络搜索工具 – dsh web_search 工具可以由 Command Code 的 /alpha/web‑search 端点支持，无需额外的密钥。

如何开始使用

安装（兼容于 dsh 0.2.0‑rc.2 或 0.2.1‑alpha.1）：
```
dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest
```
如果您也使用终端 UI，请针对 dsh‑tui 配置文件重复安装步骤。
获取 Command Code API 密钥 – 通过官方 command-code CLI (cmd login) 或点击设置页面中的 Sign in to Command Code 按钮。
输入密钥 于 Settings → Command Code（或在您的环境中设置 COMMANDCODE_API_KEY）。
选择模型 – 新的 commandcode 项目会出现在模型选择器中，例如：
```
/model commandcode/deepseek/deepseek-v4.1-flash
```
开始对话 – 该提供者在 dsh 中的运行方式与其他 LLM 相同；您将看到配额信息、成本估算以及（若已启用）图像处理功能。

功能概览

功能	作用	控制位置
插件套件	注册 `commandcode` 提供者路由与即时模型目录。	`dsh plugin add`
设置页面	管理 API 密钥、账号轮替、模型可见度、隐私开关。	UI → Settings → Command Code
多账号轮替	当配额耗尽时自动切换至下一个账号。	Settings → Accounts card
方案感知模型选择器	隐藏超出订阅层级的模型；显示标签、上下文窗口、图像支持。	Model picker UI
推理工作量等级	显示允许选择低/中/高工作量的模型。	Model picker (if model supports)
图像输入与缓存卸载	视觉模型接受图像；可选的 `offloadSeenImagesForCache` 以占位符取代旧图像，避免缓存激增。	Settings → Advanced
配额卡	侧边栏面板，显示当前的 5 小时与每周使用量、信用余额、重置计时器。	Settings → Integrations & display → “Show quota card”
会话成本估算	Token 计数器旁显示的预估成本 (`≈`)。	Composer UI
网络搜索集成	`web_search` 工具使用 Command Code 的 `/alpha/web-search` 端点。	Settings → Command Code → “Serve dsh web search with Command Code”
零数据保留 (ZDR)	发送 `x‑cmd‑zdr: 1` 标头，确保提示词不会被存储或用于训练。	Settings → Privacy & security

谁应该使用它

dsh 用户，想要在不离开 dsh 环境的情况下体验 Command Code 模型（包括最新的 DeepSeek 模型）。
拥有多个 Command Code 订阅的团队 – 轮替逻辑让您无需手动更换密钥。
需要视觉功能的开发者 – 插件支持具备图像能力的模型，并提供缓存卸载选项以控制成本。
任何想要成本可见度的人 – 内置的成本估算和配额卡有助于保持使用量的可预测性。

限制与注意事项

仅适用于 dsh 0.2.0‑rc.2 或 0.2.1‑alpha.1 – 不支持旧版 dsh。
pnpm 11 年龄限制 – 使用 @latest 时可能会跳过近期版本；若需要最新构建，请锁定确切版本。
零数据保留默认关闭 – 若隐私是优先考量，您必须手动启用它。
缓存卸载为选用 – 开启它会改变图像缓存的方式，并可能影响模型行为。
非官方 Command Code 产品 – 您必须提供自己的 API 密钥并遵守 Command Code 的条款。

快速参考指令

# 安装于网页 UI
 dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest

# 安装于终端 UI
 dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.15

# 选择模型
 /model commandcode/deepseek/deepseek-v4.1-flash

# 显示各账号使用量
 /commandcode   # 或 /commandcode status

简而言之： dsh‑commandcode‑provider 是一个由社区维护的桥梁，将 Command Code 的 LLM 目录、配额管理、视觉与网络搜索功能带入 DeepSeek Harness 生态系统，并具备丰富的 UI 以及针对多账号与成本感知使用的合理默认值。