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)
同名包的其他仓库
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 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"` |