dsh-opencode-go-usage

DSH Web GUI 的桌宠用量小窗。角色叫 蓝色大肥鱼。

在 DSH 网页界面角落里常驻一只角色，头顶气泡实时显示你的套餐用量—— 不点开任何面板就能一眼看到今天烧了多少。

• 自动适配你用的套餐：OpenCode Go、Command Code、DeepSeek 官方， 按 DSH 里配置的 provider 自动匹配，不用手选
• 套餐制看百分比，按量计费看余额——不会给钱包硬算一个假的"本期用了百分之多少"
• 骨骼动画：呼吸起伏、每 6 秒蹦一下、耳朵抖、尾巴摆，循环首尾帧逐字节相同
• 音效是现场合成的（点击"吱"、缩放"啵"），零音频文件、零版权问题
• 会转头：贴屏幕左半边朝右看，贴右半边朝左看
• 可拖动、滚轮缩放（90–260px），偏好存在宿主侧
• 纯本地：账号数据不出本机，所有 HTTP 路由都有 loopback 围栏

安装

dsh plugin --profile web add "github:wawo77/dsh-opencode-go-usage"

装完确认 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 里有 "dsh-opencode-go-usage"，然后重启 dsh web。

取不到？不需要装 git，但有两个备用办法

不需要本机装 git。 pnpm 会直接取 GitHub 的 tarball——实测在没装 git 的 Windows 上， github: 形式的依赖能正常装成。安装会把整个仓库拉下来（约 19 MB，含素材与开发工具链）。

万一 github: 取不到：点 Code → Download ZIP，解压到路径不含空格的目录，然后

dsh plugin --profile web add "link:C:/path/to/dsh-opencode-go-usage"

路径含空格会让 pnpm 把 link: 协议拆断（ERR_PNPM_PACKAGE_MANAGER_ADD_RESOLVE_LATEST）。

卸载：

dsh plugin --profile web remove dsh-opencode-go-usage

再从 dsh.profile.bundles 里删掉对应项，重启。

它显示什么

你用的套餐	气泡第一行	卡片里还有什么
OpenCode Go	5 小时配额百分比	1 周 / 1 个月进度条、重置倒计时、本地估算金额
Command Code（GOAT / Go / Pro / Max…）	本期用量百分比	剩余额度（月度 / 加购 / 赠送）、windowLimits 各窗口
DeepSeek 官方 API	账户余额	充值 / 赠送拆分、今日 token 与花费
其它 / 没配	今日 token	今日 token 与花费明细

气泡第二行永远是今日 token。

按量计费的钱包没有"本期用了百分之多少"这回事，硬算一个只会误导，所以那一档直接显示余额： 余额为负或账户不可用时数字染红，余额偏低染琥珀，其余跟随正文色。

交互

操作	反应
什么都不做	缓慢呼吸起伏；气泡持续显示用量
鼠标悬停	角色轻轻抬起
点一下角色	Q 弹压缩→回弹，响起小黄鸭的"吱"声，说一句话，展开详情卡片
卡片开着时再点	换一句吐槽（「别戳啦，痒！」）
点卡片外空白	收起卡片，气泡说句告别语
按住拖动	角色跟随并转向，松手记住位置；拖动中不会误触发点击
在角色上滚轮	缩放（90–260px），每变一档响一声"啵"；卡片底部也有 −/＋
卡片上的 🔊	静音 / 开启音效（默认开，偏好存在宿主侧）
跨过 50% / 80% 阈值	角色主动说一句提醒，不打断你刚触发的台词
键盘	Tab 聚焦后 Enter / 空格 = 点一下，Esc = 收起卡片

台词的语气跟着用量走，不是纯随机：宽裕时夸自己省、过半时提醒你悠着点、快超限时喊救命。 每句都配一个颜文字。

两种数字的区别

卡片里有两类数字，口径不同，卡片自己也标了：

	官方数字	本地统计
来源	套餐方自己的用量接口	DSH 的 session/event
覆盖范围	整个订阅（含其它客户端）	只统计经过 DSH 的调用
精度	权威	估算：价目表假设 + 本地记账

所以"官方 32%"和"本地 $6.56"对不上是正常的——它们数的不是同一批调用。

本地金额按 Go 官方价目表折算（含 DeepSeek 系列的峰谷价）。价目表里没有的模型会被列在卡片底部提示。

常见问题

看到一颗 (・ω・) 圆球而不是角色？ 角色的部件图没加载出来，插件退回了占位符（功能不受影响）。最常见的原因是宿主进程还在跑旧代码 ——重启一次 dsh web。要确认，跑 node test/verify-installed.mjs，GET the sprite is 200 那条过了就是宿主版本没问题。

气泡显示 --？ 还没拿到用量数据。检查该套餐的 key 是否在 DSH 里配好：OpenCode Go 用 OPENCODE_GO_API_KEY， Command Code 用 COMMAND_CODE_API_KEY 或 ~/.commandcode/auth.json，DeepSeek 用 DEEPSEEK_API_KEY。

卡片底部出现红色错误行？ 探测失败了，行里带着具体原因。官方数字会保留最后一次成功读数（状态点变琥珀色）。

会上传我的用量数据吗？ 不会。探测在宿主进程里跑，API key 只在宿主侧解析、永远不进浏览器；所有路由都有 loopback 围栏 （socket 地址 + Host 头 + 同源标记）。唯一的对外请求就是你那家套餐的用量接口。

开发

架构、素材管线、自检、HTTP 接口、已知限制都在 docs/DEVELOPING.md。

node test/selftest.mjs            # 65 项静态检查，不需要网络、不需要运行中的宿主
node test/verify-installed.mjs    # 针对运行中的实例做端到端验证（只读）

License

MIT