dsh-whale-maid-mascot

Readme

# DeepSeek 娘 · dsh 页面宠物插件 🐋

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

## 素材来源与版权

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

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

详细声明见 [`assets/SOURCE.md`](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

## 安装

```bash
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 截图验收用）

## 卸载

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

## 改气泡文案 / 尺寸 / 位置

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