用量胶囊 JaMoLpE88/dsh-opencodego-usage

dsh-opencodego-usage

dsh-plugin.org

在 DeepSeek Harness 的输入框里查看 OpenCode Go 订阅用量。 5 小时、每周、每月三个窗口显示成一个小胶囊，夹在权限控件和模型控件之间；点一下弹出 DSH 风格的详情对话框，里面有重置倒计时、颜色和手动刷新。

零配置。插件直接用 DSH 已经存好的 OpenCode Go 服务商密钥——不用 cookie，不用 workspace ID，也没有设置页。

Español → README.es.md

项目主页 → jmolo.es/proyectos/dsh-opencodego-usage

OpenCode Go 用量详情窗口浮在 DeepSeek Harness 输入框上方

详情窗口：每个窗口一个百分比、一条细进度条、一个本地重置倒计时，后面跟着最后更新时间、自动刷新频率、数据来源和一个手动刷新按钮。聊天背景做了模糊处理，保护隐私。

DeepSeek Harness 输入框里的 OpenCode Go 用量胶囊

紧凑胶囊：OpenCode 标志加三个上下文风格的圆环，中间用 · 隔开。它位于权限控件和模型选择器之间，只在选用 OpenCode Go 模型时显示。

功能

- 用一个紧凑胶囊显示 OpenCode Go 的三个窗口：5 小时、每周、每月。
- 圆环样式和 DSH 自带的上下文计量器一致，窗口之间用 · 分隔。
- 圆环和进度条按严重程度着色：低于 50 % 为绿色，50 % 到 74 % 为琥珀色，75 % 到 100 % 为红色（被限流的窗口始终为红色）。
- 点击打开原生风格的详情对话框：百分比、细进度条、重置倒计时、本地重置时间、最后更新时间、自动刷新频率、数据来源，以及一个 Refresh 按钮。
- 对话框打开时每秒倒计时。重置倒计时归零后自动重新读取一次，窗口无需你操作就会重置。
- 每 60 秒刷新一次百分比，应用窗口重新可见时也会刷新。
- 只在当前模型属于 opencode-go 服务商时显示。其他服务商什么都不显示。
- 无需任何设置：DSH 已有的服务商密钥就是唯一凭据。

它不做什么

- 不读取 OpenCode 控制台 cookie，也不抓取 HTML。
- 不索要密钥，也不在插件里存密钥。
- 不保留用量历史、遥测数据或本地存储。
- 不添加工具、命令，也不改动智能体。
- 当前模型不来自 OpenCode Go 时，什么都不显示。

为什么没有设置

只要选中 OpenCode Go 的模型，服务商就已配置好，密钥也已经在 DSH 手里。插件在 Host 侧解析这把密钥，读取官方用量 API。没选中 OpenCode Go 的模型时，插件没有可展示的内容，就什么都不渲染。

没有插件配置文件，没有密钥输入框，没有阈值编辑器，也没有刷新偏好。就这样：服务商本来就知道的订阅数据。

环境要求

- DSH Desktop >= 0.2.1-rc.3，配置档 desktop（已在 0.2.1-rc.3、Windows 11 上测试）。
- 在 Settings → Models 里配置好 OpenCode Go 服务商，并填入有效 API 密钥。
- Node 22+（DSH 自带运行时）。

服务商没配置，就选不到它的模型，插件也就永远不会出现。这是有意为之。

安装

从 npm 安装：

dsh plugin --profile desktop add @jamolpe88/dsh-opencodego-usage

从仓库安装：

dsh plugin --profile desktop add github:JaMoLpE88/dsh-opencodego-usage

开发时从本地检出安装：

dsh plugin --profile desktop add C:\path\to\dsh-opencodego-usage

安装后刷新 DSH 窗口。只要会话的当前模型使用 opencode-go 服务商，输入区就会出现胶囊按钮。

用法

1. 从 OpenCode Go 服务商选一个模型。
2. 胶囊按钮出现在输入区一行正中，位于权限控件和模型选择器之间。
3. 点它打开详情对话框。
4. 点 Refresh 立即读取；否则插件每 60 秒刷新一次，窗口重新可见时刷新一次，对话框打开期间某个重置倒计时归零时也会自动刷新。

点对话框外面、按 Escape，或再点一次胶囊按钮，都能关闭。重置时间按浏览器本地时区显示，倒计时每秒自动更新，无需任何操作。

工作原理

Host 侧用服务商密钥调用 OpenCode Go 官方端点：

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <OPENCODE_GO_API_KEY>

返回三个窗口：

{
"usage": {
"rolling": { "status": "ok", "percent": 4, "resetsAt": "2026-10-25T13:31:58.000Z" },
"weekly": { "status": "ok", "percent": 24, "resetsAt": "2026-10-26T00:00:00.000Z" },
"monthly": { "status": "ok", "percent": 12, "resetsAt": "2026-11-07T14:35:16.000Z" }
}
}
- 每次读取时，密钥都从 DSH 的凭据服务（OPENCODE_GO_API_KEY）解析；进程环境变量里的 OPENCODE_GO_API_KEY 是后备。
- 结果缓存 55 秒，因此 60 秒轮询和多个窗口共用同一次上游请求。
- 上游失败时保留最后一次已知的百分比，并标记为 stale，而不是把胶囊清空。
- 浏览器端读取两个同源路由：/api/opencodego-usage 和 /api/opencodego-usage/refresh。密钥永远不会到达浏览器。
- 可见性使用实时的 modelSelection 投影。切换到其他服务商时胶囊立即隐藏；切回来时再次显示。
- 客户端用浏览器的区域设置和时区格式化重置时间戳，对话框打开期间每秒重新渲染倒计时，倒计时归零时强制重新读取（带保护，避免一次重置引发刷新循环）。

诊断

DSH 运行时，在与界面相同的 URL 上（每次启动端口都会变）：

curl http://127.0.0.1:59863/api/opencodego-usage

返回百分比、重置时间戳、错误码和新鲜度标志——绝不返回密钥：

{
"updatedAt": 1793016001120,
"windows": {
"rolling": { "percent": 4, "resetsAt": 1793025060000, "status": "ok" },
"weekly": { "percent": 24, "resetsAt": 1793059200000, "status": "ok" },
"monthly": { "percent": 12, "resetsAt": 1794062116000, "status": "ok" }
},
"error": null,
"stale": false
}

用 /api/opencodego-usage/refresh 跳过 55 秒缓存，强制读取。当 error 不为 null 时，stale 告诉你这些百分比是最后一次正常值，还是根本没有值。

兼容性

| DSH | >= 0.2.1-rc.3（作者唯一测试过的版本） |
| Node | >= 22 |
| OS | Windows 11（已测试）；macOS 和 Linux 未测试 |
| 配置档 | desktop |
| 服务商 | 在 Settings → Models 中配置 OpenCode Go |
| 目录 | listed on dsh-plugin.org |
| 项目页 | jmolo.es/proyectos/dsh-opencodego-usage |

验证状态：在 Windows 11 上用 DSH Desktop 0.2.1-rc.3 测试过（2026-10-25）。只有使用 OpenCode Go 模型时胶囊才出现，详情对话框能打开，本地重置时间和倒计时会更新，严重程度颜色跟随阈值，手动刷新可用。重置时的自动刷新用一次性保护实现；它由倒计时路径覆盖，但本次验证中没有在实时重置时观察到。

未验证：macOS、Linux、其他 DSH 版本，以及 web 配置档。

限制

- Windows 11 是唯一测试过的平台。 macOS 和 Linux 未验证。
- 仅限 OpenCode Go。 没有该服务商就没有有用的数据，因此插件不渲染任何内容。
- 没有设置。 没有阈值编辑器、刷新间隔、显示/隐藏偏好或密钥输入。
- 不保留历史记录或图表。 只显示当前窗口及其重置时间。
- 依赖 OpenCode 端点。 如果端点结构发生变化，无法识别的窗口会被丢弃，胶囊会报告 parse 错误。
- 不改变智能体。 不添加工具、命令或模型服务商。

隐私

- 不使用 cookie，不抓取浏览器会话，不获取工作区 ID。
- API 密钥始终留在 Host 进程内：浏览器只收到百分比和重置时间戳。
- 没有配置文件，没有本地存储，没有遥测，除官方用量端点外不发起任何第三方请求。
- Host 不记录密钥，也不把密钥写进错误消息。
- 上面的截图来自真实会话，为保护隐私已对聊天背景做模糊处理。

简短政策见 SECURITY.md。

故障排查

胶囊没有出现。 检查当前模型是否属于 OpenCode Go 服务商。对其他服务商，插件有意不渲染任何内容。

胶囊显示红点和错误。 打开对话框查看错误码和提示：

| 错误码 | 含义 |
| missing-key | DSH 在当前配置档下没有 OPENCODE_GO_API_KEY。请在 Settings → Models 中配置 OpenCode Go 服务商。 |
| invalid-key | 服务商密钥被拒绝（401）。请在 Settings → Models 中重新检查或更换。 |
| no-subscription | 该密钥没有有效的 OpenCode Go 订阅（403）。 |
| rate-limited | 用量 API 自身触发了限流，请稍后重试。 |
| timeout / network | Host 无法访问 opencode.ai，请用 Refresh 重试。 |
| parse | 响应中没有可识别的窗口。 |

插件本身没有设置项：服务商问题请在 DSH 的模型设置中解决。

开发

npm test # node --test
npm run check # syntax check for the Host and Client files

测试覆盖 API 解析器、HTTP 错误映射、缓存、缺少密钥的路径以及过期数据回退。Client 部分是普通的 client.js 打包文件（无构建步骤），在运行中的 Harness 里验证。

本地安装：

dsh plugin --profile desktop add C:\path\to\dsh-opencodego-usage

第三方标识

OpenCode 和 OpenCode 徽标是各自所有者的商标。徽标仅用于标识 OpenCode Go 服务，不在适用于源代码的 MIT 许可证覆盖范围内。见 NOTICE。

许可证

MIT © 2026 JaMoLpE88