前言¶
在 DSH Web GUI 中使用 OpenCode Go 时，额度窗口、已用金额、重置时间和刷新状态通常不在当前界面直接呈现。dsh-opencodego-quota 是一个 DSH Web GUI 插件，把 OpenCode Go 的额度信息放在左侧栏常驻卡片中，减少来回切换查看的成本。
下面介绍它的功能、安装方式、典型用法和需要注意的限制。
这是什么¶
wellcover/dsh-opencodego-quota 是 DSH Web GUI 的 OpenCode Go 额度用量插件。它在左侧栏展示日（近5小时）、周、月三个窗口的额度进度、已用金额、配额、重置时间，并显示刷新时间。
该插件由 wellcover 维护，许可证为 MIT。package.json 声明 version 1.0.5，engines.node >=18。
数据来自 OpenCode 官方用量接口，非本地估算：
GET https://opencode.ai/zen/go/v1/usage
核心功能¶
左侧栏常驻卡片¶
插件在 DSH Web GUI 左侧栏展示常驻卡片。窄栏（图标栏）模式下会自动隐藏；侧栏宽度小于 110px 时，卡片也会自动隐藏。
卡片会跟随 DSH 壳层渲染自动复位。
三窗口额度进度¶
卡片展示以下三个窗口的额度使用进度：
- 日（近5小时）
- 周
- 月
每个窗口显示：
- 额度使用进度条
- 已用金额 / 配额
- 重置时间
额度进度条颜色随已用额度 0→100% 由绿渐变到红。
计费时段与刷新时间¶
卡片按北京时间显示 DS 高峰/低谷计费时段、24 小时色带与当前时刻标记，每 30 秒本地刷新。
卡片会显示刷新时间，并支持自动刷新间隔设置：
- 间隔范围：
5–3600秒 - 持久化位置：浏览器
localStorage - 手动刷新：支持
API Key 读取¶
插件会自动从 DSH 凭据 OPENCODE_GO_API_KEY 读取 Key；失败时回退到环境变量与 OpenCode CLI auth.json。
Key 解析顺序：
- DSH 凭据
OPENCODE_GO_API_KEY - 环境变量
OPENCODE_GO_API_KEY/OPENCODE_API_KEY ~/.local/share/opencode/auth.json
Key 仅经 HTTPS 发给 OpenCode 官方接口，使用 Authorization: Bearer 与 x-api-key。
安装与启用¶
先确认 DSH 环境中已有 web profile，并能在「设置 → 模型」中选择 opencode-go 提供商。
然后运行：
dsh plugin --profile web add github:wellcover/dsh-opencodego-quota
无需额外配置。安装后应能在左侧栏看到卡片；如果卡片不出现，需确认 profile package.json 的 dsh.profile.bundles 含 dsh-opencodego-quota，并重启后刷新页面。
典型用法¶
下面是一个可复现的使用流程。
1、安装插件：
dsh plugin --profile web add github:wellcover/dsh-opencodego-quota
2、确认已配置 OpenCode Go API Key，并能在「设置 → 模型」中选择 opencode-go 提供商。
3、打开 DSH Web GUI，查看左侧栏卡片中的日（近5小时）、周、月额度进度、已用金额、配额和重置时间。
4、如需调整自动刷新间隔，点击标题栏 ⚙ 或卡片底部秒数，输入 5–3600 秒，回车或保存生效。
5、如需立即更新数据，点击 ⟳ 按钮手动刷新额度数据。
适用场景与注意¶
适合在 DSH Web GUI 中使用 OpenCode Go 的开发者。安装前建议检查源码与 MIT 许可证；插件以当前 dsh 进程权限运行。
注意：
- 卡片只在宽栏下展示；侧栏宽度小于
110px的窄栏图标模式会自动隐藏。 - 自动刷新间隔为
5–3600秒，持久化到浏览器localStorage。 - Key 解析依赖
OPENCODE_GO_API_KEY、OPENCODE_API_KEY或~/.local/share/opencode/auth.json配置。 - 若卡片不出现，需确认 profile
package.json的dsh.profile.bundles含dsh-opencodego-quota，并重启后刷新页面。
相关链接¶
GitHub：
https://github.com/wellcover/dsh-opencodego-quota
目录页线索：
https://www.skillhub.cn/plugins/wellcover/dsh-opencodego-quota
