前言¶

在 DeepSeek Harness（DSH）里使用 OpenCode GO 套餐时，5 小时滚动、本周、本月三个额度窗口往往在官网或设置页才能看到。频繁切页面不适合写代码、跑智能体的节奏。社区插件 @skyrocks/dsh-go-quota（仓库 skyrocks/dsh-go-quota）把这三段用量放到对话输入框下方的 dock：标签、迷你进度条、百分比；悬浮可看重置倒计时，点击可立即刷新。下文按定位、功能、安装、配置与注意点说明用法。

这是什么¶

• 定位：DSH 客户端插件，包名 @skyrocks/dsh-go-quota，插件行 id 为 go-quota。
• 维护者：skyrocks（MIT 许可证；当前包版本 0.1.9，以 package.json 为准）。
• 目录页：skillhub.cn/plugins/skyrocks/dsh-go-quota（社区目录，与 DeepSeek / 幻方无官方从属关系）。
• 解决的问题：在 DSH 内只读展示 OpenCode GO 套餐用量，不必单独打开 OpenCode 站点；当前会话 provider 不是 opencode-go 时整条隐藏，避免干扰其它模型。

核心功能¶

下列能力均来自项目 README 与实现说明，已核实要点如下。

三窗口展示与交互¶

1. 常驻显示 5 小时 / 本周 / 本月 三个窗口：进度条表示已用比例，旁路百分比数字。
2. 阈值变色：已用 <80% 为绿（#6bd586），≥80% 琥珀，≥90% 红。
3. 悬浮展开详情与重置倒计时；点击（或 Enter / 空格）强制刷新；客户端约每 5 分钟自动 read()。
4. 挂载在槽位 conversation.composer.dock 的最后（上下文百分比之后）。

凭据与请求（Host 侧）¶

1. 只读当前 DSH 配置里的 opencode-go 凭据引用（经 settings.describe() 与 ctx.credentials.resolve()），不读 auth.json，不扫描无关环境变量；Key 仅在 Host 进程内用于请求，不进浏览器。
2. 默认请求 GET https://opencode.ai/zen/go/v1/usage，Authorization: Bearer <key>；Host 侧约 45 秒缓存，刷新会绕过缓存。
3. 零运行时依赖（README 标明 runtime deps 为 0）；纯 ESM + 浏览器 bundle，无原生模块。

环境与兼容¶

不支持 DSH 0.1.x；0.3.x 需 engines.dsh 放行且接口可能变化。

安装与启用¶

插件以当前 DSH 进程权限运行；安装前可在 GitHub 查看源码与 MIT 许可证。安装命令须使用资料原文，勿自行拼接错误形式。

图形界面（推荐）¶

1. 打开 DSH 桌面端，进入 设置 → 插件。
2. 点「添加插件」，在弹窗粘贴：

github:skyrocks/dsh-go-quota

3. 确认安装，等待依赖解析完成。
4. 完全退出 DSH 再重新打开（macOS Cmd+Q；Windows 从托盘退出）。只关窗口不够，Host 插件仅在启动时加载。
5. 在对话中选择 opencode-go 模型，输入框下方应出现 GO 5h … · 周 … · 月 …。

列表中显示 @skyrocks/dsh-go-quota（id go-quota）。若曾装过 0.1.8 及更早的 dsh-go-quota，需先移除旧包再装新包，避免同 id 冲突。

命令行（可选）¶

桌面版 profile 示例：

dsh plugin --profile desktop add github:skyrocks/dsh-go-quota

使用 dsh web 时将 --profile desktop 换成 --profile web。安装后同样需要完全退出并重启 DSH。

其它来源（tarball、本地绝对路径目录）见仓库 README「其他安装来源」；Windows 目录安装宜用 file:C:\... 或 tarball，避免 link: 盘符问题。

配置（可选）¶

包内 cordis.patch.yml 自带默认值，一般无需修改。覆盖时在用户层写入同 id 配置，例如桌面 profile：

路径：~/.dsh/profiles/desktop/cordis.patch.yml

- id: go-quota
  config:
    baseUrl: https://opencode.ai/zen/go/v1/usage
    timeoutMs: 15000   # 单次请求超时（毫秒）
    cacheMs: 45000     # Host 侧缓存（毫秒）；点击刷新会绕过

修改后需重启 DSH。

典型用法¶

1. 在 DSH 中配置好 OpenCode GO 的 apiKeyEnv（「设置 → 模型」或 llm-pi-ai 的 providers["opencode-go"]）。
2. 安装插件并重启后，选用 opencode-go 模型开始对话。
3. 看输入框下方三条进度：快速判断本周 / 本月是否接近上限；临近 80% / 90% 时颜色会变琥珀 / 红。
4. 需要最新数据时点击 dock 区域刷新，不必等 5 分钟轮询。

常见错误提示与处理（如「GO 未配置」「401」「403」）见仓库 README「常见问题」表。

适用场景与注意¶

适合谁：长期用 DSH + OpenCode GO、希望在写 prompt 时一眼看到三窗口额度的开发者。

务必注意：

• 插件请求出站用量接口，Key 解析依赖你本地的 DSH 配置与凭据存储；安装前应自行审阅 GitHub 仓库 源码。
• 官方接口主要返回账户级百分比，无按模型 / 设备明细；界面只显示百分比，不显示剩余金额，避免误读名义套餐价。
• 用量接口未公开稳定文档，可能变更；若 baseUrl 或字段变化，可改配置或向维护者提 issue。
• DSH 生态理念是「一切皆插件」；本插件与 DeepSeek、OpenCode 均无隶属关系。

结尾¶

dsh-go-quota 把 OpenCode GO 的 5 小时 / 周 / 月额度收到输入框下方，只在对 opencode-go 会话时显示，并尽量把 Key 留在 Host。需要安装指引与架构图时，以仓库 README 为准。

• 目录页：https://www.skillhub.cn/plugins/skyrocks/dsh-go-quota
• GitHub：https://github.com/skyrocks/dsh-go-quota