前言¶

opencode-usage 是一个 DSH bundle 插件。它把 OpenCode Go 的 rolling / weekly / monthly 额度使用率和重置时间放进 dsh Web UI 的 composer dock，让额度信息可以直接在会话界面中看到。

这是什么¶

opencode-usage 由 AmaTsumeAkira 维护，采用 MIT 许可证。它遵循 dsh bundle 格式，核心目标是在 dsh Web UI 中展示 OpenCode Go quota badge，包括三个额度窗口的使用率、重置倒计时、最近一次获取时间和刷新状态。

核心功能¶

• 在 composer dock 中以颜色百分比展示 rolling / weekly / monthly 三个额度窗口，并显示重置倒计时。
• 显示最近一次获取时间（updated M/D HH:mm），刷新时显示 updating…。
• 点击 OpenCode Go 标签可手动刷新额度。
• 每 5 分钟自动刷新。
• API key 仅在 harness 进程内通过 credentials service 解析，并通过环境变量传给 curl，不会序列化到浏览器或日志。

安装与启用¶

插件包是预构建 artifacts，lib/ 已提交到仓库，无 install scripts，因此 git 安装不需要 pnpm allowBuilds grant。

从 GitHub 安装：

dsh plugin --profile web add github:AmaTsumeAkira/opencode-usage

也可以从本地目录安装：

dsh plugin --profile web add ./opencode-usage

卸载插件：

dsh plugin --profile web remove opencode-usage

典型用法¶

插件需要配置 OPENCODE_GO_API_KEY。可以通过环境变量或 ~/.dsh/.credentials.yaml 提供：

# ~/.dsh/.credentials.yaml
OPENCODE_GO_API_KEY: your-opencode-go-api-key

配置完成后，composer dock 中的 OpenCode Go 徽章会展示额度信息。未配置 API key 时，徽章显示“获取失败”。

刷新方式有两条：

1、等待每 5 分钟自动刷新；
2、点击 OpenCode Go 标签手动刷新。

适用场景与注意¶

• 适合希望在 dsh Web UI 中直接查看 OpenCode Go 额度使用率、重置时间和刷新状态的使用者。
• 使用前必须配置 OPENCODE_GO_API_KEY。
• 该插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 插件通过 credentials service 解析 key，不会暴露到浏览器或日志；但仍应按环境要求管理凭据。

链接¶

GitHub：https://github.com/AmaTsumeAkira/opencode-usage