前言¶

在 DeepSeek Harness（DSH）里做智能体开发，模型来源通常通过 provider 插件接入。若你已有 Command Code 账号或订阅，希望直接在 DSH 的模型选择器里使用其在线模型目录，而不是单独维护一套 API 封装，就需要一个官方的 provider 路由。

dsh-commandcode-provider 由社区维护者 Mars-Sea 开发，将 Command Code 注册为 DSH 的 commandcode provider，并提供设置页、用量卡片与模型选择器标注。项目从 pi-commandcode-provider（MIT）移植而来，当前在 GitHub 上约 87 stars、5 forks，npm 包版本为 0.8.1，许可证 MIT。

这是什么¶

@mars-sea/dsh-commandcode-provider 是一个非官方的 DeepSeek Harness LLM provider 插件，面向 Command Code 平台。安装后通过 dsh plugin add 写入 profile，注册 commandcode 路由，并在 Settings → Models 页面显示 Command Code 卡片。

插件只在你本地的 DSH profile 与 Command Code 账号之间通信：本地读写凭证存储与模型缓存，网络上仅调用 Command Code API，不发送遥测数据。你需要自备 Command Code 账号与 API key 或订阅，并遵守 Command Code 的服务条款；本项目与 Command Code, Inc. 无隶属关系。

核心功能¶

下面介绍插件在 README 中列出的主要能力。

Provider 与模型目录¶

• 安装后注册 commandcode provider 路由，模型目录从 Command Code API 实时拉取。
• 模型选择器会标注最低套餐、活动优惠或 FREE 徽章、峰谷时段状态、是否支持图片输入、上下文窗口；免费模型默认排在前面。
• 支持 reasoning-effort：对可选推理强度的模型，在选择器中暴露对应档位。
• 套餐感知：高于当前订阅档位的模型默认隐藏，可在设置中通过「Hide out-of-plan models」开关调整。

设置页与凭证¶

Settings → Command Code 提供：

• API key 配置与连接选项；
• 实时 Account usage 用量卡片；
• 浏览器内登录：点击 Sign in to Command Code 启动与 cmd login 相同的官方授权流程，批准后 key 自动写入本地凭证服务；也可手动粘贴 key 或通过环境变量 COMMANDCODE_API_KEY 设置。

远程 Host 场景下，浏览器登录需要 Host 与浏览器在同一台机器（loopback 回调）；远程部署时请手动粘贴 key。若 composition 层设置了字面量 apiKey，其优先级高于已登录凭证。

多账号轮换¶

配置多个 Command Code 订阅后，当一个账号触达用量上限，请求会自动切换到下一个账号：

• 在 Settings → Command Code 的 Account rotation 卡片中添加带标签的账号；顶层 key 始终作为 default 账号优先使用。
• Active account 下拉可固定首选账号；若该账号耗尽，会回退到其他账号，并在窗口重置后恢复。
• /commandcode 命令与 Account usage 卡片可查看各账号状态。

图片输入¶

支持 Vision 模型的图片输入；纯文本模型会拒绝带图请求。若在含图片的会话中切换到纯文本模型，DSH 会拒绝该操作，需选择标注 Image 的模型或先移除图片。

其他说明¶

• 模型目录可在无 key 时浏览；实际对话请求需要 API key。
• 不支持 stop sequences，携带 stop 的请求会失败。
• reasoning 块不会在后续轮次重放；仅带配对 tool result 的 tool call 会重放。

安装与启用¶

在 web profile 中安装最新版：

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

更新插件：

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

安装或更新后需重启 web 应用。

卸载：

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

卸载不会删除 dsh 凭证存储或 ~/.commandcode/auth.json 中的 key。

典型用法¶

获取 API key¶

推荐通过官方 CLI（需 Node.js 22+）：

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

也可在 DSH 设置页点击 Sign in to Command Code，或在 Keys settings page 创建 key 后粘贴，或执行：

export COMMANDCODE_API_KEY="user_..."

验证安装¶

重启后，在 Settings → Command Code 填入 API key 并保存。Settings → Models 应出现 Command Code 卡片，模型选择器在 commandcode 下列出实时目录。用你套餐内的模型发送一条消息即可验证。

查看用量¶

插件注册 /commandcode 斜杠命令：

/commandcode        # 或 /commandcode status

配置文件¶

等效配置可写入 $DSH_HOME/settings.yaml（修改后立即生效，无需重启）：

llm-commandcode:
  apiKeyEnv: COMMANDCODE_API_KEY   # credential reference
  apiBase: https://api.commandcode.ai
  workingDir: /path/to/project     # optional
  modelsCachePath: ~/.commandcode/models-cache.json
  requestTimeoutMs: 60000          # default 60s
  streamIdleTimeoutMs: 300000      # default 300s

多账号轮换的 YAML 示例：

llm-commandcode:
  apiKeyEnv: COMMANDCODE_API_KEY        # first (default) account
  activeAccount: COMMANDCODE_API_KEY_2   # optional: pin the active account
  accounts:
    - label: Go #2
      apiKeyEnv: COMMANDCODE_API_KEY_2
    - label: Go #3
      apiKeyEnv: COMMANDCODE_API_KEY_3

禁用而不卸载¶

编辑 profile 的 cordis.patch.yml，注释或删除 llm-commandcode 行，或设置 disabled: true，然后重启。

适用场景与注意¶

适合谁：

• 已有 Command Code 账号或订阅，希望在 DSH web profile 中直接使用其模型目录与推理强度选项；
• 需要多账号自动轮换以应对单账号用量上限；
• 希望在 DSH 设置页内完成授权、查看用量，而不是单独维护 API 客户端。

安装前注意：

• 插件以当前 dsh 进程的权限运行，安装前应检查 GitHub 源码 与 MIT 许可证。
• 这是社区集成，非 Command Code 或 DeepSeek 官方出品；DSH 生态遵循「一切皆插件」理念，SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
• 开发环境要求 Node.js >= 22（见 package.json engines 字段）。

链接¶

• SkillHub 目录页：https://www.skillhub.cn/plugins/Mars-Sea/dsh-commandcode-provider
• GitHub 仓库：https://github.com/Mars-Sea/dsh-commandcode-provider
• npm 包：https://www.npmjs.com/package/@mars-sea/dsh-commandcode-provider

若你已在 Command Code 侧完成订阅配置，经过上面的安装与 key 设置步骤，即可在 DSH 模型选择器中按套餐选用 Command Code 的在线模型目录。