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
