DeepSeek Harness (DSH) 采用插件化架构。在使用 OpenCode Go 服务时，管理多个 API Key 的用量往往需要频繁切换页面或查看后台，效率较低。dsh-opencode-go-usage 旨在解决这个问题，它将 OpenCode Go 的订阅用量监控直接集成到 DSH 的 Web 界面中。
插件定位¶
这是一个 DSH Web 插件，由 mouseteamlucky 维护。它提供悬浮窗口，实时展示 OpenCode Go 订阅用量，支持按 Key 展示滚动/周/月窗口的用量条、百分比和重置倒计时。
核心功能¶
- 悬浮窗口：紧凑按钮固定在右侧边缘，显示所有 Key 中最差窗口的百分比，并根据紧迫程度（绿/橙/红）闪烁。
- 展开面板：每张卡片显示一张 Key 的用量详情，包含用量条、百分比、重置倒计时和手动刷新按钮。
- 实时刷新：Host 端轮询官方端点获取数据，面板自动更新。
- Key pool 自动发现：自动读取
$DSH_HOME/.credentials.yaml中的OPENCODE_GO_KEY_<name>配置。 - 双语 UI & DSH 主题令牌：界面支持中英文切换，并适配 DSH 的亮色/暗色主题。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add github:mouseteamlucky/dsh-opencode-go-usage
安装完成后，重启 DSH Web 应用（通过 launcher 或受保护路径），并刷新浏览器页面即可生效。
典型用法¶
启用后，在 DSH Web 界面右侧边缘会出现悬浮按钮。点击按钮展开面板，即可查看所有 Key 的实时用量。面板会自动轮询数据，支持手动刷新。
适用场景与注意¶
此插件适合需要同时管理多个 OpenCode Go Key 并希望实时监控用量的开发者。
技术实现上，Host（Node ESM）负责聚合数据，Client（浏览器）负责展示，Key 数据不会直接暴露给浏览器。依赖项包括 React、@deepseek-ai/cordis、@deepseek-ai/dsh-credentials 和 @deepseek-ai/dsh-home-paths。
注意：上游 fork 归属 @xiaweiliang060035/dsh-opencode-go-usage。
总结¶
该插件通过悬浮组件解决了多 Key 用量监控的痛点。更多详情可参考目录页或 GitHub 仓库。
