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

---

English