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。

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

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

它显示什么

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

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

交互

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

两种数字的区别

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

所以"官方 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