前言¶
在 DSH Web 界面中，查看用量通常需要切换面板，不够直观。dsh-opencode-go-usage 插件提供了一个常驻的桌宠小窗，用于实时监控用量。下面介绍该插件的功能与使用方式。
这是什么¶
dsh-opencode-go-usage 是 DSH Web GUI 的桌宠用量小窗，角色名为蓝色大肥鱼。它由 wawo77 维护，属于趣味换装类别。该插件解决了在 Web 界面角落常驻查看用量的问题，无需切换面板即可了解今天的消耗情况。
核心功能¶
该插件具备以下能力：
- 自动适配 Provider：自动识别并适配 DSH 配置的 provider，支持 OpenCode Go、Command Code、DeepSeek 官方等。
- 骨骼动画：角色具有骨骼动画效果，包括呼吸起伏、每 6 秒蹦一下、耳朵抖动、尾巴摆动。
- 现场合成音效：点击交互（如“吱”声）和缩放音效（“啵”声）均为现场合成，零音频文件，零版权问题。
- 智能转向：角色会根据在屏幕上的位置自动转向，贴屏幕左半边朝右看，贴右半边朝左看。
- 交互控制：支持鼠标悬停、点击展开详情、拖动位置、滚轮缩放（范围 90–260px）。
- 数据安全：纯本地处理，账号数据不出本机，所有 HTTP 路由都有 loopback 围栏。
安装与启用¶
执行以下命令安装插件：
dsh plugin --profile web add "github:wawo77/dsh-opencode-go-usage"
安装后，需要重启 dsh web 以确认安装并验证 sprite 加载。安装路径含空格会导致 link 协议安装失败。
典型用法¶
- 查看用量：在 DSH 网页界面角落常驻查看用量，气泡第一行显示套餐配额百分比或账户余额，第二行显示今日 token。
- 交互查看：点击角色展开详情卡片，查看更多统计数据。
- 调整大小：在角色上滚动滚轮进行缩放（90–260px），每变一档会响一声“啵”。
- 悬停互动：鼠标悬停在角色上，角色会轻轻抬起。
适用场景与注意¶
该插件适合需要在 DSH Web 界面中直观查看用量并关注数据隐私的用户。
使用时需注意以下事项：
* 版本要求：需要 DSH >= 0.1.5-rc.1。
* 配置依赖：需在 DSH 中配置对应套餐的 API Key（如 OPENCODE_GO_API_KEY、DEEPSEEK_API_KEY）。
* 重启生效：安装后必须重启 dsh web 才能生效。
* 路径限制：安装路径含空格会导致 link 协议安装失败。
总结¶
dsh-opencode-go-usage 提供了一个低开销、可视化的用量监控方案，结合了骨骼动画与本地安全处理机制，适合追求实用性与隐私性的 DSH 用户。
