dsh-opencode-go-usage
一个 DeepSeek Harness Web 插件：在聊天输入框的上下文状态区域旁边显示 OpenCode Go 套餐额度。
- 鼠标悬停图标：显示 5 小时滚动额度剩余，并开始自动查询（受 15 秒自动刷新间隔限制）
- 点击图标：展开面板，显示 5h / 每周 / 每月额度的剩余、已用百分比和重置时间
- 只在当前会话选择的模型提供商是
opencode-go时显示图标 - 缓存最后一次成功查询：再次打开时立即显示缓存结果和查询时间，随后后台静默刷新
- 查询进行中时，悬停提示会显示
刷新中…；此时点击展开不会重复发起查询 - 自动查询间隔为 15 秒：15 秒内不会重复自动查询，但手动点击“刷新”始终会查询
截图
安装并重启 dsh web 后，打开一个使用 opencode-go 的会话，输入框右侧会 出现一个小图标。点击后弹出：
OpenCode Go 额度
5h 剩余 85%
周 剩余 71%
月 剩余 93%
上次查询: 14:32:08 · 刷新中…安装
从 GitHub 安装（推荐）
dsh plugin --profile web add github:GarfieldGCat/dsh-opencode-go-usage安装完成后重启：
dsh web建议使用 tag 固定版本：
dsh plugin --profile web add github:GarfieldGCat/dsh-opencode-go-usage#v0.1.2配置
插件行可以通过 web profile 的 cordis.patch.yml 覆盖配置：
- id: opencode-go-usage
name: dsh-opencode-go-usage
config:
baseUrl: https://opencode.ai/zen/go/v1/usage
timeoutMs: 15000
providerId: opencode-go| 配置项 | 默认值 | 说明 |
|---|---|---|
baseUrl | https://opencode.ai/zen/go/v1/usage | OpenCode Go 用量接口 |
timeoutMs | 15000 | 查询超时时间（毫秒） |
providerId | opencode-go | 需要匹配的模型提供商 id |
API Key 解析顺序
1. DSH credentials seam / 环境变量 OPENCODE_GO_API_KEY 2. ~/.local/share/opencode/auth.json 中的 opencode-go 条目 （找不到时回退到 opencode），且 type 为 api
工作原理
用量接口
GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <API_KEY>返回示例：
{
"usage": {
"rolling": { "status": "ok", "percent": 9, "resetsAt": "..." },
"weekly": { "status": "ok", "percent": 12, "resetsAt": "..." },
"monthly": { "status": "ok", "percent": 6, "resetsAt": "..." }
}
}接口返回的是已用百分比，插件显示 剩余 = 100 - percent。
插件结构
| 文件 | 作用 |
|---|---|
index.js | Host 端：提供 opencodeUsage Remote 服务，读取 API Key 并查询用量 |
typert.host.js | Typert Host manifest |
client.js | Web 端：在 conversation.input.right 注册图标和弹出面板 |
cordis.patch.yml | Bundle patch，自动挂载 Host 插件行 |
package.json | dsh.bundle + dsh.client 双端声明 |
显示条件
Web 端通过 modelDirectories 读取当前会话实际选择的 provider：
- 当前 provider 为
opencode-go：显示图标 - 当前 provider 不是
opencode-go：不显示图标
已知限制
- 用量接口尚未写入 OpenCode 公开文档，未来可能变更。
- 接口只返回使用百分比，不返回金额；插件展示百分比和重置时间。
- 缓存是全局缓存：同一个 OpenCode Go 账号在不同会话中的额度查询结果一致。
License
MIT
---