wjf1/dsh-commandcode

dsh-commandcode

面向 Command Code 的增强版 DSH-Desktop LLM 提供商插件。在完整对标 dsh-commandcode-provider 核心能力的基础上，提供更健壮的模型目录同步、可配置的超时与重试、多凭证环境支持，以及适配 DSH-Desktop 0.7.x（DeepSeek Harness 0.1.2-alpha.1）的精致界面。

CI
License: MIT
Node

核心能力（功能对齐）
- 提供商路由注册 — 在 ctx.llm 上注册 commandcode 提供商路由，使 Command Code 模型可在任意对话中选择
- Models 页面卡片 — 在模型设置页面提供专属提供商卡片，包含 API Key 输入和快捷登录
- 实时模型目录 — 从 Command Code Provider API（/provider/v1/models）实时拉取模型列表，支持本地磁盘缓存
- 凭证配置 — 支持环境变量（COMMANDCODE_API_KEY）、设置页面、CLI 认证文件（~/.commandcode/auth.json）及内置 OAuth 登录流程
- 流式生成 — 完整的 SSE/JSONL 流式输出，支持文本、推理、工具调用和用量事件

功能增强
- SWR 模型目录 — 即时返回缓存模型，后台静默刷新；ETag 条件请求；熔断器避免持续请求故障端点
- 可配置超时与重试 — 请求超时（首字节）和流式空闲超时均可在设置中调整；瞬时故障采用指数退避+抖动重试
- 多账户自动轮换 — 配置多个 API Key；遇到 429 限流或 401 凭证失效时自动切换到下一个可用账户；主动探测窗口以恢复冷却账户
- 结构化错误诊断 — 每个错误都携带稳定错误码、诊断上下文（状态码、模型、账户、请求 ID）和面向用户的排查提示
- 按套餐过滤模型 — 自动隐藏超出当前订阅套餐的模型（故障时开放：未知套餐或有按需额度时显示全部模型）
- 用量与套餐面板 — 逐账户用量统计、5小时/每周窗口限制进度条、订阅套餐信息和额度余额
- 图片输入支持 — 支持视觉能力的模型可通过持久化附件服务接收图片输入

界面优化
- 重新设计的设置页面 — 清晰的卡片式布局：连接配置、用量与套餐、多账户管理、高级设置
- 实时表单校验 — API 地址格式错误、超时非正数等即时内联错误提示
- 中英双语界面 — 完整的中/英文本地化，跟随浏览器语言
- DSH-Desktop 0.7.1 设计规范 — 对齐设计令牌（--dsw-alias-）、圆角、平滑过渡、焦点环
- 逐账户用量标签页 — 在账户间切换查看各自的用量和套餐状态

版本适配
- 兼容 DeepSeek Harness 0.1.2-alpha.1 — 面向 DSH Desktop 0.7.x：使用 @deepseek-ai/dsh-client-store（接替已删除的 dsh-client-runtime）、响应式 SettingsScope 快照契约、credentials Remote 命名空间，用量/登录后端走共享 /api 精确 Fetch 路由
- 一键安装 — 添加到 profile 的 dsh.profile.bundles 后重启即可，无需手动构建
- TypeScript 构建 — 通过 tsdown 可复现构建，输出 ESM 格式和类型声明

安装

前置要求
- DSH-Desktop >= 0.7.0（DeepSeek Harness 0.1.2-alpha.1）
- Node.js >= 20（仅开发/构建需要；桌面应用自带运行时）
- 一个 Command Code 账户和 API Key 或订阅

快速安装（Profile Bundle）

在 DSH profile 的 package.json 中添加插件：

在 profile 目录下（如 ~/.dsh/profiles/desktop/）
npm install dsh-commandcode

然后在 package.json 的 dsh.profile.bundles 中添加：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-commandcode"
]
}
}
}

重启 DSH-Desktop。Command Code 提供商会出现在 Models 页面。

从源码手动构建

git clone https://github.com/wjf1/dsh-commandcode.git
cd dsh-commandcode
npm install
npm run build
输出在 ./lib 目录

配置

API Key

三种配置方式，按优先级排列：

1. 设置页面 — 进入 设置 → Command Code，粘贴 API Key，点击保存
2. 环境变量 — 在启动 DSH 的 shell 中导出 COMMANDCODE_API_KEY
3. CLI 认证文件 — 运行 command-code login 生成 ~/.commandcode/auth.json
4. 内置登录 — 在设置页面点击"使用浏览器登录"进行 OAuth 授权

设置项参考

| 字段 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| apiKeyEnv | string | COMMANDCODE_API_KEY | API Key 的环境变量名 |
| apiBase | string | https://api.commandcode.ai | Command Code Provider API 基础地址 |
| workingDir | string | process.cwd() | 上报给 API 的工作目录 |
| modelsCachePath | string | ~/.commandcode/models-cache.json | 模型目录缓存文件路径 |
| requestTimeoutMs | number | 60000 | 等待响应首字节的超时时间（毫秒） |
| streamIdleTimeoutMs | number | 300000 | 流式传输中允许的最大停顿时间（毫秒） |
| filterModelsByPlan | boolean | true | 隐藏当前套餐不可用的模型 |
| accounts | array | [] | 用于多账户轮换的额外账户 |
| activeAccount | string | — | 手动选择的活跃账户槽位 ID |
| lang | 'zh' \| 'en' | 'zh' | /commandcode 终端命令的语言 |

多账户配置

cordis.patch.yml
- insert:
- id: llm-commandcode
name: "dsh-commandcode"
config:
apiKeyEnv: COMMANDCODE_API_KEY
accounts:
- label: "工作号"
apiKeyEnv: COMMANDCODE_API_KEY_WORK
- label: "个人号"
apiKeyEnv: COMMANDCODE_API_KEY_PERSONAL

当请求遇到 429（限流）或 401（凭证无效）时，插件会自动切换到下一个可用账户。

使用方法

选择模型

1. 在 DSH-Desktop 中打开任意对话
2. 点击模型选择器
3. 找到 "Command Code" 分组
4. 选择任意可用模型（带有 (CC) 后缀标记）

查看用量

- 设置页面 — 进入 设置 → Command Code → 用量与套餐卡片
- 终端命令 — 在 DSH 终端中输入 /commandcode 查看逐账户用量、套餐和额度限制

登录流程

1. 进入 设置 → Command Code
2. 点击"使用浏览器登录"
3. 在打开的浏览器标签页中完成授权
4. API Key 自动保存，无需重启

常见问题

"No API key" 错误

请确保至少满足以下一项：
- 环境中设置了 COMMANDCODE_API_KEY
- 在 设置 → Command Code 中保存了 API Key
- 已运行 command-code login（生成 ~/.commandcode/auth.json）

"429 Rate Limit" 限流

- 5小时用量窗口已耗尽
- 等待窗口重置（用量卡片中显示重置时间）
- 添加更多账户以实现自动轮换
- 升级 Command Code 订阅套餐

"401 Invalid Credential" 凭证无效

- API Key 已过期或被撤销
- 重新运行登录流程或粘贴新的 Key
- 检查环境变量中是否包含正确的 Key

模型选择器中不显示模型

- 在用量卡片中点击"刷新"触发目录更新
- 检查到 api.commandcode.ai 的网络连接
- 离线时仍会提供缓存的目录；重启会清除内存缓存

流式传输停顿/断开

- 在高级设置中增大 streamIdleTimeoutMs
- 检查网络稳定性
- 模型响应较慢时，长生成可能超过空闲超时

开发指南

项目结构

dsh-commandcode/
├── src/
│   ├── index.ts            # 插件入口：提供商注册、设置、组件装配
│   ├── adapter.ts          # LLM 适配器：流式生成、模型目录、用量端点
│   ├── catalog.ts          # 模型目录：SWR、缓存、熔断器
│   ├── accounts.ts         # 多账户池：轮换、窗口探测
│   ├── login.ts            # OAuth 登录流程：回环回调服务器
│   ├── login-wire.ts       # 登录线路协议类型
│   ├── commands.ts         # /commandcode 终端命令
│   ├── command-locales.ts  # 命令国际化（中/英）
│   ├── usage-remote.ts     # 用量 Typert Gateway 端点
│   ├── usage-wire.ts       # 用量线路协议类型
│   ├── errors.ts           # 结构化错误诊断
│   ├── retry.ts            # 重试策略、熔断器、退避
│   └── client/
│       ├── index.ts        # 客户端入口：CSS、Slot、控制器
│       ├── section.tsx     # 设置页面 React 组件
│       ├── card.tsx        # Models 页面提供商卡片
│       ├── settings.ts     # 设置控制器（状态、校验、持久化）
│       ├── login.ts        # 登录控制器（轮询）
│       ├── usage.ts        # 用量控制器（获取、标签页）
│       ├── locales.ts      # 客户端国际化（中/英）
│       ├── sessions.ts     # 友好的图片会话错误包装
│       ├── update.ts       # 更新检查
│       └── version.ts      # 版本常量
├── tests/                  # Node 测试运行器测试套件
├── assets/                 # 图标和截图
├── cordis.patch.yml        # Bundle 层定义
├── package.json
├── tsconfig.json
├── tsdown.config.ts
└── README.md / README.zh-CN.md / CHANGELOG.md / LICENSE

构建命令

npm install          # 安装依赖
npm run typecheck    # TypeScript 类型检查
npm test             # 运行测试套件
npm run build        # 构建 ESM 输出 + 类型声明到 ./lib

架构说明

- Host/Client 分离：src/index.ts 运行在 Node.js 宿主进程中；src/client/index.ts 运行在浏览器中。package.json 中的 dsh.client.inject 字段声明客户端 bundle 的依赖。
- 逐请求解析：所有连接参数（API Key、端点、超时）都通过 thunk 在每次请求时 fresh 解析，因此设置变更无需重启即可生效。
- 线路协议：Command Code Provider API 使用自定义 SSE/JSONL 格式（/alpha/generate）。适配器解析 text-delta、reasoning-、tool-call、finish 和 error 事件。

致谢

- Mars-Sea/dsh-commandcode-provider — 本项目增强的原始社区插件。MIT 许可证。
- Command Code 团队提供 Provider API 和 CLI。
- DeepSeek Harness 团队提供插件架构和 LLM 适配器框架。

许可证

MIT © 2026 dsh-commandcode 贡献者