前言¶

在 DeepSeek Harness（DSH）里接入外部 LLM 路线时，需要先确认文本输出、流式输出、工具调用、凭据配置和错误处理是否可用。dsh-plugin-commandcode-provider 为 DSH 添加 commandcode LLM provider 路线，让模型以 commandcode/<model-id> 的形式被选择。

这是什么¶

• 定位：为 DSH 添加 commandcode LLM provider 路线。
• 仓库路径：mitian233/dsh-plugin-commandcode-provider。
• 许可证：MIT。
• 兼容版本：DSH 0.1.0-rc.6 及以后版本（npm next tag）。
• 来源说明：浏览器辅助 OAuth 流程移植自 MIT 许可证的 pi-commandcode-provider。

核心能力¶

下面介绍已核实的能力：

• 支持文本消息和流式文本输出。
• 支持标准 JSON Schema 工具和完整工具调用。
• 在模型声明支持的推理力度下，支持 reasoning deltas。
• 支持用量报告、取消、空闲超时处理以及确定性 HTTP/流内错误分类。
• 在 Web 设置页提供 Command Code OAuth 按钮，用于浏览器辅助获取并存储 API key。
• 支持通过 DSH profile 配置覆盖 baseURL、maxTokens、defaultContextWindow、streamIdleTimeoutMs 等。

安装与启用¶

先运行 Web 形态的 DSH：

npx @deepseek-ai/dsh web

如果 dsh 已在 PATH 中，也可以使用 dsh web。

从本地目录安装到 web profile：

cd /path/to/dsh-plugin-commandcode-provider
npx @deepseek-ai/dsh plugin --profile web add .

从 GitHub 安装：

dsh plugin --profile web add github:mitian233/dsh-plugin-commandcode-provider

移除插件及其 bundle 层：

dsh plugin --profile web remove dsh-plugin-commandcode-provider

验证时，先查看插件 layer，再启动 Web UI：

dsh --profile web --dump-config
dsh web

典型用法¶

在 profile 配置中加入名为 llm-commandcode 的插件条目：

- id: llm-commandcode
  config:
    apiKeyEnv: COMMANDCODE_API_KEY
    baseURL: https://api.commandcode.ai
    maxTokens: 64000

选择模型时使用 commandcode/<model-id>，例如：

commandcode/gpt-5.6-luna

API key 通过 DSH credentials service 配置。如果挂载了 credentials service，它是权威来源；未命中不会回退到启动环境。空白、仅空白或 HTTP-header-invalid 的 key 会在发送请求前被拒绝。

Web 设置页中的 Command Code OAuth 按钮可以启动浏览器辅助流程，用于获取并存储 API key。该流程需要 DSH Web 服务器（Web profiles）。如果自动传输失败或超时，可回退到按钮下方的手动 API-key 输入。

配置项¶

• apiKeyEnv：用于选择 DSH credential reference，示例为 COMMANDCODE_API_KEY。
• baseURL：用于修改 API origin。
• maxTokens：上限为 64000。
• defaultContextWindow、streamIdleTimeoutMs：用于覆盖模型上下文窗口和流式空闲超时等行为。
• temperature：作为兼容配置接受；显式请求优先，wire 默认值为 0.3。
• 静态 models 条目：可提供显示、context-window 和最大 token 覆盖；它不用于发现模型。

适用场景与注意¶

这个插件适合需要在 DSH 中使用 commandcode provider 路线、并希望通过 Web 设置页管理 API key 的场景。

v1 非目标如下：

• 不刷新凭证。
• 不做动态模型发现或目录缓存。
• 不支持图像输入和 stop sequences。
• 图像和 stop 请求会在网络分发前失败。

插件会以当前 dsh 进程权限运行，并处理 API key 相关配置。安装前应检查源码与许可证。

链接¶

• 目录页：https://www.skillhub.cn/plugins/mitian233/dsh-plugin-commandcode-provider
• GitHub：https://github.com/mitian233/dsh-plugin-commandcode-provider