前言¶

DeepSeek Harness（DSH）采用插件化架构，余额小鲸鱼挂件是其中用于展示余额、今日已用额度及峰谷定价的组件。本仓库是基于官方 dsh-whale-widget 0.3.9 的非官方衍生版，在保留原有余额、定价、音效等核心功能的基础上，新增了交互与可视化增强。

插件简介¶

• 名称: 621758/dsh-whale-widget-pet-feed
• 定位: DeepSeek Harness 余额小鲸鱼挂件非官方衍生版（基于 dsh-whale-widget 0.3.9）
• 功能: 新增摸头、摸头音效、互动统计和投喂按钮，其余功能原样保留。
• 许可: MIT
• 安装: npm i "https://github.com/621758/dsh-whale-widget-pet-feed"

核心功能¶

本插件主要包含以下四个功能点：

1. 摸头切图 + 摸头音效
   通过特定的鼠标划动触发，角色图会切换为摸头图，并伴随音效。停手约 0.7 秒后切回。
2. 互动统计
   在菜单中提供二级面板，可查看今日/本月/总点击数及摸头数，支持一键清空。
3. 投喂按钮
   点击角色后展开三个 Emoji 按钮（🍚 / 🥤 / 🪙），按下后角色图切换为对应食物图，停留 2.2 秒后切回。
4. 内置兜底图
   插件包内预置了摸头图与投喂图的兜底资源，防止因本地文件缺失导致裂图。

安装与启用¶

安装前请确保 dsh.profile.bundles 中已包含 dsh-whale-widget（即已安装过官方版）。

执行以下命令进行安装：

npm i "https://github.com/621758/dsh-whale-widget-pet-feed"

安装完成后，需执行以下操作使改动生效：

• 前端改动（挂件界面、摸头、投喂、统计）：浏览器硬刷新（Ctrl + Shift + R）。
• 宿主代码改动（新增图片路由）：重启 DSH（执行 dsh web）。

使用方法¶

1. 摸头切图¶

在角色身上左右来回划，需满足以下条件才触发：
- 累计 3 次有效方向反转。
- 1.4 秒内完成。
- 每一笔移动距离 ≥ 12px。

触发后，停手约 0.7 秒，角色图会切回当前状态。在菜单中可关闭此功能或更换摸头图。

2. 投喂按钮¶

点击角色，左侧会展开三个 Emoji 按钮（🍚、🥤、🪙）。
- 按下按钮：播放音效，角色图切换为对应食物图，2.2 秒后切回。
- 无操作约 4.2 秒自动收起按钮。

3. 互动统计¶

点击角色右上角的菜单（☰），进入 互动统计 [查看]：
- 查看今日/本月/总点击数及摸头数。
- 点击“清空统计”可将数据归零。

注意事项¶

• 预载机制：首次打开页面时会后台预载摸头图与三张投喂图（约 6.6MB）。预载未完成时不会强制切图，避免出现空白。
• 重启与刷新：宿主代码改动（如新增路由）需要重启 DSH；前端改动需要硬刷新浏览器。
• 音效复用：本衍生版未新增音频素材，所有音效均复用上游的音效组机制。

适用场景¶

本插件适合希望在 DSH Web 界面右下角的小鲸鱼挂件上增加更多趣味交互（如摸头、投喂）的用户。由于是 MIT 许可，开发者可以自由使用和修改，但需注意保留版权声明。