前言¶
在 DeepSeek Harness（DSH）里用 OpenCode Go 订阅时，额度往往分散在 5 小时、本周、本月几个窗口里。若要到网页或单独工具里查用量，会打断在 Harness 里的对话节奏。社区插件 dsh-opencode-usage-sidebar 把这三段用量和 5 小时窗口重置倒计时放在桌面侧栏底部，与当前会话同屏可见。
下面介绍插件的定位、能力与安装配置方式。事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-opencode-usage-sidebar 由维护者 AAMMNNZZ 发布，分类为客户端插件。它在 DSH 侧栏 footer 注入一张 OpenCode Go 订阅用量卡片：展示 5 小时 / 本周 / 本月 已用比例，并在标题旁对 5 小时窗口重置做实时倒计时。
插件通过 Cordis patch 注入 @deepseek-ai/dsh-client-ui-sidebar，浏览器端仅依赖 Harness 已提供的 react，本地 bundle 无需额外 node_modules。上游用量请求由宿主侧发起（opencode.ai 会拒绝来自页面上下文的同类请求），密钥不进入浏览器。
核心功能¶
用量三行与进度条¶
卡片包含三行：5 小时、本周、本月。每行显示已用百分比和进度条；用量达到 70% 时进度条偏暖色，达到 90% 时为红色。README 中说明的数据刷新时机包括：插件配置的轮询间隔、每次 assistant 回合结束后，以及窗口重新获得焦点时。
5 小时窗口倒计时¶
OpenCode 标题旁显示距 5 小时窗口重置的倒计时（例如 1时58分、42分、42秒），每秒更新；窗口重置时文案切换为 即将刷新。
可选配置¶
可在 profile patch 或环境变量中覆盖默认行为（节选）：
| Row config | 环境变量 | 默认 |
|---|---|---|
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 |
浏览器侧通过同源路由 /dsh-opencode-usage/api/usage（JSON，带缓存）和 /dsh-opencode-usage/api/stream（SSE，用于回合结束后唤醒各窗口）拉取展示数据。
安装与启用¶
在 DSH 桌面 profile 下从仓库安装：
dsh plugin --profile desktop add git+https://github.com/AAMMNNZZ/dsh-opencode-usage-sidebar.git
若使用预构建 tarball，可将路径换为本地文件：
dsh plugin --profile desktop add file:/path/to/dsh-opencode-usage-sidebar.tgz
卸载：
dsh plugin --profile desktop remove dsh-opencode-usage-sidebar
安装前建议浏览仓库源码并确认 MIT 许可证；插件以当前 dsh 进程权限运行，密钥解析与上游 GET 均在宿主侧完成。
配置 API Key¶
插件在请求时从 DSH 凭证存储读取引用 OPENCODE_GO_API_KEY，密钥不包含在插件包内，也不会进入浏览器。
最简路径：打开 Settings → Models，为 opencode-go provider 填写 API key。这会写入 ~/.dsh/.credentials.yaml 的 refs: OPENCODE_GO_API_KEY，与插件默认的 credentialRef 一致。
若不使用 opencode-go provider，可手动写入同一 ref：
# ~/.dsh/.credentials.yaml
refs:
OPENCODE_GO_API_KEY: "<your-key>"
完成安装与凭证配置后，重启或刷新 DSH 桌面客户端，侧栏底部应出现用量卡片；若 endpoint 或轮询间隔需定制，再按上表设置 profile 或环境变量。
适用场景与注意¶
适合已在 DSH 中配置 OpenCode Go、希望在侧栏持续观察三段额度与 5 小时重置时间的开发者。不适合未订阅 OpenCode Go、或不愿在本地凭证文件中保存 API key 的环境。
社区插件目录站点 skillhub.cn 上的条目 便于检索与分享，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，安装来源以 GitHub 与上述目录页为准。
结尾¶
dsh-opencode-usage-sidebar 把 OpenCode Go 的 5 小时、周、月用量与重置倒计时收进 DSH 侧栏 footer，减少离开 Harness 查额度的次数。进一步说明与 issue 见 GitHub 仓库，目录页见 skillhub.cn/plugins/AAMMNNZZ/dsh-opencode-usage-sidebar。
