dsh-opencode-go-quota
在 DeepSeek Harness Web GUI 的标题栏放一枚 OpenCode Go 额度徽章:中间是 OpenCode 的方形标志, 外面一圈环表示三档额度(蓝=滚动 5 小时、黄=本周、白=本月)。鼠标移上去弹出用量卡片 (档位名、已用百分比、重置倒计时、进度条、更新时间、打开 Console)。
A DeepSeek Harness (DSH) client plugin that shows your OpenCode Go quota as a tri-ring badge in the window title bar. Hover it for a card with per-window usage, reset countdowns and a refresh button. Two ring presets (three 120° thirds, or three identical overlapped rings), light/dark aware, no host-side network access — the browser talks to
opencode.aidirectly.


两种环样式
卡片底部那个 ◔ / ◎ 按钮在两种预设之间切换,选择存在浏览器 localStorage 里,下次打开还是它:
| 预设 | 画法 |
|---|---|
三段(segments,默认) |
一个圆切成三段,蓝在正上方、黄在右侧、白在左侧,每段按该档剩余比例画弧 |
三环叠放(layered) |
三个半径、圆心、起点都相同的整圆,从 12 点开始按已用比例画弧;白色(本月)画在最下层,黄色(本周)压在它上面,蓝色(5 小时)在最上层 |
配置里也可以直接指定默认值:ringStyle: segments | layered。
行为
- 徽章:已用 ≥ 70% 时对应数字转黄、≥ 90% 转红,并在徽章右上角出现一个红点。
- 卡片:
滚动 5 小时 / 本周 / 本月三行,右侧是已用百分比与「N 小时/天后重置」,下面是同色进度条; 底部是「更新于 …」、切换环样式、↻立即刷新、⚙换 key、打开 Console ↗。 - 悬停即展开,移开 260ms 后收起;点一下是「钉住」(再点取消),点空白处或
Esc也会关。 - 缓入缓出:卡片出现时 180ms 淡入并从触发点方向滑入(标题栏里是从上往下),收起时 150ms 淡出并回缩,
结束后才从 DOM 卸载(
data-state="open" / "closing"驱动)。prefers-reduced-motion: reduce下不加动画。 - 默认 60 秒轮询,展开时立即刷新一次;断网或 key 失效时卡片里红字显示原因,不会崩界面。
安装
解压后在该目录打开 PowerShell,一条命令装好(找 profile、复制包、写 cordis.patch.yml,改前自动备份):
powershell -ExecutionPolicy Bypass -File .\install.ps1
# 指定 key: -ApiKey oc_sk_xxx
# 指定 profile: -Profile work
# 已把 key 存在 ~/.dsh/.credentials.yaml 里的话,脚本会自动取用
不带 -ApiKey 且找不到 oc_sk_... 时,插件仍然装好:徽章照常显示,第一次点开卡片在里面粘 key 即可(存浏览器 localStorage)。
手动安装等价于两步:
- 把本包放到
<profile>/node_modules/dsh-opencode-go-quota/(至少package.json、lib/index.js、lib/client.js)。 - 在
<profile>/cordis.patch.yml末尾追加:
- insert:
- id: ui-opencode-go-quota
name: dsh-opencode-go-quota
config:
apiKey: oc_sk_xxxxxxxx
placement: titlebar # titlebar(默认,标题栏)| statusbar(底栏)
ringStyle: segments # segments(三段)| layered(三环叠放)
refreshMs: 60000 # 最小 5000
安装后 DSH 会重新读取 cordis.patch.yml 并把插件挂上;如果没出现,重启一次 DSH 即可。
卸载:
powershell -ExecutionPolicy Bypass -File .\uninstall.ps1
配置
| 键 | 默认 | 说明 |
|---|---|---|
apiKey |
空 | oc_sk_...。留空的话徽章照样显示,点开后是输入框,key 存浏览器 localStorage |
placement |
titlebar |
titlebar 挂 shell.overlay 浮在标题栏右侧;statusbar 挂 shell.bottom 底栏右端 |
ringStyle |
segments |
segments 三段同圆;layered 三环同位叠放(卡片里的 ◔ / ◎ 按钮可直接切) |
refreshMs |
60000 |
轮询间隔,小于 5000 会被抬回默认值 |
baseUrl |
https://opencode.ai/inference/go/v1 |
Go 网关,末尾斜杠会被去掉 |
consoleUrl |
https://opencode.ai/console |
卡片里「打开 Console」的目标 |
plan |
Default |
卡片标题下那行副标题 |
数据来源
GET https://opencode.ai/inference/go/v1/usage
Authorization: Bearer oc_sk_...
{"usage":{
"rolling":{"status":"ok","percent":2,"resetsAt":"..."},
"weekly" :{"status":"ok","percent":7,"resetsAt":"..."},
"monthly":{"status":"ok","percent":3,"resetsAt":"..."}}}
percent 是已用百分比。请求直接由浏览器发出(opencode.ai 对浏览器开放了 CORS 并允许 Authorization),
不经过 Host。这是实测可用的 Console 接口,属于内部约定,OpenCode 改版时可能变化 —— 变化时卡片里会显示
HTTP 404 之类的原因,而不是画一个错的环。
实现
lib/index.js是 Host 半边:只有inject/apply(),让 loader 把包挂成 Cordis 节点。lib/client.js是浏览器半边,按 shell 模块表格式包在window.__ModuleLoader__.load({ id, factory })里, 只require('react')和react/jsx-runtime,没有额外依赖。- 徽章挂
shell.overlay(id: opencode-go-quota,整帧浮层,默认pointer-events: none,只有徽章和卡片接事件) 或shell.bottom(整行状态栏)。卡片是position: fixed,避免被overflow裁掉。 - 标题栏那一条在 Windows 上是窗口拖拽区(
-webkit-app-region: drag),落在里面的元素会被系统吞掉鼠标事件, 所以徽章/卡片都显式写了-webkit-app-region: no-drag—— 少了这一句,:hover样式还在,但点击和悬停回调全都不触发。 - CSS 用
data-plugin-css的<style>注入,插件被禁用时随条目一起回收;配色跟着主题走 (深色下「本月」是白色,浅色下换成近黑,否则白底看不见白环)。
已知限制
- 改动
lib/client.js后,桌面端要把整页重载一次才会换到新代码(应用里没有「重新加载」菜单项, 所以实际做法是重启 DSH;改cordis.patch.yml里这一行的config也能触发 Host 重新挂载并让页面换 bundle)。 - 只覆盖 Go 订阅档位,按量付费的余额没有对应接口。
- 标题栏里的位置是
right: 140px(让开 Windows 的三个窗口按钮);如果你的窗口控制按钮更宽或更窄, 改lib/client.js里.ogq-bar[data-placement="titlebar"]的right即可。
License
MIT
No comments yet. Be the first to write one.