前言¶

DeepSeek Harness（DSH）提供插件化架构，可以把外部服务的数据接入到设置页里。Command Code 的官方用量卡在网页端，但想在 DSH 里直接查看 5 小时窗口、每周额度、每月剩余与重置倒计时，目前没有现成功能。yal3ay/commandcode-usage-dsh 把官方用量卡搬进了 DSH 的「設定」对话框。

这是什么¶

yal3ay/commandcode-usage-dsh 是一个 DSH 客户端插件，在 DSH 的设置页中展示 Command Code 方案的使用量。Host 端每 30 秒轮询一次官方计费接口，浏览器端通过 settings.section 插槽渲染为一个设置页，包含 5 小时窗口、每周窗口、每月额度、重置倒计时与方案信息。插件以 MIT 许可证开源，由社区维护。

核心功能¶

• 5 小时窗口：显示已用金额/上限、已用百分比、重置倒计时与进度条
• 每周窗口：同上，按 7 天滚动窗口统计
• 每月额度：显示本期已用/方案额度、剩余额度、加购与赠送额度、计费周期结束日
• 方案与账号：显示 whoami 的显示名、email、方案名称（Go / GOAT / Pro / Max / Team Pro）
• 云端沙盒：方案含沙盒分钟数时一并显示用量
• 自动更新：Host 每 30 秒轮询；倒计时另外每 30 秒刷新
• 手动刷新：点击卡片右上角「刷新」，先叫 Host 立即重读再取快照
• 主题相容：使用行内样式与中性色，深/浅色主题均可读
• 凭证安全：API key 在 Host 端通过 ctx.credentials 解析，仅百分比/金额/重置时间通过 Remote 传输

安装与启用¶

前置条件：

• DeepSeek Harness 0.2.0-rc.2（Desktop 或 Web profile）
• 已配置 Command Code 凭证，二选一：
• DSH 凭证里有 COMMANDCODE_API_KEY
• profile 的 llm-pi-ai.providers 有 commandcode provider，使用其 apiKeyEnv 与 baseURL 来源
• 能访问 https://api.commandcode.ai

从 GitHub 直接安装（推荐）：

dsh plugin --profile <profile> add github:yal3ay/commandcode-usage-dsh

使用 DSH 外挂页安装，或安装本地目录：

dsh plugin --profile desktop add /絕對路徑/commandcode-usage-dsh

安装后重启该 profile（若未开启 HMR），重新载入页面，打开 設定 → Command Code 用量。

若不想改 bundle 清单，也可以在 ~/.dsh/profiles/desktop/cordis.patch.yml 里添加：

- insert:
    - id: commandcode-usage-dsh
      name: 'commandcode-usage-dsh'

典型用法¶

安装完成后，在 DSH 设置页中即可看到「Command Code 用量」设置项。页面会自动展示当前方案的使用情况，包括各窗口的进度条与倒计时。点击右上角「刷新」可以立即触发一次重读。倒计时与进度条会按设定的颜色区间显示（≤60% 绿色，61–85% 琥珀，>85% 红色）。

适用场景与注意¶

• 适合需要频繁查看 Command Code 用量与重置时间的 DSH 用户
• 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证
• 需要连接到 https://api.commandcode.ai
• 已知限制：使用官方 CLI 专用的 /alpha/* 路由，若 Command Code 更改路径会显示错误而不退回假数据；仅提供金额与百分比，不提供逐模型明细；目前一次只读取一把 key / 一个账号

结尾¶

yal3ay/commandcode-usage-dsh 把 Command Code 的用量卡集成到 DSH 设置页，让 5 小时窗口、每周额度、每月剩余与重置倒计时一目了然。安装命令见上方，更多细节与源码可访问 GitHub 仓库。