dsh-pet-opencode-go-balance

把 OpenCode Go 的 5h / 周 / 月 三窗口用量接进 dsh-pet 的余额气泡： 以 provider id dsh-opencode-go 注册到 dsh-pet 的第三方余额表，气泡里显示和 OpenCode Go 设置卡片同一套数字。

它解决什么

桌宠的余额气泡原本对 OpenCode Go 只会显示「当前服务商暂不支持余额查询」。原因不是配置，而是两处写死在依赖方源码里的错位：

1. provider id 对不上：dsh-pet 按 agentDefaultModel.currentSelection().provider 查内置表，表里只有 opencode-go； 而 dsh-opencode-go 注册的 provider id 是 dsh-opencode-go，查表必然落空。
2. 凭据 ref 对不上：dsh-pet 内置的 opencode-go 路由写死 OPENCODE_GO_API_KEY， 而多账号形态的 key 存在 DSH_OPENCODE_GO_ACCOUNT_* 下。

本插件不改 dsh-pet 源码，走它官方开放的第三方注册口 （ctx.provide('petApi7340', { balance: { register } })）注册一个 provider：

• id 用 dsh-opencode-go，与宿主报告的完全一致；
• 取数优先调用 dsh-opencode-go 自己的 opencodeGoUsage 服务 —— 账号、baseURL、代理、超时、缓存去重都由它负责， 所以桌宠的气泡与 OpenCode Go 设置卡片永远是同一个数据源，切换账号后自动跟随；
• 只有在没有该服务时才退化为直连 GET https://opencode.ai/zen/go/v1/usage（20s 超时 + 2 次线性退避重试）。

气泡显示什么

• 5h / 周 / 月 三个百分比，满额度按 Go 套餐常量 12 / 30 / 60 USD 计算（与 dsh-pet 内置口径一致）；
• 每个窗口的重置倒计时；
• 超额时如实显示 >100%，不夹到 100；
• 任何异常一律抛错，由 dsh-pet 落成 fetch-error 气泡 —— 绝不伪造 0 余额。

依赖

依赖	版本	用途
dsh-pet	≥ 0.3.8	提供 petApi7340.balance.register 注册口（必需）
dsh-opencode-go	≥ 0.1.24	提供 opencodeGoUsage 服务（强烈建议；缺失时走直连兜底）

安装

本插件目前只发布在 GitHub，尚未发布到 npm，所以请用仓库地址安装。

在 DSH 的 设置 → 插件 → 安装 里粘贴：

https://github.com/QLY-3315/dsh-pet-opencode-go-balance

或用 CLI：

dsh plugin --profile desktop add "https://github.com/QLY-3315/dsh-pet-opencode-go-balance"
# 或者从本地目录
dsh plugin --profile desktop add "E:\path\to\dsh-pet-opencode-go-balance"

装完重启 DSH，然后在 dsh-pet 设置里确认该宠物的「余额功能」已开启，右键「查看余额」或 /balance 即可。

卸载：

dsh plugin --profile desktop remove dsh-pet-opencode-go-balance

配置

通常不需要配置：默认跟随 dsh-opencode-go 当前选中的账号。

只有一个环境变量，在没有 opencodeGoUsage 服务、走直连兜底时才会用到：

环境变量	说明
DSH_PET_OPENCODE_ACCOUNT_REF	账号凭据 ref；换账号时指定，免改代码。缺省依次尝试 OPENCODE_GO_API_KEY

兼容性

dsh.compatibility.dshReleases 中只声明了实测通过的版本：

DSH	状态
0.2.1-rc.3	compatible

开发

node --test test/   # 纯函数 + 宿主装配，共 12 项

代码结构：

• lib/index.js —— 宿主插件主体：等服务就绪、注册 provider、取数；
• lib/windows.js —— 纯函数：用量 → dsh-pet windows 形态（零依赖，可直接单测）。

许可

MIT