DSH Web 界面提供了 API 余额监控的基础能力，原版挂件功能完整但形象固定。fiven577 在原版基础上进行了修改，将桌宠形象替换为角色「三口」，并增加了语音互动、状态机逻辑（生气/吃撑）以及透明动画，适合需要个性化桌宠监控余额的开发者。
功能概览¶
该插件在保留原版核心能力的基础上，增加了以下特性：
- 常驻自启：随 DSH Web 界面打开自动出现在右下角。
- 余额监控：支持 60s 自动刷新与手动点击刷新，余额变化带有数字滚动动画；支持「小鲸鱼记账」与「实时·令牌」两种今日已用模式。
- 交互与操作：支持拖拽与四边吸附、按压 Q 弹效果、汉堡菜单（调整大小/音量/气泡开关）。
- 峰谷文案：支持「默认 / 梁文峰谷 / !?强强?!」三套文案皮肤，并附带峰谷计价功能。
- 随机台词与动图：桌宠会弹出随机台词气泡，并显示 rua.gif 动图。
- 三口皮肤版新增：
- 自定义形象：桌宠本体由鲸鱼替换为角色「三口」的透明立绘（可自行替换
assets/DSniang1.png）。 - 语音互动：点击播放音效，对话消耗提示时同步播放音效。
- 生气状态：2 秒内连点 ≥6 次，形象切换为生气状态，播放语音。
- 余额提醒（吃撑）：支持固定档位或自定义金额（0.1~1000），累计消耗达标后形象切换为吃撑状态，弹出气泡提示。
- 吃透明动画：每轮消耗提示时播放带 Alpha 的吃动画，加载失败会降级为纯音效。
- 状态协调：生气与吃撑状态互斥，吃动画可被打断，修复了菜单状态失步与像素遮挡问题。
- 自定义形象：桌宠本体由鲸鱼替换为角色「三口」的透明立绘（可自行替换
安装与启用¶
安装前需确保已配置 DEEPSEEK_API_KEY（拉取余额必需），并已安装 DSH Desktop / dsh CLI / pnpm。
- 执行以下命令安装插件：
dsh plugin --profile web add github:fiven577/dsh-whale-widget-sankou
-
安装完成后，完全退出并重新启动 DSH Desktop，刷新页面即可在右下角看到桌宠。
-
验证安装是否成功：
curl http://127.0.0.1:3080/dsh-whale/balance.json
curl http://127.0.0.1:3080/dsh-whale/image.png
使用方法¶
- 查看余额与今日已用：点击桌宠即可查看。
- 切换峰谷台词：点击桌宠弹出的气泡，约 45% 概率会出现「当前时间段为」等随机台词。
- 触发生气状态：在 2 秒内快速点击桌宠 6 次以上，形象会切换为生气状态并播放语音。
- 设置吃撑提醒：点击桌宠唤出汉堡菜单，进入「余额提醒」选项，选择档位或手动输入 0.1~1000 的金额。
- 更换音效：在汉堡菜单的「音效」选项中，选择「语音·点击(嗯？)」、「小黄鸭」或「音效1」。
注意事项¶
- 插件代码遵循 MIT 许可证，但自定义素材（形象图、语音、动画）为作者原创，二次分发素材需保留说明并注明出处。
- 动画加载失败会静默降级为仅播放音效。
- 如需恢复原版鲸鱼形象，将原版
assets/DSniang1.png放回即可。 - 插件以当前 DSH 进程权限运行，请确保源码与许可证符合使用规范。
