DeepSeek Harness 的 OpenCode Go 套餐余量环

前言¶

DeepSeek Harness（DSH）的上下文用量环在输入框下方，但默认不显示 OpenCode Go 套餐的剩余额度。开发者如果只依赖官方的用量浮窗，需要手动点击展开，查看滚动、每周、每月三个窗口的进度时操作较繁琐。dsh-ocgo-ring 插件在上下文用量环右侧常驻一个圆环，显示当前选中的窗口的剩余百分比，点击即可切换窗口。

是什么¶

dsh-ocgo-ring 是一个 DSH 插件，把 OpenCode Go 套餐的余量以圆环形式常驻在 composer 输入框下方，右侧是 DSH 自带的上下文用量环。圆环显示剩余百分比（100% - 已用），默认窗口是滚动（5 小时），点击圆环展开三个窗口的余量小浮窗，每行显示余量百分比、进度条和重置倒计时。插件由 LCspax 维护，属于客户端插件。

核心功能¶

紧凑常驻显示：14px 圆环 + 百分比，紧挨上下文用量环右侧。圆环填充和数字都表示剩余（100% - 已用）。
三个窗口：浮窗列出滚动（5 小时）、每周、每月三个窗口，每行显示余量百分比、4px 进度条和重置倒计时。
点选切换：点击任意一行即可切换圆环显示的窗口，选择写入 localStorage（键 ocgo-ring.metric），刷新或重启后保留。
rate-limited 提示：窗口进入限流状态时，圆环和行内数字使用琥珀色（--dsw-alias-state-warn-primary）。
与上下文用量浮窗同款样式：复用同一套 useAnchoredPosition / useDismissOnOutsidePointer 和 UI 令牌，面板位置、圆角、阴影、字号一致。
API key 不出主机：浏览器只拿百分比；Host 端 60 秒缓存，多标签页不会重复请求上游。

安装与启用¶

要求：DSH 0.2.1-rc.2 及以上（Web / Desktop），以及 OpenCode Go 订阅。

克隆仓库：

git clone https://github.com/LCspax/dsh-ocgo-ring.git

把 OpenCode Go 的 API key 写进 DSH 凭据存储（~/.dsh/.credentials.yaml）：

OPENCODE_GO_API_KEY: sk-...

DSH 桌面版：侧栏「插件」→「添加插件」→ 填本地目录的绝对路径。
或 CLI：dsh plugin --profile <profile> add <path-to-repo>。

首次安装完成后重启一次 DSH（Host 路由需要重新加载），再刷新页面。

配置¶

当前为固定配置（改 index.js 顶部常量即可）：

项	值
凭据引用	`OPENCODE_GO_API_KEY`
上游接口	`https://opencode.ai/zen/go/v1/usage`
Host 缓存	60 秒
前端轮询	60 秒
同源路由	`GET /ocgo-ring/usage`

工作方式¶

DSH 浏览器
  └─ client.js  注册到 conversation.composer.dock（order 1 → 上下文用量环右侧）
        │  fetch('/ocgo-ring/usage') 每 60s
        ▼
DSH Host
  └─ index.js   读 ctx.credentials('OPENCODE_GO_API_KEY')
        │  GET https://opencode.ai/zen/go/v1/usage（缓存 60s）
        ▼
OpenCode Go

上游返回每个窗口的已用百分比；插件在浏览器端换算成余量。client.js 是手写的 window.__ModuleLoader__.load bundle（不依赖构建工具），改完 DSH 客户端会自动热重载（约 1 秒）。Host 半改动需要重启 DSH 或触发一次重组。

适用场景¶

适合使用 DSH 0.2.1-rc.2 及以上版本、订阅 OpenCode Go 套餐的开发者，希望在 composer 输入框下方快速查看 OpenCode Go 套餐剩余额度的场景。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（MIT）。

注意事项¶

仅在 DSH 0.2.1-rc.2（Windows）上验证；依赖 conversation.composer.dock 与 @deepseek-ai/dsh-client-ui-primitives 的公开接口。
上游接口字段若发生变化，浮窗会显示「暂时取不到用量」，圆环保持空环。
当前显示的是余量；若更习惯「已用」，改 remainingOf() 及行内百分比即可。

结语¶

dsh-ocgo-ring 把 OpenCode Go 套餐的余量信息浓缩在上下文用量环右侧，点击即可切换滚动、每周、每月三个窗口，解决了查看额度时需要频繁点击官方浮窗的问题。插件不采集遥测，API key 只在 Host 进程内使用，从不下发到浏览器，隐私方面较为谨慎。

目录页：https://www.skillhub.cn/plugins/LCspax/dsh-ocgo-ring
GitHub：https://github.com/LCspax/dsh-ocgo-ring