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 样式后刷新页面即可。