DSH-Desktop 採用插件化架構，dsh-commandcode 插件爲 Command Code 提供商註冊路由，使其模型能在 DSH 中調用。該插件由維護者 wjf1 開發，遵循 MIT 許可證。
核心功能¶
該插件在提供基礎功能的同時，增加了針對 Command Code 生態的適配與增強：
- Provider Route Registration：在
ctx.llm上註冊commandcode路由，使 Command Code 模型在任意對話中可用。 - Models Page Card：在模型設置頁提供專屬卡片，支持 API Key 輸入與快速登錄。
- Live Model Catalog：實時從 Command Code Provider API 獲取模型目錄，並支持本地緩存。
- Credential Configuration：支持通過環境變量、設置頁、CLI 認證文件或內置 OAuth 登錄流配置憑證。
- Streaming Generation：支持 SSE/JSONL 流式生成，包含文本、推理、工具調用及使用事件。
- Stale-While-Revalidate Catalog：提供緩存優先策略，並在後臺刷新；支持 ETag 請求與熔斷機制，防止無效請求。
- Configurable Timeout & Retry：支持配置請求超時（首字節）和流空閒超時，並採用指數退避策略處理臨時故障。
- Multi-Account Rotation：支持配置多個 API Key，在遇到 429 限流或 401 認證失敗時自動切換。
- Plan-Aware Model Filtering：根據賬戶訂閱層級自動過濾不可用的模型。
- Usage & Billing Dashboard：提供按賬戶的使用統計、訂閱計劃信息及進度條展示。
- Image Input Support：支持 Vision 模型接收圖片附件。
- Redesigned Settings Page：採用卡片式佈局，分爲連接、使用與計劃、多賬戶、高級設置。
- Bilingual Interface：界面支持中文/英文切換，跟隨瀏覽器語言設置。
- TypeScript Build：項目基於 TypeScript 構建，包含類型聲明文件。
安裝與啓用¶
安裝前請確保環境滿足要求：DSH-Desktop 版本 >= 0.7.0（兼容 DeepSeek Harness 0.1.2-alpha.1），以及 Node.js >= 20（僅用於開發構建，桌面應用自帶運行時）。
- 安裝插件
在 DSH 個人資料目錄下執行：
npm install dsh-commandcode
- 配置 Profile
編輯package.json，在dsh.profile.bundles數組中添加dsh-commandcode：
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-commandcode"
]
}
}
}
- 重啓
重啓 DSH-Desktop，Command Code 提供商將出現在模型列表中。
配置¶
API Key 配置¶
支持多種方式配置，優先級從高到低：
1. Settings Page：在設置頁粘貼並保存。
2. Environment Variable：設置 COMMANDCODE_API_KEY。
3. CLI Auth File：運行 command-code login 生成 ~/.commandcode/auth.json。
4. Built-in Login：點擊設置頁的 “Login with Browser” 進行 OAuth 授權。
關鍵設置項¶
| 字段 | 類型 | 默認值 | 說明 |
|---|---|---|---|
requestTimeoutMs |
number | 60000 | 等待首字節響應的超時時間 |
streamIdleTimeoutMs |
number | 300000 | 流式傳輸中允許的最大空閒時間 |
filterModelsByPlan |
boolean | true | 是否根據訂閱計劃過濾模型 |
lang |
‘zh’ | ‘en’ | ‘zh’ | 終端命令 /commandcode 的語言 |
多賬戶配置¶
在 cordis.patch.yml 中配置多個賬戶，插件將自動處理輪換：
- insert:
- id: llm-commandcode
name: "dsh-commandcode"
config:
apiKeyEnv: COMMANDCODE_API_KEY
accounts:
- label: "Work"
apiKeyEnv: COMMANDCODE_API_KEY_WORK
- label: "Personal"
apiKeyEnv: COMMANDCODE_API_KEY_PERSONAL
使用¶
- 選擇模型：打開任意對話，點擊模型選擇器，找到 “Command Code” 分組，選擇帶有
(CC)後綴的模型。 - 查看用量：前往
Settings → Command Code → Usage & Plan卡片，或直接在 DSH 終端輸入/commandcode。 - 授權登錄：前往
Settings → Command Code，點擊 “Login with Browser” 完成授權，無需重啓。
注意事項¶
- 插件以當前 DSH 進程的權限運行，請確保從可信源安裝。
- 需要有效的 Command Code 賬戶及 API Key 或訂閱。
- 模型目錄默認使用緩存，重啓可清除內存緩存；如模型未顯示，可點擊 Usage 卡片中的 “Refresh” 刷新。
鏈接¶
- GitHub: https://github.com/wjf1/dsh-commandcode
- 目錄頁: https://www.skillhub.cn/plugins/wjf1/dsh-commandcode
