前言¶

DSH 的插件机制支持把辅助能力挂到已有 profile 上，理念偏向「一切皆插件」。对于使用 OpenCode Go 的开发者来说，配额窗口和重置时间通常只在控制台可见，在 DSH 的 Web 界面里频繁切换查看不够顺手。

@xueayi/dsh-opencode-go-usage 是为 DeepSeek Harness（DSH）编写的 DSH 插件，用来在 Web GUI 中显示一个 floating dock，展示 5h-rolling / weekly / monthly quota windows 和 live reset countdowns。

这是什么¶

下面先交代这个插件的定位：

• 插件名：@xueayi/dsh-opencode-go-usage
• 维护者：xueayi
• 许可证：MIT
• package.json 声明版本：0.1.6
• Node 引擎：^22.19.0 || >=24
• 用途：OpenCode Go plan usage monitor for DeepSeek Harness

它通过官方 quota API 获取数据，在 DSH 的 Web GUI 中提供一个 floating dock，用于查看 5h-rolling / weekly / monthly quota windows、剩余配额、重置倒计时和刷新状态。

核心功能¶

这个插件主要解决「在 Web GUI 中快速查看 OpenCode Go 配额」的问题。已核实的能力如下：

1. 在 Web GUI 中显示 floating dock。
2. 展示 5h-rolling / weekly / monthly quota windows。
3. 显示 live reset countdowns。
4. 支持 collapsed badge 与 expandable panel。
5. 支持拖动 badge，位置保存在 localStorage。
6. 提供 minimal mode（极简模式）。
7. 刷新失败时保留最后一次成功数据并提示。
8. 不暴露 model-facing surface，不添加 prompt text 或 tool schema。

数据来源是官方 quota API：

GET https://opencode.ai/zen/go/v1/usage

该请求使用 Bearer API key，不需要 workspace id 或 cookie。

安装与启用¶

安装目标是 DSH 的 Web profile。先执行安装命令：

dsh plugin --profile web add @xueayi/dsh-opencode-go-usage

安装后重启 profile。浏览器界面通常重启：

dsh web

后续升级到最新已发布版本时，可以使用：

dsh plugin --profile web update @xueayi/dsh-opencode-go-usage

典型用法¶

推荐在 DSH 的 Web 配置中完成 provider 选择：

1. 打开 Web Settings → Models。
2. 选择 official-channel OpenCode Go provider。
3. 填入 API key。

API key 也可以通过以下位置提供：

• ~/.dsh/.credentials.yaml
• environment variable OPENCODE_GO_API_KEY

已核实的配置示例如下：

- insert:
    - id: opencode-go-usage
      name: '@xueayi/dsh-opencode-go-usage'
      config:
        apiKeyEnv: OPENCODE_GO_API_KEY
        refreshMs: 60000

这里：

• apiKeyEnv：凭据引用，默认指向 OPENCODE_GO_API_KEY
• refreshMs：自动刷新间隔

适用场景与注意¶

这个插件适合需要在 DSH Web GUI 中持续观察 OpenCode Go 配额的开发者。它不进入模型请求路径，不添加 prompt text 或 tool schema，也没有模型请求、token 注入或 KV Cache 影响。

使用前需要注意：

1. 需要 OpenCode Go API key。
2. 单账户使用，限制为 one API key per profile。
3. Poll latency：collapsed badge polls every 60s，open panel every 10s。
4. 刷新失败后保留最后一次成功数据，数据可能变旧。
5. 拖动位置没有 safe-area compensation。
6. 插件以当前 dsh 进程权限运行；安装前应检查源码与 MIT 许可证。

结尾¶

@xueayi/dsh-opencode-go-usage 的价值比较集中：把 OpenCode Go 的 5h-rolling / weekly / monthly quota windows 和 reset countdowns 放进 DSH Web GUI，减少为了查看配额而离开当前界面的成本。

相关链接：

• GitHub：https://github.com/xueayi/dsh-opencode-go-usage
• 社区目录页：已核实资料未提供可核验 URL；DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，可在目录站点按插件名检索。