dsh-commandcode-quota

dsh plugin --profile web add dsh-commandcode-quota

dsh-commandcode-quota

一个面向 DeepSeek Harness（DSH）的 Command Code 余额与额度面板插件。

插件会在 DSH 输入框正下方渲染一行常驻状态栏：

• 5 小时、每周、每月三个额度窗口的实时百分比
• 可用余额
• 点击状态栏展开完整明细：已用 / 上限 / 剩余 / 重置时间、总消耗、Tokens、日均消耗，以及订阅和账户信息
• 三档状态灯：正常 / 余额低 / 已用尽，当前档亮起、其余压暗（依据官方 belowThreshold 与 exceeded 字段），悬停每个灯有解释
• 进度条颜色随用量变化：低用量保持所选冷色，55% 之后逐渐转暖，接近上限转红；条形内部也带一段渐变
• 六种进度配色可选：在齿轮设置里切换，选择会记住
• 超额预警：按本周期日均推算，如果会在重置前用光，月窗口会多一行「按当前日均，约 N 天后用完」
• 首次加载显示骨架屏，数据回来时版面不会跳一下

刻意做成单账号：没有账号切换，API key 也不会进入浏览器。

环境要求

• 带 Web 客户端的 DeepSeek Harness（dsh web 或桌面端）
• Node.js 20 及以上
• 一个 Command Code API key

安装

从 npm 安装（推荐）

dsh plugin add dsh-commandcode-quota

DSH 会把包内自带的 cordis.patch.yml 展开进你的 profile，不需要手工改补丁。

从本地目录安装

dsh plugin add file:/path/to/dsh-commandcode-quota

手动链接（桌面端）

桌面端的 Electron profile 由应用托管，不会走 dsh plugin add 的展开流程，需要自己注册。

先把包链接进共享解析池：

New-Item -ItemType Junction `
  -Path "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-commandcode-quota" `
  -Target "C:\path\to\dsh-commandcode-quota"

再往 ~/.dsh/profiles/<profile>/cordis.patch.yml 里加：

- insert:
    - id: dsh-commandcode-quota
      name: 'dsh-commandcode-quota'
      config:
        apiKeyEnv: COMMANDCODE_API_KEY

链接名必须和包名完全一致，否则宿主端解析不到这个 import。

安装或改动插件后，重载插件树（插件页的「刷新」，或重启客户端）才生效。

配置

配置项 · 默认值 · 说明

apiKeyEnv · COMMANDCODE_API_KEY · 通过 DSH 凭据服务解析的凭据条目名

fallbackEnv · 无 · 可选的备用条目，仅在首选缺失时使用

baseURL · https://api.commandcode.ai · Command Code API 地址

timeoutMs · 30000 · 单次请求超时（毫秒）

凭据写在 ~/.dsh/.credentials.yaml，或在 DSH 设置 → 凭据里添加。不要提交到仓库。

工作原理

包分宿主端和客户端两半：

• 宿主端（src/index.js）通过 DSH 凭据服务解析 key，注册一个只读 HTTP 端点，并发请求 Command Code API 后聚合成一个响应。key 每次请求现读，绝不序列化给客户端。
• 客户端（src/client.js）往输入框的 dock 槽位注册状态栏，轮询宿主端点，并全部使用 DSH 主题 token 渲染，自动适配深色/浅色主题。

轮询是分层的：余额 3 分钟一次（轻量），用量与订阅 30 分钟一次（重查询）；页面不可见时暂停，切回前台立即补一次完整查询。

数据来自四个 Command Code 接口，均带 Authorization: Bearer <key>：

接口 · 用途

GET /alpha/billing/credits · 余额，以及 5 小时 / 每周限额

GET /alpha/usage/summary · 消耗、Tokens、周期起始时间（用于日均消耗）

GET /alpha/billing/subscriptions · 订阅状态与周期起止

GET /alpha/whoami · 账户信息

每月窗口是合成值：已用取用量汇总，总额为已用加剩余额度，重置时间取订阅周期末。

失败时的行为

• 四个请求并发发出，总耗时等于最慢的一个，而不是四者之和。
• 连接级失败重试一次；主动超时不重试。
• 请求失败时回退到上次成功的值（保留 6 小时），并标记为陈旧数据。
• 这份快照同时落盘到 $DSH_HOME/dsh-commandcode-quota-cache.json，重启后依然可用；只保存额度相关字段，不含账户信息，也不含 key 本身。
• 快照按 API key 的指纹隔离：换 key 之后不会把上一个账号的数据当成兜底值。
• HTTP 401 不会被缓存掩盖——它意味着凭据本身有问题，必须让用户看到。
• 四个接口全部失败时，响应会带出可读的失败原因，面板显示错误而不是一块空白。

开发

npm test                        # 宿主端与客户端单元测试；不联网、不依赖运行中的 DSH
node --check src/index.js       # 宿主端语法检查
node --check src/client.js      # 客户端语法检查

测试对凭据服务、Web 服务器、fetch 和 React 都使用了替身，因此可离线运行，也不会碰到真实的 DSH 实例。

License

MIT