前言¶
DSH 的插件体系允许把外部模型服务接入 harness。对 Command Code 用户来说,有一个具体限制:Go / GOAT / Pro Plan 场景中,Provider API 端点会返回 403 upgrade_required,模型调用需要走 /alpha/generate。
jiesou/dsh-commandcode-go-provider 解决的是这个问题。下面介绍它的定位、安装方式、配置项和注意事项。
这是什么¶
这是一个由 jiesou 维护、采用 MIT 许可证的 DSH 插件,定位是 Command Code Go API provider for dsh。
它面向 Command Code Go / GOAT / Pro Plan 场景,通过 /alpha/generate 流式接入 DSH 的原生 LlmAdapter,让 Go / GOAT / Pro Plan 用户可以直接在 DSH 中使用订阅模型。
核心功能¶
流式接入 Command Code 网关¶
插件通过 /alpha/generate 流式接入 DSH 的原生 LlmAdapter。它适用于 Provider API 端点返回 403 upgrade_required 的 Go / GOAT / Pro Plan 场景。
动态模型目录¶
模型列表不写死在代码里。插件启动时会从 /provider/v1/models 拉取实时模型目录,并按官方 CLI catalog 的 Min plan 列筛选,只保留 Go and above 的模型。
计划顺序为 Go < GOAT < Pro < Max。挂载时如果上游不可达,目录暂时为空,不会拖垮插件。
Reasoning Effort¶
Reasoning Effort 档位来自官方 CLI catalog,插件会动态合并这些档位。
Default 表示不发送 reasoning_effort 字段。Off 与 Default 的 wire 形态一致,但显式声明不推理的意图。
安装与启用¶
从 npm 安装¶
下面命令从 npm 安装插件:
dsh plugin --profile web add @jiesou/dsh-commandcode-go-provider
从 GitHub 安装¶
也可以从 GitHub 安装:
dsh plugin --profile web add github:jiesou/dsh-commandcode-go-provider
配置 API Key¶
API Key 通过 COMMANDCODE_API_KEY 环境变量名或 credential ref 读取。可以将 Key 写入 ~/.dsh/.credentials.yaml:
echo 'COMMANDCODE_API_KEY: [your key, be like user_xxxx]' >> ~/.dsh/.credentials.yaml
模型列表无需额外配置。安装完成后,在 Web 的 Models 页面选择 Command Code Go provider 及模型,即可开始对话。
可选配置¶
以下配置项全部可选,默认即可用:
- id: commandcode-go-provider
name: '@jiesou/dsh-commandcode-go-provider'
config:
apiKeyEnv: COMMANDCODE_API_KEY
baseURL: https://api.commandcode.ai
maxTokens: 64000
defaultContextWindow: 1000000
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
apiKeyEnv |
string |
COMMANDCODE_API_KEY |
读取 API Key 的环境变量名或 credential ref |
baseURL |
string |
https://api.commandcode.ai |
Command Code 网关 base URL,/alpha/generate 会自动追加 |
maxTokens |
number |
64000 |
单次请求输出 token 上限 |
defaultContextWindow |
number |
1000000 |
模型无精确 contextWindow 时的兜底值 |
适用场景与注意¶
适合以下情况:
- Command Code 账号属于 Go / GOAT / Pro Plan,且 Provider API 端点返回
403 upgrade_required。 - 希望在 DSH 中通过插件接入
/alpha/generate,而不是把模型列表写死在代码里。 - 需要从 npm 或 GitHub 安装,并按需调整
apiKeyEnv、baseURL、maxTokens、defaultContextWindow。
使用前注意:
- 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
- 本插件许可证为 MIT。
- 模型目录依赖
/provider/v1/models和官方 CLI catalog;上游不可达时,目录可能暂时为空。
结尾¶
jiesou/dsh-commandcode-go-provider 的价值,是把 Command Code Go / GOAT / Pro Plan 的 /alpha/generate 网关接进 DSH 的 LlmAdapter,同时保持模型目录和 Reasoning Effort 档位可动态获取。