鲸娘桌面宠物 yefeng7531/dsh-whale-maid-mascot

DeepSeek 娘 · dsh 页面宠物插件 🐋

只在 DeepSeek Harness 网页界面里显示的吉祥物插件（不是独立桌面窗口）。

素材来源与版权

本插件中的鲸鱼娘形象素材来自：

- 来源：https://www.bilibili.com/opus/1231977657712771073
- 许可证：CC BY-NC-SA 4.0
- 用途：非商业使用
- 修改说明：原图去白底、透明化、尺寸调整

详细声明见 assets/SOURCE.md。

- 待机：显示原图 A（938d2f8a…jpg，全身立绘，白底已透明化），轻微漂浮摇摆
- 样式切换：鼠标悬停左上角 A/B/C 圆钮，切换立绘 / Q 版 / 新立绘，选择会被记住，点击角色不再自动换样式
- 分区反应：
- 点头部：摸摸头 / 耳朵不是玩具
- 点胸部：特殊害羞反应（脸红 + 😳 + “变态！”）
- 点腿部：戳裙子 / 袜子才不臭
- 点裙摆：裙摆要飞起来啦
- 2.6 秒内快速点击 10 次：生气（💢 + 抖动 + “不理你了”）
- 好感度系统：摸头 +1、胸 +3、腿 +2、裙摆 +1，保存在 localStorage；等级 0/10/30/60/100，等级越高气泡文案越亲密，升级时有 💖 提示
- 拖拽动画：拖动时身体朝移动方向倾斜，松手后有惯性回弹和落地弹跳
- 右键菜单：右键宠物可归档当前对话（二次确认）、新建会话、查看已归档会话（列表 + 只读历史查看）、解释术语
- 解释术语：右键 → 解释术语 → 选中页面文本 → 点击浮动按钮，在右侧独立解释面板中查看结果，不占用当前会话
- 解释面板：可通过右键菜单“打开解释面板”随时打开，点面板右上角 ✕ 关闭
- 解释使用独立隐藏会话完成，不会出现在当前对话或已归档列表里
- 当前会话被删除时，对应的解释会话会自动跟随删除；解释面板右上角 🗑 可手动清空所有解释记录
- 常用 Prompt：右键菜单 → 常用 Prompt，可快速把常用指令填入输入框
- 系统提醒：右键菜单可开启/关闭系统通知；任务完成时即使页面在后台也能收到提醒
- 随机小剧场：长时间未互动时，宠物会随机说话/做小动作
- 拖拽投喂：把工作区里的会话拖到宠物身上，可选择归档或删除（均有二次确认）
- 可拖动、可收起（右上 ✕，右下 🐋 唤回）；位置、样式、显隐状态、好感度保存在浏览器 localStorage

安装

dsh plugin --profile web add
重启 dsh web 后生效（页面右下角）

注意：路径含空格时 dsh plugin add 会解析出错，可先建一个无空格 junction： New-Item -ItemType Junction -Path C:\Users\\wm-mascot-plugin -Target

结构

- dsh/index.js：host 插件，向浏览器提供三张 PNG（/whale-maid-mascot/a.png、b.png、c.png）
- dsh/client.js：浏览器插件，渲染页面宠物
- assets/mascot_*.png：原图 JPG 去白底后的透明 PNG（A/B 高 520px，C 为新增立绘）
- test/：本地 QA 页面与静态服务器（headless Chrome 截图验收用）

卸载

dsh plugin --profile web remove dsh-whale-maid-mascot

回归测试

使用 Node.js 20 或更新版本：

npm ci
npx playwright install chromium
npm test

测试会自动启动本地 QA 服务器，在 Chromium 中加载实际客户端，并模拟会话服务和删除接口，覆盖解释记录清理失败重试、部分成功及并发清理；不需要运行 DeepSeek Harness，也不会操作真实会话。

改气泡文案 / 尺寸 / 位置

编辑 dsh/client.js 顶部的 LINES 数组和 .wm-img、.wm-root 样式后刷新页面即可。