DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

boingsetta /

boingsetta/dsh-opencode-go-quota

Topic repository only

OpenCode Go quota badge for DeepSeek Harness (title-bar ring chip + usage card)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@56376818

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.ai directly.

chip

card

两种环样式

卡片底部那个 ◔ / ◎ 按钮在两种预设之间切换,选择存在浏览器 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)。

手动安装等价于两步:

  1. 把本包放到 <profile>/node_modules/dsh-opencode-go-quota/(至少 package.json、lib/index.js、lib/client.js)。
  2. 在 <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

—/ 5

No ratings yet

Manifest verification required

Commit 56376818c016

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout