dsh-opencode-go-usage

简体中文 · English

一个 DeepSeek Harness 的 WebUI 插件：在页面右侧提供常驻悬浮组件，实时展示 OpenCode Go 套餐中 key 池内每个 key 的用量——滚动 / 每周 / 每月三个窗口的已用百分比、进度条与重置倒计时。

特性

• 悬浮组件：紧凑按钮固定在页面右侧边缘，角标实时显示全部 key 中最差窗口的百分比；颜色分级（绿 / 橙 / 红色脉冲）让你一眼看出是否有 key 接近额度上限。
• 展开面板：点击按钮展开面板，每个 key 一张卡（当前生效 key 带 ★ 标记），展示滚动 / 每周 / 每月用量（进度条 + 百分比 + 距重置时间）；被限流的窗口标 ⚠。
• 实时刷新：Host 每 60 秒轮询官方用量端点（可配置），面板自动刷新并提供手动刷新按钮。
• 自动发现 key 池：自动读取 $DSH_HOME/.credentials.yaml 中的 OPENCODE_GO_KEY_ 条目——key 的数量与命名均不写死；无池时回退显示当前生效键（OPENCODE_GO_API_KEY）。
• 中英双语：按浏览器语言自动切换。
• 主题适配：使用 DSH 主题 token，明暗主题均适配。

界面预览

工作原理

Host 半（Node ESM）：

1. 发现 key 池名称——优先使用 config.keyNames，否则自动扫描 .credentials.yaml 中的 OPENCODE_GO_KEY_* 条目。
2. 通过 credentials 服务解析每个 key 的值（环境变量 → 凭证文件 → .env 分层）。
3. 携带 Authorization: Bearer 调用官方用量端点：

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer 

响应示例：

{
  "usage": {
    "rolling": { "status": "ok", "percent": 9,  "resetsAt": "2026-08-14T07:20:04.810Z" },
    "weekly":  { "status": "ok", "percent": 12, "resetsAt": "2026-08-17T00:00:00.810Z" },
    "monthly": { "status": "ok", "percent": 6,  "resetsAt": "2026-09-09T00:41:03.810Z" }
  }
}

该用量端点尚未写入 OpenCode 官方公开文档，由 farion1231/cc-switch#6433 发现并验证。解析采用防御式处理。