前言¶

在使用 DeepSeek Harness (DSH) 进行开发时，如果调用的模型属于 OpenCode Go 套餐，需要随时掌握额度消耗情况。手动切换或打开网页查看效率较低。dsh-plugin-opencode-go-quota 插件在 DSH Web 界面右下角增加了一个悬浮窗，用于实时展示当前 OpenCode Go 套餐的剩余额度。

核心功能¶

该插件提供以下功能：

• 悬浮窗展示：在 Web 界面右下角显示圆形悬浮按钮，点击展开弹窗。按钮支持鼠标拖动。
• 多周期额度：展示 5 小时滚动、每周、每月三个周期的额度（百分比、限额、重置时间）。
• 自动刷新：弹窗打开期间每 5 分钟自动刷新数据。
• 智能显隐：仅当当前会话选中的模型属于 opencode go 系 provider 时显示按钮，切换到其他模型自动隐藏。
• 模型适配：按当前所选模型显示限额，支持调价后高价模型的限额调整。
• 多账号支持：支持配置多个 opencode go 账号，自动对应各自的 API key 与额度。

安装与启用¶

使用官方 CLI 安装插件包，并在配置文件中注册。

dsh plugin --profile web add github:haipisao/dsh-plugin-opencode-go-quota

在 ~/.dsh/profiles/web/cordis.patch.yml 追加注册行：

- insert:
    - id: opencode-go-quota
      name: dsh-plugin-opencode-go-quota
      config:
        timeoutMs: 15000
        visibleProviders: [opencode-go, opencode-go-2]
        providers:
          opencode-go:
            usageUrl: https://opencode.ai/zen/go/v1/usage
            keyRef: OPENCODE_GO_API_KEY
          opencode-go-2:
            usageUrl: https://opencode.ai/zen/go/v1/usage
            keyRef: OPENCODE_GO_API_KEY_2

配置与使用¶

1. 在 DSH 设置 → 模型中配置 API key（如 OPENCODE_GO_API_KEY）。
2. 将会话模型切换到 opencode go 系模型（如 opencode-go/deepseek-v4-flash）。
3. 右下角出现悬浮按钮，点击展开查看额度。
4. 切换到其他模型（如 deepseek-official），按钮自动隐藏。

注意事项¶

• 首次安装新 bundle 后若 HMR 未生效，需重启一次 dsh web。
• 未显式配置 keyRef 时，host 会回退读 OpenCode CLI 的 auth.json（按平台探测路径）。
• 依赖、bundle 清单、node_modules 与注册行全部清除后，重启实例无任何残留。
• 目前暂缓 dsh 相关插件的开发与更新。

参考资源¶

• GitHub：https://github.com/haipisao/dsh-plugin-opencode-go-quota
• 插件目录：https://www.skillhub.cn/plugins/haipisao/dsh-plugin-opencode-go-quota