前言¶

在 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 壳层渲染自动复位。

三窗口额度进度¶

卡片展示以下三个窗口的额度使用进度：

1. 日（近5小时）
2. 周
3. 月

每个窗口显示：

• 额度使用进度条
• 已用金额 / 配额
• 重置时间

额度进度条颜色随已用额度 0→100% 由绿渐变到红。

计费时段与刷新时间¶

卡片按北京时间显示 DS 高峰/低谷计费时段、24 小时色带与当前时刻标记，每 30 秒本地刷新。

卡片会显示刷新时间，并支持自动刷新间隔设置：

• 间隔范围：5–3600 秒
• 持久化位置：浏览器 localStorage
• 手动刷新：支持

API Key 读取¶

插件会自动从 DSH 凭据 OPENCODE_GO_API_KEY 读取 Key；失败时回退到环境变量与 OpenCode CLI auth.json。

Key 解析顺序：

1. DSH 凭据 OPENCODE_GO_API_KEY
2. 环境变量 OPENCODE_GO_API_KEY / OPENCODE_API_KEY
3. ~/.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