它是什么
Command Code Provider 在 DeepSeek Harness 里注册一条 commandcode provider 路由,背后是 Command Code——一家第三方付费中转服务。它是非官方的社区集成,从 pi-commandcode-provider(MIT)移植而来。README 把这层关系说得很直白:你需要自己的 Command Code 账号、API key 或订阅,Command Code 的条款对你适用,本项目与 Command Code, Inc. 无任何隶属关系。
下面所有能力都建立在这个账号之上:带套餐标注的实时模型目录、内嵌浏览器登录的设置页、多账号轮换、web_search 后端、配额仪表盘和会话费用估算——Web 界面与终端界面(dsh-TUI)同时覆盖。
具体能力
- 模型选择器里的实时目录 —— 标注最低套餐档、当前优惠或
FREE徽章、峰谷时段状态、图片输入支持与上下文窗口,免费模型排在最前。目录本身不需要 key 即可浏览,对话请求则需要。 - 按套餐过滤的选择器 —— 超出你订阅档位的模型默认隐藏(可开关);可选的模型白名单只保留你勾选的模型。
- 推理强度与图片输入 —— 支持可选推理强度(reasoning effort)的模型会在选择器里暴露档位;Vision 模型接受图片输入。
- 浏览器内 OAuth 登录 —— 设置页可以直接发起与
cmd login相同的官方授权流程,批准后 key 自动落入本地凭据服务。手动粘贴和COMMANDCODE_API_KEY环境变量仍是备选。该流程要求 Host 与浏览器在同一台机器(回环回调);远程 Host 场景请手动粘贴 key。 - 多账号轮换 —— 某个账号触及用量上限时,请求自动切到下一个账号;可钉住活动账号,也可按模型配置路由规则(先匹配先生效)。启用前请先读「已知限制」。
- 套餐与配额面板 —— 可选的侧栏卡片(默认关闭),点开是完整仪表盘:计费周期、5 小时与每周两条窗口进度条及重置时刻、月度额度消耗与余额。需要 dsh
0.1.5-rc.1及以上;卡片隐藏时不跑任何后台用量轮询。 - 会话费用估算 —— 在输入框旁的 token 计数边上给出按公布费率计算的
≈估算,取自持久化的会话历史;历史请求不会因后续变化被重新计价。README 明确说明:这是按本地价格快照算出的估算值,不是 provider 账单。 - Web 搜索 —— dsh 的
web_search工具由 Command Code 的/alpha/web-search端点承接,与对话共用同一把 key 和同一个 base URL;默认开启,关闭后会把选择权还给之前被顶替的搜索后端。 - 终端界面支持 —— 同一个包也能服务
dsh-tuiprofile,自带/settings→ Command Code 设置页和/commandcode用量仪表盘。每个 dsh profile 各自维护插件列表,终端侧需要单独安装一次。
运行要求
- Node 需
>=22,来自engines字段。 - Harness —— 清单里
dsh.compatibility.dsh的原文范围见 frontmatter:共八个版本被标为兼容,从0.1.2-rc.1到0.1.6-alpha.2。不要假定该列表之外的版本也能用。 - 配额面板需要 dsh
0.1.5-rc.1及以上。Web 搜索需要部署里挂了 web 能力(@deepseek-ai/dsh-web+@deepseek-ai/dsh-tool-web),否则插件只提供对话能力。 - TUI 场景要求引擎从
@deepseek-ai/dsh-llm导出ToolCallId(dsh0.1.2-alpha.3及以上);README 明确说在0.1.0-rc.6或0.1.1-rc.2上模块导入直接失败,TUI 无法启动。 - 客户端平台为
web,注入四个客户端包(dsh-client-connection、dsh-client-locale、dsh-client-ui-settings、dsh-api-remotes)。react ^18.2.0与一长串@deepseek-ai/*包以 peer 依赖形式由 profile 提供。 - 安装期构建:
package.json声明了prepare: tsdown生命周期脚本(与build同一条命令)。从 npm 仓库安装时拿到的是预构建好的lib/;从 git 或本地目录安装则会在安装时现场执行这条构建。 - 旧版 Harness:0.5.0 时代的 Harness 需要按 README 的版本线表精确钉住
@0.9.1——那条线已停止维护。
权限与隐私
README 的原话:插件只在你的本地 dsh profile 与你的 Command Code 账号之间通信;本地只触碰凭据存储与模型缓存(外加 ~/.commandcode/auth.json 作为最后兜底),网络上只调用 Command Code API,无遥测。这属于作者自述——本条目没有任何独立审计记录。
已知限制
- 它面前站着一家付费第三方中转。 没有你自己的 Command Code key 或订阅,插件什么都做不了;经由它发出的一切请求都受 Command Code 条款约束。
- 自动账号轮换可能触碰这些条款。 它的招牌能力之一,就是在某个付费账号触顶的瞬间自动切到下一个账号。这种绕开配额窗口的轮换是否符合 Command Code 的条款,README 没有回答——配置轮换之前请自己去读条款。
- 图片输入由模型决定;在带图片的会话里切到纯文本模型会被 dsh 拒绝。
- 不支持
stop序列——携带它的请求会失败。 - 超长多图会话只是被缓解而非被解决:provider 对单请求有约 50 MB 的上限(未公开文档),插件会把最旧的图片替换成一条简短的「image omitted」说明,超限请求会以小得多的图片预算重试一次再失败。
- 历史推理只在「工具调用有配对结果」时才会被回放。
- pnpm 11 的
minimumReleaseAge会在新版本发布后的 24 小时内把@latest静默解析成上一个版本——想要最新构建请钉精确版本号,TUI profile 里尤其要钉:装到旧版的表现是连 Command Code 设置页都不出现。
什么时候用它、什么时候不要用
已经在为 Command Code 付费(或打算付费)、并希望它在 dsh 里成为一等 provider 时,用它:按套餐过滤的选择器、浏览器内登录、配额面板和 web 搜索接线,省掉了中转服务通常需要的手工配置;TUI 支持的完整度在社区插件里也少见。
不要指望它是免费的模型来源——插件本身不提供任何超出你订阅内容的服务。如果你判断配额驱动的自动轮换与 provider 条款相冲突、工作流依赖 stop 序列,或者 harness 版本落在那八个兼容版本之外且无法升级,都请跳过它。
安装
dsh 0.1.2-rc.1 及以上:
dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest
更旧的 0.5.0 时代 Harness 请改为精确钉住最后支持的版本:@mars-sea/dsh-commandcode-provider@0.9.1。终端界面是独立 profile——用 --profile dsh-tui 加精确版本号再装一次。装完重启 Web 应用,然后在 Settings → Command Code 填入 key(或直接点 Sign in to Command Code),选一个你套餐内可用的 commandcode 模型即可。
