daydream-wjh/dsh-opencode-go-usage ↗★ 0

dsh-opencode-go-usage

DeepSeek Harness plugin: OpenCode Go quota readout above the composer (rolling / weekly / monthly windows with reset countdowns)

套件
dsh-opencode-go-usage
相容性
待驗證
版本
0.1.1
授權
MIT
最近更新
2026年10月28日

同名套件的其他儲存庫

安裝

此插件尚未提供可驗證的 bundle,或相容性檢查未通過。請先閱讀倉庫說明。 閱讀完整 README ↗

dsh-opencode-go-usage

test

一个 DeepSeek Harness(DSH)插件:在输入框上方常驻一行 OpenCode Go 套餐限额读数——滚动窗口 / 本周 / 本月三条额度用了多少,以及最近一次重置还剩多久。

输入框上方的限额读数(展开明细后)

它显示什么

收起状态(一行):

● OpenCode Go 限额   滚动 4% · 周 1% · 月 0% · 3 小时 39 分后重置        ⟳  ▾
  • 三个数字是套餐的三条窗口:滚动(rolling)、周、月,取自提供方 GET https://opencode.ai/zen/go/v1/usage 的 percent 字段。
  • 倒计时是最近一个要重置的窗口(通常是滚动窗口)。
  • 圆点取三条窗口里最高的那条:< 70% 正常色,≥ 70% 警告色,≥ 100% 错误色。
  • ⟳ 立即重读(?force=1,跳过宿主 20 秒缓存);▾ 展开明细,展开状态记在 localStorage: dsh.opencode-go-usage.expanded。

展开状态:

行内容
滚动窗口 / 本周 / 本月百分比、进度条、x 天 y 小时后重置(悬停看具体时刻)
页脚提供方上报的 status(正常 / 接近上限 / 已用尽…)、上次读数时间

未配置 OPENCODE_GO_API_KEY 时只显示一行灰字提示,不占位;读取失败(网络、上游 5xx) 显示错误原因,下一次轮询自动重试。

新对话页

新建对话时输入框居中放大(hero 布局),这一行仍然贴在输入框上沿、与输入框同宽同边:

新对话页上的一行读数

这里是它唯一需要额外小心的地方:hero 下的输入框栈(composerStack + composerHero)是一个 高度被收窄的 flex 列,标题区先吃掉整列高度,其余子项按 flex-shrink 分剩下的空间。 本插件的行默认 flex-shrink: 1,再加上 overflow: hidden 会把 min-height: auto 折算成 0, 于是被压成 9px 的细条、文字裁掉半截:

修复前:被压成 9px 的细条,文字被裁

修法是让这一行退出收缩(flex: 0 0 auto),保住自身高度,把溢出交给 hero 列自己滚动:

实测(1440×900,DSH 0.2.1-rc.3)修复前修复后
行高(收起)9px,scrollHeight 30px,内容被裁30px,无裁切
行高(展开三条窗口)同样被压缩130px,三行完整
与输入框的横向对齐774px,左边缘对齐774px,左边缘对齐(不变)

未配置 Key 的那行灰字走同一个根节点样式,也一并钉住了;verify/client.test.mjs 里有一条回归用例守住这个 flex。

为什么分两半

半边文件职责
宿主lib/index.js从 ctx.credentials 解析 OPENCODE_GO_API_KEY,请求上游用量接口,归一化成三窗口,缓存 20 秒,注册 GET /opencode-go/usage
客户端lib/client.js只读宿主路由并渲染;不碰 Key,不跨域请求 opencode.ai

上游用量接口要账号 Key,而 Key 只存在于 .credentials.yaml,浏览器脚本里不该出现。 路由挂在和内置 Web 路由同一道 connection 信任围栏后面,只有本机已认证的页面能读。

路由契约:

GET /opencode-go/usage            → { ok: true, windows: { rolling, weekly, monthly }, fetchedAt }
GET /opencode-go/usage?force=1    → 同上,跳过缓存
命中缓存                          → 上一次的载荷 + { cached: true }(只需知道读数没变,不带新的 fetchedAt)
未配置 Key                        → { ok: false, code: "no-key", message }
Key 失效                          → { ok: false, code: "auth", message }
上游失败 / 超时 / 结构不认识      → { ok: false, code: "upstream" | "timeout" | "network" | "payload", message }

失败一律 200 + ok:false:对一个读数组件来说「这次没读到」是常态,不是 HTTP 错误层。 只有信任围栏(401/403)和方法(405,Allow: GET, HEAD)走 HTTP 语义。

一次读数的生命周期

  1. 客户端挂载时读一次;之后每 60 秒(POLL_MS)读一次,页面切到后台就跳过这一轮, 切回来时若距上次读已超过 60 秒则立刻补一次。
  2. 倒计时不靠网络刷新:客户端每 30 秒(TICK_MS)重算一次,所以「3 小时 39 分后重置」 会自己往下走。
  3. 宿主侧 20 秒内命中缓存直接回,不再打上游;?force=1 跳过缓存。
  4. 并发读合并:同一时刻多个轮询共用同一个上游请求(inflight),不会打成一串。
  5. 只有成功的读数进缓存:失败(超时、5xx、Key 失效)不缓存,下一次轮询就会重试, 不会让一次抖动把组件按在错误态整整 20 秒。

安装

1. 准备 OpenCode Go 的 Key

在 OpenCode Console 订阅 Go / Go Plus 并复制 API Key,然后写进 DSH 的凭据存储:


## 配置(可选)

`apply(ctx, config)` 认两个数字,都有默认值:

| 键 | 默认 | 含义 |
|---|---|---|
| `cacheMs` | `20000` | 同一读数在宿主缓存多久 |
| `timeoutMs` | `8000` | 上游请求预算,超时回 `code: "timeout"` |