前言¶
如果日常通过 DeepSeek Harness (DSH) Web GUI 使用 OpenCodeGo，剩余额度通常需要单独查看。dsh-opencodego-usage 把这个信息放进 DSH Web GUI：在对话输入框右下角显示一个呼吸灯，点击后展开面板，查看 rolling、weekly、monthly 三个窗口的用量、剩余比例和重置时间。
这是什么¶
BeiZi6/dsh-opencodego-usage 是为 DeepSeek Harness (DSH) Web GUI 提供 OpenCodeGo 剩余额度监控插件。仓库 owner 为 BeiZi6，package.json 中的 author 为 Xu Yuanshan。它适用于 dsh web，许可证为 MIT © Xu Yuanshan。
核心功能¶
- 在对话输入框右下角显示呼吸灯，按剩余额度比例变色：>50% 绿、20–50% 黄、<20% 红，并带 3.6 秒呼吸动画。
- 指示器颜色反映 rolling、weekly、monthly 三个窗口中最低的剩余额度比例。
- 点击呼吸灯展开液态玻璃面板，展示 rolling、weekly、monthly 三个窗口的进度条和重置时间。
- 自动从 DSH credentials 读取 API key；仅当 active provider 为
opencode-go时，解析llm-pi-ai.providers.opencode-go.apiKeyEnv指定凭据。 - 面板内可手动覆盖当前会话 API key；清除后回退自动解析。
- 每 2 分钟自动刷新 OpenCodeGo 配额。
- 面板具有鼠标跟随高亮、磨砂模糊和窗口式斜向打开动画。
- 在 DSH web server 注册同源路由
/opencodego-usage，并查询官方 OpenCodeGo quota API：
GET https://opencode.ai/zen/go/v1/usage
请求使用 Bearer 认证。
安装与启用¶
安装前需要启用 web profile 的 DeepSeek Harness。运行环境要求 Node.js >= 22.19，peer dependencies 为：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-host-webserver ^0.1.0-rc.6
从官方 registry 安装：
dsh plugin --profile web add github:BeiZi6/dsh-opencodego-usage
安装后重启 dsh web，使插件生效。
移除插件：
dsh plugin --profile web remove dsh-opencodego-usage
典型用法¶
1、在 DSH Web GUI 的对话输入框右下角查看呼吸灯。颜色表示当前最低剩余额度：
| 剩余额度比例 | 颜色 |
|---|---|
| >50% | 绿 |
| 20–50% | 黄 |
| <20% | 红 |
2、点击呼吸灯展开面板，查看三个窗口：
rolling：约近 5 小时weekly：约近 7 天monthly：约近 30 天
每个窗口展示用量、剩余比例和重置时间。
3、如果当前会话需要使用另一个 API key，可在面板中输入手动 API key override。清除后，插件回退到自动解析。
4、面板数据每 2 分钟自动刷新，无需手动重复查询。
API key 与状态文件¶
手动覆盖的 API key 会保存在状态文件中。默认位于 $DSH_HOME 下，可通过 OCG_STATE_PATH 环境变量移动路径。删除该文件不会影响基于 DSH credentials 的解析。
API key 只会通过 HTTPS 发送到官方 OpenCodeGo quota endpoint。
适用场景与注意¶
适合在 DSH Web GUI（dsh web）中使用 OpenCodeGo，并希望在对话界面直接查看剩余额度的场景。
注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 配额数值和重置时间按 OpenCodeGo API 返回原样展示，不做本地估算。
- 插件在 DSH web server 注册同源路由
/opencodego-usage，并在后端查询官方 OpenCodeGo quota API。 - 需要
Node.js >= 22.19以及对应 peer dependencies。
结尾¶
dsh-opencodego-usage 把 OpenCodeGo 剩余额度接入 DSH Web GUI，适合需要在输入框附近快速判断 rolling、weekly、monthly 配额状态的使用场景。
仓库地址：https://github.com/BeiZi6/dsh-opencodego-usage
如使用 DSH 社区目录，可按插件名 dsh-opencodego-usage 检索。
