OpenCode Go 额度 tatudrag0n/dsh-opencode-go-quota

OpenCode Go Quota — DSH Web 插件

这个插件把 OpenCode Go（月费套餐）的剩余额度常驻显示在 DeepSeek Harness 的 Web UI 输入框里。

能做什么

- 在输入框左侧的 chip 上显示当前最紧张的那档额度剩余百分比（例如 週 72%）
- 点击展开详情浮层：5 小时 / 周 / 月 的剩余百分比、已用百分比、重置时间
- 每 60 秒自动刷新（浮层里的「更新」也能立即刷新）
- 剩余量变化时颜色从绿 → 黄 → 红
- 支持日语 / 英语（跟随 DSH 的 locale）
- 获取失败时显示错误，同时把上一次的值保留为「上次获取的值」

工作原理

┌─ Browser ─────────────────────────────┐
│ client.js … チップ + ポップオーバー │ │ │ fetch("api/opencode-go.quota") │ 認証付き・同一オリジン └──────┼────────────────────────────────┘ ▼ ┌─ DSH Host ────────────────────────────┐ │ index.js … /api/opencode-go.quota │ │ │ 資格情報ストアから鍵を都度解決 │ └──────┼────────────────────────────────┘ ▼ GET https://opencode.ai/zen/go/v1/usage
{"usage":{"rolling":{"percent":14,…}, "weekly":{…}, "monthly":{…}}}

- 上游返回的是使用率（percent），插件这边转换成剩余百分比再显示。
- API 密钥只在 Host 侧处理，完全不会传到浏览器。
- 每次请求都从凭据存储里解析密钥，所以轮换密钥后不用重启。

环境要求

- DeepSeek Harness 的 Web 配置档（需要 connection 服务）
- OpenCode Go / Go Plus 的 API 密钥（oc_sk_...）

安装

plugin_manager install_bundle target: /path/to/dsh-opencode-go-quota

手动安装的话，在配置档的 cordis.patch.yml 里加上下面这段。

- insert:
- id: opencode-go-quota
name: '@local/dsh-opencode-go-quota'

API 密钥请设置到 DSH 的凭据存储（$DSH_HOME/.credentials.yaml 的 refs），或者环境变量 OPENCODE_GO_API_KEY。如果你已经在设置界面里连上了 Zen/Go，那个值会直接拿来用。

配置

在 cordis.patch.yml 对应行里加 config 就能改（全部可选）。

| 键 | 默认值 | 说明 |
| apiKeyEnv | OPENCODE_GO_API_KEY | 要解析的凭据引用名 |
| baseUrl | https://opencode.ai | 上游 origin |
| refreshSeconds | 45 | 上游响应的缓存秒数 |
| timeoutMs | 15000 | 上游请求超时 |

- id: opencode-go-quota
name: '@local/dsh-opencode-go-quota'
config:
refreshSeconds: 120

文件结构

| 文件 | 作用 |
| index.js | Host 那一半。注册带认证的路由并请求上游 |
| client.js | Client 那一半。渲染 chip 和浮层 |
| cordis.patch.yml | bundle 的行定义 |
| package.json | 清单（dsh.bundle / dsh.client） |
| locale/{en,ja}.json | 给 Plugin Manager 显示的显示名和说明 |
| icon.svg | 插件图标 |
| test/smoke.mjs | Host 那一半的冒烟测试（不需要依赖包） |

测试

node test/smoke.mjs

凭据存储里有密钥的话会一路验到真实 API（没有的话只验证「无密钥」时的行为）。不需要网络的路径（路由注册、无密钥响应）每次都会验证。

注意

- https://opencode.ai/zen/go/v1/usage 是官方文档里没有写的端点。可能随时变更或废弃。
- 这里引用的 DSH 内部 API（ctx.connection.fetch / 槽位 conversation.input.left / 主题 token）可能随 Harness 版本变化。

License

MIT — 请参阅 LICENSE。

A DeepSeek Harness Web plugin that shows the remaining OpenCode Go allowance (5-hour, weekly, monthly) as a compact chip in the conversation composer toolbar.
剩余百分比来自 GET https://opencode.ai/zen/go/v1/usage（未公开文档），由 Host 侧通过一条带鉴权的同源路由拉取。API key 留在 Host 上，浏览器永远拿不到。状态条显示最紧张的那个窗口，展开后弹出浮层，列出全部三个窗口及其重置时间。日语和英语都支持，走 DSH 的 locale 服务。

安装时用 plugin_manager install_bundle 指向这个目录，再用 apiKeyEnv 配置凭据引用（默认 OPENCODE_GO_API_KEY）。