前言¶
DeepSeek Harness（DSH）是一个基于插件的智能体开发环境。在开发过程中，如果使用 OpenCode Go 套餐，需要关注剩余额度。原生的 DSH 没有提供额度监控能力，开发者需要自己记住或去网页端查看。dsh-ocg-used 在 DSH 输入框右侧工具栏增加了一个胶囊控件，实时显示剩余额度，减少查看次数。
是什么¶
windf1y/dsh-ocg-used 是一个 DSH 客户端插件，用于在 DSH 的 Web 界面输入框右侧显示 OpenCode Go 套餐的剩余额度。插件在工具栏胶囊常驻显示三个窗口的剩余百分比，按余量自动变色（充足 / 偏紧 / 告急），鼠标悬停可以查看更详细的数据。
核心功能¶
- 工具栏胶囊常驻，逐个窗口显示剩余百分比，按余量自动变色（充足 / 偏紧 / 告急）
- 悬停面板：每个窗口的剩余、已用、重置时刻、距重置还剩多久，以及本次数据更新时间
- 点击胶囊立即刷新；平时每 60 秒刷新一次
- 未配置 Key 或上游失败时显示「余量不可用」，悬停给出具体原因
兼容性¶
- DSH
>= 0.1.7-rc.1 - Node
^22.19.0 || >=24.0.0 - 已验证环境：DSH 0.1.7-rc.1 的 Web profile
安装与启用¶
从 GitHub 安装不需要构建脚本授权，仓库里已经提交了构建产物 lib/：
dsh plugin --profile web add github:windf1y/dsh-ocg-used
dsh web
装好后重启 dsh web（bundle 列表的变化在下次启动生效），工具栏就会出现胶囊。
更新到最新版本需要先卸载再安装：
dsh plugin --profile web remove dsh-ocg-used
dsh plugin --profile web add github:windf1y/dsh-ocg-used
卸载：
dsh plugin --profile web remove dsh-ocg-used
确认当前 profile 里装了什么：
dsh plugin --profile web list
配置 API Key¶
插件通过 DSH 的凭据 seam 读 OPENCODE_GO_API_KEY，值本身不会进配置文件。查找优先级是：
- 启动 dsh 的那个进程环境（
OPENCODE_GO_API_KEY=… dsh web） - 凭据存储文件里的
refs.OPENCODE_GO_API_KEY（GUI 设置里保存的 key 也写在这里） - 项目根目录的
.env - harness home 下的
.env
任选其一即可：
OPENCODE_GO_API_KEY=sk-… dsh web
或者在 GUI 的设置界面里保存这个 key，或写进项目根的 .env：
OPENCODE_GO_API_KEY=sk-…
典型用法¶
配置好 API Key 后，启动 DSH Web 界面，输入框右侧工具栏会显示一个胶囊。胶囊显示三个窗口的剩余百分比：5 小时、一周、一个月。根据剩余比例，胶囊会自动变色：
- 充足：剩余比例较高
- 偏紧：剩余比例中等
- 告急：剩余比例较低
鼠标悬停在胶囊上，会展开一个面板，显示每个窗口的剩余、已用、重置时刻、距重置还剩多久，以及本次数据更新时间。
点击胶囊可以立即刷新数据。
适用场景与注意¶
适合经常使用 OpenCode Go 套餐、需要随时掌握额度情况的 DSH 开发者。
插件以当前 dsh 进程权限运行，安装前建议查看源码与许可证（MIT）。同一个 composition 里只能有一份注册 /opencode-go/quota 的插件，如果 DSH 已经内置了同名路由（例如自己 fork 过 Web bundle），同时启用两边会以 webserver: duplicate exact route "/opencode-go/quota" 启动失败，需要禁用其中一个。
总结¶
dsh-ocg-used 在 DSH 的输入框工具栏提供 OpenCode Go 套餐余量监控，通过胶囊和悬停面板展示三个窗口的剩余、已用、重置时刻等信息，帮助开发者随时掌握额度情况，减少去网页端查看的次数。
目录页：https://www.skillhub.cn/plugins/windf1y/dsh-ocg-used
GitHub：https://github.com/windf1y/dsh-ocg-used
