dsh-commandcode-provider

English | 简体中文

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

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

功能一览

• 插件包：一条 dsh plugin add 命令安装到任意 dsh 配置，注册 commandcode provider 路由，带实时模型目录。
• 专属设置页：API key 输入、连接参数、实时「账户用量」卡片和「隐藏套餐外模型」开关。
• 浏览器内登录获取 key：设置页一键发起官方授权（与 cmd login 同一流程），完成后密钥自动写入本机凭据服务，无需手动创建或粘贴；不可用时随时退回手动粘贴。
• 多账户轮换：一个账户用量打满后，请求自动切换到下一个账户。详见多账户轮换。
• key 配置灵活：设置页填写、环境变量或官方 CLI 登录文件均可。
• 模型选择器标注：每个模型标注最低套餐、折扣/FREE 徽章、峰谷时段、图片支持与上下文长度，免费模型置顶。
• 按套餐过滤：默认隐藏超出订阅套餐的模型，可一键关闭。
• 推理强度支持：支持推理强度的模型可在选择器中选择档位。
• 图片输入：Vision 模型支持发送图片。

安装

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

更新

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

然后重启 Web 应用。

获取 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 下列出实时目录。选择套餐内包含的模型发送消息即可。

用量面板

插件注册了 /commandcode 斜杠命令，显示各账户的用量状态：

/commandcode        （或 /commandcode status）

多账户轮换

有多个 Command Code 订阅时，插件可以在一个账户达到用量限额后自动切换到下一个账户：

• 配置：在 设置 → Command Code 的「多账户轮换」卡片添加账户并填写备注名与 API key；顶层 key 始终是第一顺位的 default 账户。
• 手动切换：卡片上的「当前使用账户」下拉框可指定优先账户；所选账户耗尽时自动回落到其他账户，窗口重置后自动恢复。
• 状态展示：「账户用量」卡片与 /commandcode 均按账户分别显示状态。

等价的 YAML（$DSH_HOME/settings.yaml 或组合配置）：

llm-commandcode:
  apiKeyEnv: COMMANDCODE_API_KEY        # 第一顺位（default）账户
  activeAccount: COMMANDCODE_API_KEY_2   # 可选：手动指定当前账户（default 或某账户的凭据引用）
  accounts:                              # 之后的轮换顺序
    - label: Go #2
      apiKeyEnv: COMMANDCODE_API_KEY_2
    - label: Go #3
      apiKeyEnv: COMMANDCODE_API_KEY_3

配置

设置 → Command Code 可配置 API key、API 地址、工作目录与请求/流超时；配置好 key 后，页面顶部会显示实时「账户用量」卡片。

同一组选项也位于 $DSH_HOME/settings.yaml（修改即刻生效，无需重启）：

llm-commandcode:
  apiKeyEnv: COMMANDCODE_API_KEY   # 凭据引用
  apiBase: https://api.commandcode.ai
  workingDir: /path/to/project     # 可选
  modelsCachePath: ~/.commandcode/models-cache.json
  requestTimeoutMs: 60000          # 默认 60s
  streamIdleTimeoutMs: 300000      # 默认 300s

注意事项与限制

• 图片输入按模型能力限制：仅 Vision 模型接受图片，纯文本模型会直接拒绝。
• 含图片的会话切换到纯文本模型会被 dsh 拒绝——请改选带 Image 标记的模型，或先移除图片。
• 不支持 stop 序列：携带它的请求会报错。
• 推理块不会重放到后续轮次；只有带配对工具结果的工具调用会被重放。
• 模型目录无需 key 即可浏览；对话请求需要 key。

权限与隐私

本插件只在本地与你的 Command Code 账号之间通信：本地仅读写凭据存储与模型缓存文件（兜底读取 ~/.commandcode/auth.json）；网络仅访问 Command Code API。无遥测。

关闭 / 卸载

• 禁用（不删除）：编辑你 profile 的 cordis.patch.yml，注释掉（或移除）llm-commandcode 行，或设置 disabled: true，然后重启。

• 完全卸载：

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

  你在 dsh 凭据库和 ~/.commandcode/auth.json 中的 API key 不会被改动。

开发

npm install
npm run typecheck   # tsc --noEmit
npm run build       # tsdown -> lib/

在 profile 里试用本地构建：

dsh plugin --profile web add /path/to/dsh-commandcode-provider

修改 src/ 后需重新运行 npm run build 并重启应用。

社区与反馈

• GitHub 仓库
• GitHub Releases
• npm 包
• Linux.do 社区

许可证

MIT —— 见 LICENSE。部分内容移植自 pi-commandcode-provider（MIT）。

界面截图

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

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

设置页 —— API 密钥、连接参数、多账户轮换与实时账户用量卡片：