OpenCode 用量侧栏 AAMMNNZZ/dsh-opencode-usage-sidebar

dsh-opencode-usage-sidebar

在 DeepSeek Harness 侧栏底部显示 OpenCode Go 订阅用量卡片：5 小时、本周、本月三个窗口一眼看清，并实时倒计时到 5 小时窗口重置。

把 OpenCode 订阅的 5 小时 / 本周 / 本月 用量显示在 DSH 侧栏底部，并在卡片标题旁实时倒计时到 5 小时窗口重置。

显示内容

- 三行——5 小时、本周、本月——每行显示已用百分比，进度条在 70% 时变暖色，90% 时变红。
- OpenCode 标题后实时倒计时（1时58分、42分、42秒），每秒跳动，5 小时窗口重置时切换为 即将刷新。
- 按插件的轮询间隔刷新，每轮助手回复结束后刷新，窗口重新获得焦点时也刷新。

安装

from this repository
dsh plugin --profile desktop add git+https://github.com/AAMMNNZZ/dsh-opencode-usage-sidebar.git

or from a prebuilt tarball
dsh plugin --profile desktop add file:/path/to/dsh-opencode-usage-sidebar.tgz

卸载：dsh plugin --profile desktop remove dsh-opencode-usage-sidebar。

配置 API key

插件在请求时从 DSH 凭据库读取凭据引用 OPENCODE_GO_API_KEY——key 从不放进这个包，也从不进入浏览器。

最省事的做法是打开设置 → Models 页面：为 opencode-go 服务商填入 API key。key 会存到 ~/.dsh/.credentials.yaml 的 refs: OPENCODE_GO_API_KEY 下，正是本插件解析的引用。

如果你不用 opencode-go 服务商，手动添加引用：

~/.dsh/.credentials.yaml
refs:
OPENCODE_GO_API_KEY: "<your-key>"

选项

在配置档补丁里可选配置行，或使用对应的环境变量：

| 行配置 | 环境变量 | 默认值 |
| endpoint | DSH_OPENCODE_USAGE_ENDPOINT | https://opencode.ai/zen/go/v1/usage |
| credentialRef | DSH_OPENCODE_USAGE_CREDENTIAL | OPENCODE_GO_API_KEY |
| pollIntervalSec | DSH_OPENCODE_USAGE_POLL | 60（最小 15） |
| cacheMs | — | 15000 |

工作原理

宿主端负责解析凭据并自己发起上游 GET 请求——opencode.ai 会拒绝来自页面上下文的这类请求。浏览器端只轮询同源路由 /dsh-opencode-usage/api/usage（JSON，带缓存）和 /dsh-opencode-usage/api/stream（SSE，用于在一轮对话结束后唤醒所有打开的窗口）。

两端都没有依赖：宿主端不导入任何模块，客户端只用 harness 已提供的 react 模块，所以本地安装的 bundle 不需要 node_modules。

许可证

MIT