@mars-sea/dsh-commandcode-provider

dsh plugin --profile web add @mars-sea/dsh-commandcode-provider

dsh-commandcode-provider

[English](./README.md) | 简体中文








非官方 DeepSeek Harness 的 LLM provider 插件，用于 Command Code，移植自 pi-commandcode-provider（MIT 协议）。

这是一个社区集成。你需要自己的 Command Code 账号、API key 或订阅，并遵守 Command Code 的服务条款。本项目与 Command Code, Inc. 无关。

快速上手

已验证引擎 · dsh 0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5、0.2.2-alpha.2、0.2.2-alpha.3、0.2.2-rc.1

Node.js · >=24.9 —— 0.16.0 起从 22 提高，见[需要 Node.js 24.9 或更高版本](#需要-nodejs-249-或更高版本)

安装 —— 网页端 · dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest

安装 —— 终端端 · dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@latest

配置文件 · $DSH_HOME/settings.yaml → llm-commandcode:

API key 环境变量 · COMMANDCODE_API_KEY

用量面板 · /commandcode

功能一览

• 插件包：一条 dsh plugin add 命令安装 commandcode provider 路由，带实时模型目录。
• 设置页：账户列表（密钥、网页登录、实时额度、专用模型）、模型显示、隐私开关与连接参数。
• 目录带标注：模型选择器里标注套餐档位、折扣/FREE 徽章、峰谷时段、图片支持与上下文长度，免费模型置顶。
• 多账户轮换：一个账户用量打满后自动切换到下一个；可固定优先账户，也可把模型指派给专用账户。
• 浏览器内登录获取 key：一键发起官方授权流程，完成后密钥自动写入本机凭据服务。
• 套餐与配额面板：可选的侧边栏卡片，显示当前服务账号的套餐、5 小时 / 每周两个配额窗口、余额与重置时间。
• 会话费用估算：在输入框下方的 token 计数旁显示估算金额（≈），按持久化历史逐次请求计价。
• 模型分析：按最近会话或日期查看词元、估算成本、响应速度与失败/重试。[统计口径](docs/模型成本与性能分析.md)。
• 联网搜索：dsh 的 web_search 工具由 Command Code 承载（/alpha/web-search），复用聊天同一个 key 与端点。
• 零数据保留：可选的 ZDR 路由（x-cmd-zdr: 1），默认关闭。
• 上下文与输出上限：可全局或按模型覆盖宿主计量的上下文窗口，也可限制或省略单轮 max_tokens。
• 推理强度与图片：支持推理强度的模型在选择器中可选档位；Vision 模型支持发送图片。
• 终端界面：同一次安装即可服务 [dsh-TUI](#终端界面dsh-tui) 配置，终端里有自己的 /settings → Command Code 页面。

界面截图

模型选择器 —— 套餐档位、折扣/FREE、峰谷时段、Image 与上下文标注：

<img src="assets/screenshots/model-picker.png" alt="带套餐、折扣、图片与上下文标注的模型选择器" width="320">

用量面板 —— /commandcode 的分账户报告：

<img src="assets/screenshots/usage-dashboard.png" alt="用量面板" width="520">

设置页 —— 带实时额度的账户列表、模型显示、隐私开关与连接参数：

<img src="assets/screenshots/settings-page.png" alt="Command Code 设置页面（含账户用量卡片）" width="640">

安装

dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest

本构建准入 dsh >=0.2.1-rc.2 <0.2.2-0 —— 0.2.1 通道中 0.2.1-rc.2 及以后的每个 RC —— 以及 >=0.2.2-alpha.2 <0.2.3-0，即 0.2.2 通道从当前 alpha 起的每个版本。0.2.1-rc.5 是 npm latest 指向的版本，0.2.2-rc.1 挂在 next、0.2.2-alpha.3 挂在 alpha；这七个版本都跑过完整引擎矩阵（npm run test:engine、npm run test:install）。两个通道中更晚的版本无需更新插件即可准入，但在 dsh.compatibility.dshReleases 补上记录之前不算已验证。0.2.3 及以后被刻意排除 —— 两个区间上界分别写成 <0.2.2-0 与 <0.2.3-0 正是为了这一点。使用 0.2.0-rc.2、0.2.1-alpha.5 或更早版本的配置需先升级引擎，再安装本构建。兼容性细节 —— engines.dsh 准入规则、按引擎配对的包版本、验证证据 —— 见[引擎兼容](docs/agent-reference/engine-compatibility.md)。

需要 Node.js 24.9 或更高版本

Node.js 下界已在 0.16.0 从 22 提到 24.9。如果你在用 Node 22 或 23，请先升级 Node，再更新本插件。

dsh 0.2.2-alpha.2 自己声明 engines.node >=24.9.0，而本插件准入这个引擎，所以整包的 Node 下界必须跟着抬到同一水位：一个声称支持某引擎的插件，不该能被装到一个那个引擎根本起不来的 Node 上。实际影响：

• 在 Node 22/23 上安装或更新本插件时，npm 会报 EBADENGINE。这是警告而非硬失败 —— 除非你的 npm 设了 engine-strict=true。
• 0.2.2 的引擎在 Node 22/23 上确实跑不起来，被准入却启动失败正是这条下界要挡的情况。
• 0.2.1 的 RC 引擎仍能在 Node 22 上运行，但 engines.node 是整包唯一的下界，所以对它们同样生效。这是在一个构建里同时准入两个通道的代价。

执行 nvm install 24 && nvm use 24（或换用任意 Node 24.9+ 发行版）即可解决。Node 24 是当前 LTS 线。

更早的 dsh 版本已不再支持：覆盖 dsh 0.1.7 的最后一个插件版本是 0.11.17，0.1.2–0.1.6 线的最后一个版本是 0.11.11，0.5.0 时代 Harness 线的最后一个版本是 0.9.1 —— 三者都按精确版本安装，且都不再维护。

pnpm 11 会拦下刚发布的新版本。 它的 minimumReleaseAge 默认为 1440 分钟，发布不足一天的版本会被跳过，@latest 解析到上一个版本 —— 而且是静默的，命令照样以成功退出。想装 24 小时内发布的版本，必须写精确版本号：@mars-sea/dsh-commandcode-provider@0.11.15。这一点对每个 profile 都成立，包括下面的终端界面。

更新 —— 用与安装时相同的 tag，然后重启 Web 应用。每个 profile 各自更新 —— 终端界面有独立的插件列表：

dsh plugin --profile web update @mars-sea/dsh-commandcode-provider@latest
dsh plugin --profile dsh-tui update @mars-sea/dsh-commandcode-provider@latest

获取 API key 并验证

最简单的途径是官方 CLI（Node.js 22+）：

npm i -g command-code@latest
cmd login        # macOS/Linux；Windows 原生版：cmdc login

也可以不装 CLI，直接在 设置 → Command Code 点击「登录 Command Code」：浏览器会打开 commandcode.ai 授权页（与 cmd login 相同的流程），完成后密钥自动写入本机凭据服务。还可以在 Keys 设置页 创建 key 后手动粘贴，或 export COMMANDCODE_API_KEY="user_..."。

登录流程依赖 Host 与浏览器在同一台机器（回环回调）。Host 在远程机器上时请使用手动粘贴；若组合配置里写了字面量 apiKey，它仍优先于登录写入的凭据。

验证方式：重启后，在 设置 → Command Code 填入 API key 并保存。设置 → Models 出现 Command Code 卡片，模型选择器在 commandcode 下列出实时目录。选择套餐内包含的模型发送消息即可。

终端界面（dsh-TUI）

每个 dsh profile 有独立的插件列表，所以上面那条 Web 安装命令不会装到终端里 —— 还要把插件装进 dsh-tui profile，并写死精确版本号（新版本发布后的 24 小时内，只写包名或 @latest 会被静默解析到上一个版本，结果就是全新的终端安装既没有 /settings → Command Code 页面，也看不到任何 commandcode 模型）：

dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@latest

之后在模型选择器里选，或者直接指定：

/model commandcode/deepseek/deepseek-v4.1-flash

/model 会列出所有已注册的 provider，Command Code 的实时目录连同套餐/优惠/上下文标注一起出现；`/c

…(truncated)