Overview
dsh-whale-widget
DSH Web 界面右下角的 DeepSeek 余额小鲸鱼挂件（含今日已用、峰谷定价、随机台词、音效与每轮消耗统计）
README / EN
Package documentation
DSH-widget-Hzm
本分支基于 MeteorNOX/DeepSeek-Balance-Whale-Widget 修改而来，保留原项目的 MIT 许可证与原作者版权。 在原项目功能基础上，对角色皮肤、随机台词、动图、音效等做了自定义修改。
DeepSeek Harness（DSH）Web 界面右下角的常驻余额挂件：显示 DeepSeek API 余额、今日已用、每轮对话消耗统计，支持拖拽吸附、左吸附翻转、数字滚动动画、按压 Q 弹、随机台词与动图、多角色皮肤切换，随界面自动启用。
✨ 本分支的修改内容
在原项目基础上做了以下自定义修改：
| 项目 | 修改说明 |
|---|---|
| 🎨 角色皮肤 | 新增 assets/skins/ 多角色皮肤目录，挂件菜单中可一键切换并持久记忆；将 610×610 透明 PNG 放入该目录即可新增角色 |
| 👧 角色形象 | 角色为虚拟主播 灰泽满（立绘见 assets/skins/） |
| 💬 随机台词 | 替换为自定义台词（点击挂件随机出现） |
| 🎬 动图 | 替换为自定义动图（assets/rua.gif） |
| 🔊 音效 | 新增第三套音效（按下/松手），共三套可切换 |
| 🔤 气泡字体 | 缩小气泡文字字号，更精致 |
| 📉 峰谷模式 | 精简为默认模式（空闲时段 / 高峰时段） |
📥 安装
从本仓库安装（推荐，包含本分支全部自定义内容）
git clone https://github.com/MureasAm/DSH-widget-Hzm.git
cd DSH-widget-Hzm
# 本地链接安装（仓库根目录即插件包）
dsh plugin add link:<本仓库绝对路径>
然后重启 dsh web（或 DSH Desktop 后重启应用），刷新浏览器即可看到挂件。
如果提示已存在/冲突，先
dsh plugin remove dsh-whale-widget再重新 add。 移动仓库目录后需要重新执行一次dsh plugin add link:<新路径>。
卸载
dsh plugin remove dsh-whale-widget
🎮 使用说明
- 自动启用：挂件随 DSH 界面自动出现在右下角；
- 点击挂件：弹出余额气泡（余额 + 今日已用），再点切换随机台词，再点关闭；
- 拖拽：按住拖动到任意位置，靠近屏幕边缘自动吸附（吸附到左缘自动水平翻转）；
- 设置菜单：悬停挂件右上角三点按钮，可调整：大小、音效（三套）、音量、用量模式、角色皮肤、气泡开关、每轮消耗提示等；
- 按压 Q 弹：按住挂件有弹压效果 + 音效。
自定义角色皮肤
- 将角色图处理为 610×610 透明 PNG（白底图需先抠图）；
- 放入
assets/skins/目录，文件名即菜单显示名（如huizeman.png→ 菜单显示 "huizeman"）； - 重启后，在挂件菜单「角色」中选择即可。
所需凭据
DEEPSEEK_API_KEY（必需）：DeepSeek API 密钥，用于拉取余额（在 DSH 凭据服务中配置）；DEEPSEEK_PLATFORM_TOKEN（可选）：实时用量模式需要，不配也能用默认的「小鲸鱼记账」模式。
🐋 功能特性（继承自原项目）
- 余额自动刷新（60 秒）+ 点击手动刷新，余额变化数字滚动动画
- 今日已用：默认「小鲸鱼记账」模式（余额差值本地记账，开箱即用）；可选「实时·令牌」模式（峰谷定价换算）
- 每轮对话消耗统计：每轮对话结束后弹出本轮消耗金额
- 随机台词 + 动图气泡
- 拖拽、四分之一区域吸附、左吸附水平镜像
- 按压 Q 弹 + 音效
- 多角色皮肤切换
📄 致谢与许可
- 本分支基于 MeteorNOX/DeepSeek-Balance-Whale-Widget 修改，保留原作者 MIT 许可证与版权声明；
- 角色立绘来自虚拟主播 灰泽满；
- 本分支修改：MureasAm。