套餐余量环 LCspax/dsh-ocgo-ring

dsh-ocgo-ring

给 DeepSeek Harness 的 OpenCode Go 套餐余量环：常驻在输入框下方、上下文用量环的右侧（圆环 + 百分比），点击展开三个窗口的余量小浮窗，并可直接点选圆环显示哪一个。

preview

功能

- 紧凑常驻：14px 圆环 + 百分比，紧挨 DSH 自带的上下文用量环右侧；圆环填充和数字都表示剩余（100% − 已用）。
- 默认滚动窗口：默认显示 rolling（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 订阅。

1. 克隆仓库：

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

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

OPENCODE_GO_API_KEY: sk-...

3. 安装插件（仓库根目录就是插件包）：

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

4. 首次安装完成后重启一次 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 或触发一次重组。

目录结构

.
├── index.js # Host 半：同源代理路由 ├── client.js # 浏览器半：圆环 + 浮窗 ├── cordis.patch.yml # Loader 补丁 ├── package.json ├── locale/ │ ├── zh.json # 插件标题 / 描述 │ └── en.json ├── icon.svg └── docs/preview.png

开发

node --check index.js
node --check client.js

改 client.js 保存即可看到 DSH 页面热更新；改 index.js 需要重启 DSH。

已知限制

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

隐私

- API key 只在 Host 进程内使用，从不下发到浏览器。
- 不采集遥测；插件只访问 OpenCode Go 的官方 usage 接口。

License

MIT © 2026 LCspax

OpenCode Go 套餐的余量环，位于 DeepSeek Harness 自带的上下文用量环右侧、输入框下方：圆环 + 剩余配额的百分比。点击圆环打开小浮窗，列出滚动（5 小时）、每周、每月三个窗口；点击某一行即可选择圆环显示哪个窗口（保存在 localStorage）。Host 端用 OPENCODE_GO_API_KEY 代理 GET /ocgo-ring/usage，缓存 60 秒，绝不把 key 暴露给浏览器。
需要 DSH >= 0.2.1-rc.2。克隆仓库，把 OPENCODE_GO_API_KEY 加到 ~/.dsh/.credentials.yaml，再把仓库目录作为插件安装，重启 DSH 一次。