前言¶

在 DeepSeek Harness（DSH）里用 OpenCode Go 订阅模型时，额度往往要另开页面或靠记忆估算。官方底栏已有「上下文窗口」指示器，但不会在同一个位置告诉你 Rolling / Weekly / Monthly 各窗口用了多少。dsh-opencode-go-quota 是维护者 tiamo-Li 提供的客户端小插件：在会话输入框下方、上下文环右侧插入一枚与原生同风格的额度指示器，只在当前会话属于 Go 订阅 provider 时显示。

下面按定位、能力、安装配置与注意事项说明如何用上它。

这是什么¶

dsh-opencode-go-quota 面向已安装 DSH、并配置了 OpenCode Go API Key 的用户。Host 侧用凭据请求官方额度接口，浏览器只收到百分比与重置时间，不在前端暴露 Key。插件分类为客户端，当前 GitHub 星标为 0；许可证为 MIT（© 2026 tiamo-Li）。与 OpenCode / DeepSeek 官方无隶属关系，仅调用用户自己账号的额度接口。

核心功能¶

指示器挂在 conversation.composer.dock 统计条里，位于「上下文窗口」百分比环的右侧：

1. 按 provider 显隐：仅当当前会话模型属于 OpenCode Go 订阅（默认 provider 为 opencode-go 或 dsh-opencode-go）时显示；切换到其它 provider 自动隐藏。
2. 折叠态：显示 Go 标签、迷你进度条，以及 5 小时滚动（Rolling） 窗口的已用百分比；加载中或不可用时显示 —。
3. 展开态：鼠标悬停、键盘聚焦或点击固定后，浮层列出 Rolling / Weekly / Monthly：各列含周期、用量（48px 进度条 + 百分比）、刷新时间；英文紧凑格式如 Resets in 4h 54m。
4. 视觉与隐私：沿用 DSH 主题 token、字号、圆角与浮层阴影，跟随明暗主题；Key 仅在 Host 使用，浏览器侧不持有 Key。

若你同时使用 Duskriver/dsh-opencode-go 配置 API Key，README 建议：在 DSH 官方模型配置（llm-pi-ai → opencode-go）同样添加该 Key（本插件读取官方凭据名 OPENCODE_GO_API_KEY）；并可在官方模型配置处取消 Go 订阅的全部可用模型、在该插件设置里关闭「用量悬浮球」，以避免重复路由与重复显示用量。

安装与启用¶

前置条件：DSH 0.2.2 及以上（桌面端已验证 0.2.2-rc.1），并已配置 OpenCode Go 的 API Key（DSH 凭据默认名 OPENCODE_GO_API_KEY）。

方式 A：插件页（推荐）¶

1. 打开 DSH → 插件 → 添加插件。
2. 填入仓库地址：https://github.com/tiamo-Li/dsh-opencode-go-quota
3. 安装完成后点击 立即启用；若未开 HMR，刷新页面或重启 DSH。

方式 B：命令行¶

任选一种 spec 安装（desktop profile 示例）：

dsh plugin --profile desktop add github:tiamo-Li/dsh-opencode-go-quota
dsh plugin --profile desktop add https://github.com/tiamo-Li/dsh-opencode-go-quota

安装后到 插件 页启用组合包，或在 profile 的 cordis.patch.yml 中启用。

API Key¶

插件默认读取凭据引用 OPENCODE_GO_API_KEY（与 DSH 原生 pi-ai 的 opencode-go 路由一致）：

• 已用原生 opencode-go provider 的用户一般无需额外配置；
• 否则在 DSH 凭据设置中保存该名，或使用环境变量 OPENCODE_GO_API_KEY=...。

配置¶

默认项来自包内 cordis.patch.yml，可在 profile 的 cordis.patch.yml 中按 id: opencode-go-quota 覆盖：

示例：

- id: opencode-go-quota
  name: dsh-opencode-go-quota
  config:
    pollMs: 30000
    providers:
      - opencode-go

典型用法与数据流¶

无需单独「打开插件界面」：选好属于 providers 列表的 Go 订阅模型后，底栏右侧即出现指示器。Host 使用 apiKeyEnv 指向的 Key 请求 GET {baseURL}/usage，读取 usage.rolling / usage.weekly / usage.monthly 的 percent、resetsAt、status；请求失败时显示 —，不伪造用量，浮层内可手动重试。除 OpenCode 官方额度接口外，插件不向其它第三方发请求。额度数据经 DSH 本机 loopback Web 服务暴露给浏览器；同机其它进程理论上可读聚合百分比，但拿不到 API Key，也不涉及会话内容。

适用场景与注意¶

适合谁：日常在 DSH 桌面端用 OpenCode Go 订阅模型、希望在作曲栏一眼看到三档额度窗口的用户。

排障要点（摘自 README）：

• 看不到指示器：确认当前模型 provider 在 providers 中、插件已启用、OPENCODE_GO_API_KEY 已配置。
• 一直为 —：多为 Key 无效、无 Go 订阅权限或网关不可达；展开浮层查看错误摘要并重试。
• 升级后不生效：先刷新；仍无效则完全退出 DSH 再打开。

安全与信任：插件以当前 DSH 进程权限运行；安装前建议在 GitHub 阅读 index.js、client.js 与许可证。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系——DSH 生态主张「一切皆插件」，自行审阅源码后再启用是合理习惯。

结尾¶

dsh-opencode-go-quota 把 OpenCode Go 的 Rolling / Weekly / Monthly 用量收到会话底栏，与原生上下文指示器并列，不抢焦点又便于对照。需要安装说明与排障细节时，以仓库 README 为准。

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