前言¶
在 DeepSeek Harness（DSH）里用 OpenCode Go 或 DeepSeek 官方模型时，额度往往分多个时间窗口，余额又和 OpenCode 额度不是同一套接口。真正挡住你的经常是 5 小时滚动窗口，而不是月剩余；要确认还剩多少，通常得切到控制台或设置页。dsh-opencode-go-usage-badge 在侧栏底部放一个只读小徽标：跟当前对话的模型来源自动切换显示 OpenCode Go 三窗口额度或 DeepSeek 余额，不占布局、不写磁盘。
这是什么¶
dsh-opencode-go-usage-badge 是维护者 Panther-w 发布的 DSH 客户端插件（MIT 许可，当前包版本 0.4.2）。它通过 DSH 的 uiSession 读取当前主视图会话的 modelSelection，不修改模型或任何设置；在侧栏底部折叠显示你勾选的额度窗口或余额数字，展开后可勾选要看的窗口、手动刷新。
社区目录：skillhub.cn 插件页。源码与说明：GitHub 仓库。
核心功能¶
跟模型来源自动切换¶
插件只识别三个内置 provider id，其他来源显示灰色「额度 —」，不猜测数字。
| Provider id | 显示内容 | 前提 |
|---|---|---|
opencode-go |
OpenCode Go 三窗口额度（5h / 1w / 1m） | 在 DSH 中配置 OPENCODE_GO_API_KEY，或登录 OpenCode Console |
deepseek-account |
DeepSeek 登录账号余额 | 在 DSH「设置 → 账号与余额」登录 |
deepseek-official |
DeepSeek API Key 余额 | 在 DSH 中配置 DEEPSEEK_API_KEY |
切换对话的模型来源时会立即换源；自定义 provider 别名或改过接口地址的不受支持。
额度窗口与状态颜色¶
OpenCode Go 的三个窗口各自独立阻塞。默认折叠态只显示你勾选的窗口，顺序固定，例如 ● 5h 95% 或 ● 5h 95% · 1w 98%；展开卡可勾选 5h / 1w / 1m，至少保留一个，默认只选 5h，偏好记在浏览器 localStorage。
状态点颜色始终按三个窗口里最紧的那个上色，即使你隐藏了该窗口；若未显示的窗口更紧，徽标会加黄色 !，悬停说明是哪个窗口。阈值：高于 20% 绿、6–20% 黄、5% 及以下红；20% 及以下时数字本身也会变黄/红。
DeepSeek 官方对话时折叠显示如 ● ¥88.00；展开卡可看到总余额、充值余额、赠金、数据来源与当前模型；余额为 0 或负数时为红色。
刷新与缓存¶
页面可见时每 60 秒刷新；回到前台、页面恢复、网络恢复或切换模型来源时立即刷新。上游结果缓存 30 秒；展开卡的刷新按钮可绕过缓存。数据超过 5 分钟会标 !；某次请求失败时保留该来源上一次成功值；凭据缺失、被拒或退出时清除显示。
安装与启用¶
README 写明适配 DeepSeek Harness Desktop 0.2.2-rc.1，macOS 实测；Windows / Linux 未做人工实测，CI 会在三平台跑自动测试。
- 从 Release 下载
dsh-opencode-go-usage-badge-0.4.2.tgz，或准备好本机上的包路径。 - 在 DSH Desktop 打开「插件 → 添加插件」，输入 tgz 路径、仓库地址或本包绝对路径；安装后启用该 bundle。
- 完全退出并重新打开 DSH Desktop；打开使用上述 provider 的对话，看左下角徽标。
命令行安装（与 README 一致）：
dsh plugin --profile desktop add /path/to/dsh-opencode-go-usage-badge-0.4.2.tgz
dsh plugin --profile desktop add https://github.com/Panther-w/dsh-opencode-go-usage-badge
卸载：在「插件」页面移除该插件后重启 Desktop。
典型用法¶
安装并重启后，无需单独设置页。在侧栏底部扫一眼折叠数字即可；需要对比多个窗口时点开展开卡勾选 5h / 1w / 1m。若从 OpenCode Go 切到 DeepSeek 官方模型，徽标应自动变为余额显示；未配置对应凭据时，该来源会被清除或无法拉取，需先在 DSH 里配好 Key 或完成账号登录。
设计上是只读：浏览器只调 DSH 本机同源回环路由；API Key 与账号 Token 留在 Host 进程，不由本插件写入磁盘。无遥测、无诊断上报。
适用场景与注意¶
适合长期在 DSH Desktop 里交替使用 OpenCode Go 与 DeepSeek 官方模型、又不想频繁离开对话去查额度或余额的开发者。插件以当前 DSH 进程权限运行，安装前建议浏览 源码 与 MIT 许可证。
已知限制（摘自上游说明）：
- 仅支持上述三个内置 provider id；OpenCode Go 与 DeepSeek 余额接口非公开稳定契约，上游变更可能需要插件适配。
- 依赖 DSH 内部服务与投影字段，DSH 大版本升级后可能需要适配。
- 未配置 Go API Key 时，Host 可能只读 OpenCode Console 本地凭据
~/.local/share/opencode-console/credential.json（或XDG_DATA_HOME下等价路径）作兜底；Console 改结构时需插件跟进。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-opencode-go-usage-badge 把 OpenCode Go 多窗口额度与 DeepSeek 余额收到侧栏一行，跟会话模型来源走，只读、低额度变色提醒。需要安装包或 issue 时到 GitHub，在目录站可查看分类与简介：Panther-w/dsh-opencode-go-usage-badge。
