用量圆环 gaigaichao/dsh-commandcode-usage

dsh-commandcode-usage

DeepSeek Harness Web 客户端插件：在输入框内（发送键左侧）显示一个 Command Code（GOAT 订阅）用量圆环，点击弹出 5 小时 / 周 / 月额度的明细面板。

核心差异化：圆环跟随当前选择的 provider 自动切换——选 commandcode 模型时显示 Command Code 用量，选 opencode-go 时自动切换为 OpenCode Go 用量，选其他 provider 时自动隐藏。

- 圆环显示 5 小时滚动窗口剩余额度，并按档位变色
- 鼠标悬浮圆环即时显示「剩余 5 小时用量」气泡提示（无需点击）
- 点击圆环弹出面板，以卡片展示三档额度：剩余百分比 + 进度条 + 重置时间
- 面板显示当前用量 API Key 的来源（DSH 凭据库 / 环境变量）与脱敏尾号（如 user_VCJV），便于排障且不泄露明文
- 跟随 provider 自动切换：commandcode → Command Code 用量；opencode-go → OpenCode Go 用量（内置移植）；其他 → 隐藏
- 数据来自 Command Code / OpenCode 官方用量 API，每 60s 自动刷新

效果

输入框工具行（发送键左侧）会出现一个与原生「上下文已用」同款的用量圆环。鼠标悬停在圆环上时，上方即时浮现气泡提示「剩余 5 小时用量 X%」，点击圆环则弹出明细面板：

┌──────────────┐
│ 剩余5h用量88% │ ← 悬浮提示（mouseover 气泡） └──────────────┘ ▲ (◔)←→❲○❳ │ ← 用量圆环（档位变色，随 provider 切换） ┌──────────────────────────┐ │ Command Code 额度 │ │ Key 来源：DSH凭据库 │ │ · user_VCJV │ ← 来源 + 脱敏尾号 │ ┌──────────────────────┐ │ │ │ 5小时额度 剩余 88% │ │ ← 名称 + 剩余同一行 │ │ ██████████████ │ │ ← 进度条（宽=剩余%，随档位变色） │ │ 已用$1.73/$14 重置16:26│ │ ← 已用/cap + 重置时间 │ └──────────────────────┘ │ │ ┌──────────────────────┐ │ │ │ 周额度 剩余 95% │ │ │ │ ████████████ │ │ │ │ 已用$1.73/$35 重置8/27│ │ │ └──────────────────────┘ │ │ ┌──────────────────────┐ │ │ │ 月额度 剩余 $68/$70 │ │ │ │ ████████████ │ │ │ │ 已用 2% 下月账单日重置 │ │ │ └──────────────────────┘ │ │ 账号：gaigaichao │ └──────────────────────────┘

档位变色（进度条与百分比数值同步）：
| 剩余额度 | 颜色 |
| ≥ 60% | 🟢 绿 |
| 30% ~ 60% | 🟡 黄 |
| < 30% | 🔴 红 |

provider 自动切换：
| 当前 provider | 显示 |
| commandcode | Command Code（GOAT）用量环 |
| opencode-go | OpenCode Go 用量环（内置移植） |
| 其他（如 deepseek） | 隐藏 |

安装

前置条件

- DeepSeek Harness 已安装（dsh 命令可用，已运行过 dsh web）
- 有 Command Code 订阅（GOAT）的 API Key

方式一：直接从 GitHub 安装（推荐）

装到 web profile（pnpm 会克隆并安装依赖）
dsh plugin --profile web add github:gaigaichao/dsh-commandcode-usage

重启 DSH Web 服务（停止当前 dsh web 进程后重新运行），刷新页面

方式二：本地开发（link 方式）

git clone https://github.com/gaigaichao/dsh-commandcode-usage.git
cd dsh-commandcode-usage
pnpm install # 安装依赖
link 到 web profile，便于改代码后即时定位
dsh plugin --profile web add link:<项目绝对路径>
重启 DSH Web 服务后刷新页面

从 GitHub 源安装后如要更新版本：先 git push 到仓库，再
dsh plugin --profile web update dsh-commandcode-usage + 重启。

安装后 DSH 会自动把 dsh-commandcode-usage 加入 dsh.profile.bundles 并应用插件的 cordis.patch.yml 挂载层，无需手动改配置。

注意：本插件内置了 OpenCode Go 用量组件（方式 A 聚合）。若你同时装有原 dsh-opencode-usage 插件，请先移除它，避免 host 端 opencodeUsage service 重复注册与输入框双环并存：
dsh plugin --profile web rm dsh-opencode-usage

配置 API Key

Command Code 用量 API 的 key 解析优先级：

1. DSH 凭据库（推荐）：在 DSH 的 设置 ⚙️ → 模型（Models） 页，找到 commandcode 一行填入 API Key，或直接编辑： ~/.dsh/.credentials.yaml COMMANDCODE_API_KEY: cc-xxxx...

2. 进程环境变量 COMMANDCODE_API_KEY

OpenCode Go（opencode-go provider 下）的 key 解析优先级：

1. DSH 凭据库：OPENCODE_GO_API_KEY
2. 进程环境变量 OPENCODE_GO_API_KEY
3. opencode 本地登录 ~/.local/share/opencode/auth.json 的 opencode-go 条目

改 key 后最多约 60s 生效：Host 端有 60s 用量缓存，之后会用新 key 自动重新拉取。

数据接口：GET https://api.commandcode.ai/alpha/billing/credits（Bearer 认证），返回 5 小时 / 周窗口的已用+上限+重置时间与月度剩余额度；账号名来自 GET /alpha/whoami。

卸载

dsh plugin --profile web rm dsh-commandcode-usage
重启 DSH Web 服务后刷新页面

项目结构

dsh-commandcode-usage/
├── lib/
│ ├── index.js # Host 半：解析 key → 调用量 API → 60s 缓存，暴露 commandcodeUsage + opencodeUsage 两个 Typert Remote 服务 │ └── client.js # Client 半：输入框圆环 + 悬浮提示 + 明细面板 + provider 感知切换（React，ModuleLoader 模块） ├── cordis.patch.yml # bundle 挂载层 ├── package.json # 插件清单（dsh.client / dsh.bundle 声明） ├── pnpm-workspace.yaml # 依赖安全策略：豁免 @deepseek-ai 私有 pre-release 包的 supply-chain 校验 ├── pnpm-lock.yaml └── README.md

工作原理

采用 DSH 双面插件架构（同 dsh-opencode-usage / dsh-skill-viewer 模式）：

浏览器 (Client) DSH 服务进程 (Host)
conversation.input.right 槽位 CommandCodeUsageGateway (TypertRemoteService) provider 感知圆环 + 卡片面板 ◄──RPC getUsage()── · ctx.credentials 读 key modelDirectories 订阅 provider · GET api.commandcode.ai/alpha/billing/credits 60s 轮询 · 60s 内存缓存

- 位置：conversation.input.right（发送键左侧，与原生「上下文已用」圆环并排）
- Provider 感知：Client 注入 modelDirectories 服务，订阅当前会话选择的 provider/model，切换即时生效
- 数据：Host 端读 key 并请求 usage API，避免 key 暴露进浏览器、规避 CORS
- 刷新：60s 轮询更新（面板沿用最近一次拉取的数据）
- 交互：悬浮圆环显示「剩余 5 小时用量」气泡，点击弹出三档额度明细面板

致谢与参考

本项目衍生自 O7starv1/dsh-opencode-usage（MIT License）：

- 整体插件结构（双面架构、Typert Remote service、conversation.input.right 槽位、圆环/面板样式）直接参考其实现
- OpenCode Go 用量组件（opencodeUsage service + OpenCodeGoRing）为从其移植
- 核心差异化（provider 感知切换、Command Code GOAT 用量）为本项目新增

许可

MIT