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)
Other repositories with this package name
Install
This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗
README
Read the full README ↗dsh-opencode-go-usage
一个 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 的细条、文字裁掉半截:

修法是让这一行退出收缩(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 语义。
一次读数的生命周期
- 客户端挂载时读一次;之后每 60 秒(
POLL_MS)读一次,页面切到后台就跳过这一轮, 切回来时若距上次读已超过 60 秒则立刻补一次。 - 倒计时不靠网络刷新:客户端每 30 秒(
TICK_MS)重算一次,所以「3 小时 39 分后重置」 会自己往下走。 - 宿主侧 20 秒内命中缓存直接回,不再打上游;
?force=1跳过缓存。 - 并发读合并:同一时刻多个轮询共用同一个上游请求(
inflight),不会打成一串。 - 只有成功的读数进缓存:失败(超时、5xx、Key 失效)不缓存,下一次轮询就会重试, 不会让一次抖动把组件按在错误态整整 20 秒。
安装
1. 准备 OpenCode Go 的 Key
在 OpenCode Console 订阅 Go / Go Plus 并复制 API Key,然后写进 DSH 的凭据存储:
## 配置(可选)
`apply(ctx, config)` 认两个数字,都有默认值:
| 键 | 默认 | 含义 |
|---|---|---|
| `cacheMs` | `20000` | 同一读数在宿主缓存多久 |
| `timeoutMs` | `8000` | 上游请求预算,超时回 `code: "timeout"` |