前言¶

在 DeepSeek Harness（DSH）里用 OpenCode Go 做模型调用时，订阅额度往往要切到 OpenCode 官方面板或另开工具才能看清：滚动 5 小时、本周、本计费周期各用了多少、何时重置。开发过程中若只凭感觉调模型，容易在某个窗口里用得比时间进度更快，直到报错或限流才反应过来。

下面介绍社区插件 dsh-opencode-go-quota（维护者 WihteCo，分类：客户端）。它把 OpenCode Go 官方用量接口的结果嵌进 DSH 网页版左侧边栏底部，与工作区 / 会话列表、设置同一区域，用一行紧凑 UI 和浮层展示三档额度，且 API Key 只留在 Host 进程，不下发到浏览器。

这是什么¶

dsh-opencode-go-quota 是 DSH 的 bundle + web client 插件：Host 半边代理 GET /api/opencode-go-quota，Client 半边注册到 sidebar.footer.action，在侧边栏 foot 显示 OpenCode Go 额度。

• 仓库：WihteCo/dsh-opencode-go-quota
• 社区目录：skillhub.cn 插件页
• 许可证：MIT（见仓库 package.json）
• 运行环境：Node.js >= 20

DSH 生态采用「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装第三方插件前，建议自行阅读源码与许可证——插件以当前 DSH 进程权限运行。

核心功能¶

侧边栏展示¶

浮层每档示意（含义见 README）：

5 小时窗口                        已用 8%
▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   ← 填充=已用；竖线=时间进度
剩余 92%            时间已过 46%      2 小时 12 分钟后重置

• 竖线在填充右边：用得比时间慢，相对安全；在左边：比时间快，宜收着用。
• 「本月」的时间进度带 ≈：计费周期起点不在接口里，按重置时间往前推一个自然月估算；5 小时窗口与「本周」为精确窗口（5 小时 / 7 天）。

颜色规则：已用 < 70% 品牌蓝，70%–89% 黄色，≥ 90% 红色；取不到数据显示灰色 --。

数据与鉴权¶

1. 浏览器只请求同源 GET /api/opencode-go-quota（Host 拒绝跨站调用）。
2. Host 使用 DSH 凭据库中已有的 OPENCODE_GO_API_KEY（与 opencode-go provider 在 cordis.patch.yml 里 apiKeyEnv 指向的环境变量一致），请求上游
   https://opencode.ai/zen/go/v1/usage。
3. Key 不进入浏览器；上游响应示例：

{"usage":{
  "rolling":{"status":"ok","percent":5,"resetsAt":"2026-10-07T06:00:12.000Z"},
  "weekly":{"status":"ok","percent":5,"resetsAt":"2026-10-12T00:00:00.000Z"},
  "monthly":{"status":"ok","percent":17,"resetsAt":"2026-10-28T11:29:15.000Z"}}}

4. 三档含义与 OpenCode 面板一致：rolling = 滚动 5 小时；weekly = 本周（周一 UTC 重置）；monthly = 当前计费周期。数字为全账号口径（含其他机器上的用量）。
5. 页面每 60 秒自动刷新；Host 另有 30 秒缓存。上游 cache-control: no-store，用量会随实际调用实时变化。

安装与启用¶

安装（README 示例：本机 desktop profile 已装 bundle 时，target 为本插件目录或 file: 绝对路径）：

plugin_manager  action=install_bundle  target=<本目录或 file:/绝对路径>

卸载：

plugin_manager  action=remove_bundle   target=dsh-opencode-go-quota

临时停用：

plugin_manager action=set_plugin target=opencode-go-quota enabled=false

安装后一般无需重启 DSH；若侧边栏未立刻出现，刷新浏览器页面即可。

典型用法¶

1. 在 DSH「设置 → 模型」中为 opencode-go 配置 API Key（对应环境变量 OPENCODE_GO_API_KEY）。
2. 按上文命令安装 bundle 后打开 DSH 网页版，在左侧边栏最底部（工作区 / 会话列表下方）查看额度单元格。
3. 需要看三档明细时，悬停或点击单元格打开浮层；怀疑数据滞后时，在浮层内点「刷新」。
4. 排查 Host 是否正常时，可在本机执行：

curl -s http://127.0.0.1:19387/api/opencode-go-quota

（默认端口以你本地 DSH 配置为准；README 示例为 19387。）

适用场景与注意¶

适合谁： 已在 DSH 中配置 OpenCode Go、希望长时间写代码或跑智能体时不用切站就能盯三档额度与重置时间的开发者。

常见报错（README 排查节）：

• 卡片红色错误文字：鼠标悬停看完整信息。
• 凭据 OPENCODE_GO_API_KEY 未配置 → 在设置里为 opencode-go 填写 API Key。
• 额度接口返回 401 → Key 失效或已轮换，重新填写。

安全与权限： 插件会代表 Host 用已存 Key 访问 OpenCode 官方用量接口；安装前请确认仓库来源与 MIT 许可，并理解其与 DSH 主程序同进程权限。

结尾¶

dsh-opencode-go-quota 把 OpenCode Go 的三档用量与重置倒计时收进 DSH 侧边栏 foot，并用 Host 代理保护 API Key。若你正在 SkillHub 或 GitHub 上选型客户端类 DSH 插件，可从这里入手：

• 目录页：https://www.skillhub.cn/plugins/WihteCo/dsh-opencode-go-quota
• GitHub：https://github.com/WihteCo/dsh-opencode-go-quota