OpenCode 配额标签Easy19613/dsh-opencode-go-quota

dsh-opencode-go-quota

用于 DeepSeek Harness Web UI 的 OpenCode Go (Zen Go) 配额显示。

一个双面 DSH 插件，可在对话会话头部直接显示你的 OpenCode Go 订阅配额：一个紧凑的 Go 92% 标签（剩余窗口中最小的那个），点击后展开为弹出层，显示滚动 / 每周 / 每月窗口、其已用/剩余百分比、重置时间以及手动刷新按钮。

Chip

功能特性

- 宿主端 — 在 DSH Web 服务器上注册 GET /opencode-go-quota。它通过 DSH 凭据接缝解析
OPENCODE_GO_API_KEY 凭据（绝不离开进程），代理官方 OpenCode 用量 API
（https://opencode.ai/zen/go/v1/usage），将响应负载规范化为配额窗口，并缓存结果 60 秒，
以免浏览器频繁冲击上游 API。
- 浏览器端 — 位于 conversation.session.header.actions 插槽中的标签。每 60 秒轮询一次，悬停时显示
工具提示，并提供一个弹出层，包含：
- 每个配额窗口：已用 % / 剩余 %（滚动、每周、每月），
- 每个窗口的重置时间，
- 手动刷新按钮（通过 ?refresh=1 绕过服务器缓存）。

工作原理

OpenCode 用量 API 按配额窗口返回用量：

{
"usage": {
"rolling": { "status": "ok", "percent": 17, "resetsAt": "2026-08-14T12:30:14.366Z" },
"weekly":  { "status": "ok", "percent": 7,  "resetsAt": "2026-08-17T00:00:00.366Z" },
"monthly": { "status": "ok", "percent": 3,  "resetsAt": "2026-09-13T14:00:14.366Z" }
}
}

宿主插件将每个窗口规范化为 { key, limit, used, remaining, unit, resetsAt, status }
（limit = 100，used = percent，remaining = 100 - percent），浏览器直接渲染这些数据。
一个通用提取器还会作为防御性回退，识别 limit/used/remaining 形式的对象。

路由响应

GET /opencode-go-quota →

{
"ok": true,
"fetchedAt": "2026-08-14T09:58:53.131Z",
"source": "https://opencode.ai/zen/go/v1/usage",
"windows": [
{ "key": "rolling", "limit": 100, "used": 17, "remaining": 83, "unit": "%", "resetsAt": "…", "status": "ok" }
],
"raw": { "usage": { … } }
}

错误：凭据缺失时返回 503 { "code": "NO_CREDENTIAL" }，当所有上游端点均不可达时返回 502。

安装

1. 将此包复制到你的 DSH 配置文件的 node_modules 中：

Copy-Item -Recurse .\dsh-opencode-go-quota "$env:USERPROFILE\.dsh\profiles\web\node_modules\"

2. 在配置文件的 cordis.patch.yml 中挂载它（参见 profile-cordis-patch.example.yml）：

- insert:
- id: opencode-go-quota
name: 'dsh-opencode-go-quota'

3. 重启 GUI（npx @deepseek-ai/dsh web）并强制刷新浏览器页面。该标签会出现在任意
对话的会话头部。

要求
- 通过 DSH 凭据服务（~/.dsh/.credentials.yaml）存储或作为环境变量导出的 OPENCODE_GO_API_KEY 凭据（一个 OpenCode Go API 密钥）。
- 对等依赖 @deepseek-ai/cordis 和 @deepseek-ai/dsh-credentials（已存在于 DSH profile 中）。

卸载

从 cordis.patch.yml 中删除 opencode-go-quota 条目（可选删除包目录），然后
重启 GUI。

开发

该包以纯 ESM + 手写浏览器 bundle（DSH 客户端插件使用的 window.__ModuleLoader__.load 契约）
的形式发布，因此无需构建步骤。

lib/index.js   host plugin: cordis name/inject/apply, route, upstream fetch, parsing, cache
lib/client.js  browser bundle: header chip + popover

通过启动一个隔离实例，在不影响正在运行的 GUI 的情况下，针对真实的 OpenCode 账户进行测试：

$env:DSH_HOME = ".\test-home"; $env:OPENCODE_GO_API_KEY = ""
npx @deepseek-ai/dsh web --port 3098

License

MIT © 2026 Easy19613

dsh-opencode-go-quota（中文说明）

为 DeepSeek Harness Web UI 添加 OpenCode Go (Zen Go) 订阅额度显示的双面插件。

在会话头部显示一个 Go 92% 额度芯片（取剩余比例最小的窗口），点击弹出详情：滚动 / 每周 / 每月三个额度窗口的
已用与剩余百分比、重置时间，以及手动刷新按钮；每 60 秒自动轮询。

功能

- 服务端：在 DSH webserver 注册 GET /opencode-go-quota 路由，通过 credentials 服务解析
OPENCODE_GO_API_KEY（密钥不出进程），代理官方用量 API https://opencode.ai/zen/go/v1/usage，
归一化为额度窗口并缓存 60 秒。
- 浏览器端：在 conversation.session.header.actions 槽位注册芯片，点击弹出各窗口已用/剩余百分比、
重置时间与刷新按钮。

安装

1. 将本包复制到 profile 的 node_modules：

Copy-Item -Recurse .\dsh-opencode-go-quota "$env:USERPROFILE\.dsh\profiles\web\node_modules\"

2. 在 cordis.patch.yml 中挂载（参考 profile-cordis-patch.example.yml）：

- insert:
- id: opencode-go-quota
name: 'dsh-opencode-go-quota'

3. 重启 GUI（npx @deepseek-ai/dsh web）并强制刷新浏览器页面，任意会话的头部即可看到芯片。

要求：配置好 OPENCODE_GO_API_KEY 凭据（~/.dsh/.credentials.yaml 或环境变量）。

卸载

从 cordis.patch.yml 删除 opencode-go-quota 条目（可选删除包目录），重启 GUI 即可。

License

MIT © 2026 Easy19613