dsh-opencode-go-usage：DeepSeek Harness 的余额与用量浮窗

它是做什么的？

OCG 余量查询是 DeepSeek Harness（DSH）的用量浮窗插件，把 DeepSeek 官方余额与 OpenCode Go 订阅的三个用量窗口合并到同一个悬浮胶囊里。它解决的是余额和配额分散在多个页面、需要来回切换查看的麻烦，让你在 DSH 界面里一眼看到还剩多少钱、5 小时滚动窗口、本周和本月各用了多少。插件由 verneuil 维护，采用 MIT 协议，属于轻量客户端插件，另带一个同名设置页。

核心功能

• 一屏两套数据：同一浮窗同时显示 DeepSeek 官方余额（人民币金额）与 OpenCode Go 的 5 小时 / 本周 / 本月三档用量，点击浮窗即同时刷新，一侧失败不影响另一侧。
• 三颗圆环：环心直接显示已用百分比（不带 % 号），配合状态与配色区分刷新中、成功封环与失败等形态。
• 双 Key 来源：优先使用设置页里的手动 Key，留空则自动读取 DSH 凭据库中的对应环境变量，两把 Key 都不出宿主进程，客户端只读脱敏后的配置投影。
• 可拖动浮窗：支持拖动锚定与吸附，浮窗位置由客户端写回配置，无需手工修改；也可关闭余额显示让浮窗变窄。
• 自动刷新：默认每 5 分钟一轮，同时刷新余额与用量，间隔可在设置页调整。
• 稳健接入：只占用官方为浮层保留的席位，不替换任何官方条目，样式仅使用主题令牌，适配浅色与深色。

怎么使用这个插件？

在 DSH 中启用后，浮窗会出现在界面上，点击它即可立即拉取一次余额与用量数据，拖动可调整位置并自动吸附。需要改行为时打开同名设置页：填入 OpenCode Go 与 DeepSeek 的手动 Key（留空则走 DSH 凭据库）、调整自动刷新间隔、开关浮窗或余额显示。用量接口返回滚动、本周、本月三个窗口的状态、已用百分比与重置时间，余额接口优先取人民币行，这些派生快照由宿主写入、客户端读取展示。

报错怎么排查？

浮窗上出现错误提示时，先看是哪一侧失败：余额与用量是分别拉取的，一侧报错不会影响另一侧。若提示与 Key 有关，检查设置页里的手动 Key 是否填写正确，或确认 DSH 凭据库中对应的环境变量是否存在；OpenCode Go 会依次尝试两个候选变量名，DeepSeek 使用另一个固定变量名。若数据长时间不更新，可点击浮窗手动刷新，或检查自动刷新间隔是否被设得过长。