前言¶
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 檔位可動態獲取。