奶蛙角色挂件 lwwwj/dsh-whale-widget-naiwa-role

dsh-whale-widget 角色拓展 —— 奶蛙

把 DSH（DeepSeek Harness）Web 界面右下角那只「DeepSeek 余额小鲸鱼」换成奶蛙：平时站着，点一下仰头大笑并出声，思考时变托腮，任务结束点下头，你在输入框打字时叉腰指点。

这是一个第三方插件的角色拓展（魔改），不是官方插件。
上游插件：dsh-whale-widget v0.4.2（作者 MeteorNOX，MIT 许可，仓库 <https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget>）。
本仓库保留了上游的 LICENSE 与 PROVENANCE.md，只做角色/音效/状态机的本地改动。

效果

| 时机 | 形象 | 说明 |
| 平时 | 奶蛙（state0） | 拖动、余额气泡、每轮花销、音效等上游功能全部保留 |
| 点一下挂件 | 奶蛙·大笑（state1） | 播放奶蛙笑声，2.5 秒后回到站立（带轻微抖动） |
| 再点一下 | 安迪（state2） | 播放安迪音效，1 秒后回到站立；再点又回到大笑 —— 两条音效交替 |
| 我思考时 | 奶蛙·思考（state3） | 你发出消息后自动切，直到这一轮结束 |
| 任务结束 | 奶蛙·完成（state4） | 每轮任务结束闪 1 秒，然后回到站立 |
| 你打字时 | 奶蛙·指点（state5） | 在输入框里打字就出现，停手 0.9 秒后离开 |

挂件菜单 →「角色」里只有两条：奶蛙 与插件自带的 小鲸鱼（其余 5 张状态图不列出来，由补丁按 URL 直接换图；选中「小鲸鱼」时不再有上面这套状态机）。

安装

方式 A：已经装过 dsh-whale-widget（推荐）

在解压后的目录里执行： powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会把打过补丁的客户端覆盖到现役插件，并把角色图/音效放进 %USERPROFILE%\.dsh。
原有的客户端与索引都会先备份成 .before-naiwa-<时间戳>。

方式 B：同学那边还没装插件（连插件一起装）

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Full

-Full 会把完整插件包（0.4.2 + 奶蛙补丁）装到默认 profile，并把 dsh-whale-widget 写进 profile 的 package.json（dsh.profile.bundles 与 dependencies）。

装完完全重启 DSH，然后刷新网页（F5）。只想重载客户端时 F5 就够 ——插件是按 mtime 重读 assets/whale-widget.js 且响应 Cache-Control: no-store。

目录

dsh-whale-widget-naiwa-role\
install.ps1 安装脚本（默认只覆盖客户端 + 角色/音效；-Full 连插件一起装） plugin\ 打过补丁的 dsh-whale-widget 0.4.2 完整插件包 assets\whale-widget.js 客户端（含奶蛙状态机补丁 v7） assets\whale-widget.js.dshwv-bak 上游原始客户端（要还原就改回这个名字）
data\
whale-roles\ state0..5.png + roles.json
whale-audio\ nailong_laugh.wav（奶蛙笑声）、andi.wav（安迪）、gagalaxia.wav tools\ 角色/音效安装、补丁与冒烟测试脚本 patches\ 客户端改动的 unified diff（原始 0.4.2 → 补丁后） docs\naiwa-widget-notes.md 完整技术说明（行为、文件落点、旋钮、回退、限制）

换成你自己的形象 / 音效

* 换形象：替换 %USERPROFILE%\.dsh\whale-roles\state0.png … state5.png（方形透明 PNG，正方画布、主体贴底边居中），刷新即可；也可以跑 tools\_install_states.py。
* 换音效：tools\_install_audio.py <音频文件> [片段id] [显示名]；注意客户端里写死了两个 id： nailong_laugh（点击大笑）与 andi（点击第二下），换文件时保持 id 不变就行。
* 调节奏：客户端补丁块（搜 /* dshwv-clickface-patch v7 /）顶部的 CLICKFACE 配置里有每个状态的停留毫秒 ms、打字态停手时长 typingIdleMs、抖动开关 shake 等。

还原

把 plugin\assets\whale-widget.js.dshwv-bak 覆盖成 assets\whale-widget.js 即可回到上游原版；角色与音效文件删掉即可（或者留着也不影响原版客户端）。

换回上游原版 / 关于补丁

还原：把 plugin\assets\whale-widget.js.dshwv-bak（上游 0.4.2 原始客户端）覆盖成 assets\whale-widget.js 即可；角色与音效文件删掉即可（留着也不影响原版客户端）。
* 改了什么：patches\naiwa-role-states-0.4.2.patch 是「原始 0.4.2 → 奶蛙补丁 v7」的完整 unified diff，在客户端里搜 /* dshwv-clickface-patch v7 / 也能看到补丁块（配置与逻辑都在一起）。
tools\_patch_widget.py 里的锚点是按 0.3.18 的客户端写的（当年用它打补丁），对 0.4.2 会在第二个锚点处安全地中止、不改文件；0.4.2 直接用本仓库里已经打好补丁的客户端就行。

许可与致谢

* 上游插件 dsh-whale-widget（MIT）作者 MeteorNOX —— 本仓库的挂件主体、气泡、账本等功能都由它提供。
* 本拓展（角色图处理、状态机补丁、音效与安装脚本）以 MIT 许可一并发布，见 LICENSE。
* 角色形象取自用户提供的《奶蛙/奶龙》相关图片与公开音效站素材，仅供个人学习自用，请勿商用或二次分发盈利。