鲸鱼娘桌宠 SenuMirai/dsh-whale-girl

dsh-whale-girl 🐋

住在 DeepSeek Harness 里的鲸鱼娘 AI 伙伴：会说话、会看屏幕、也会陪你玩。

来源

本项目在 dsh-pet（MIT，© 2026 PC2005-cloud，上游版本 0.3.7）的基础上修改、扩展而来。
我们保留并扩展了它的桌宠渲染、对话、记忆、桌面窗口和设置系统，新增实时语音、识屏搭话、游戏陪玩/代打，并把包名、路由、数据目录与桌面助手协议全部改成 dsh-whale-girl，以便与上游同时安装。

上游代码与美术素材的 MIT 许可见 NOTICE.md 与 LICENSE。

这是什么

她不是一张会动的贴纸，而是一个有记忆、有声音、能看见你屏幕、能陪你在游戏里说话的桌面伙伴。她把大模型能力做成一个住在 DSH 里的透明小窗口，你可以拖她、点她、跟她说话，也可以让她安静待在角落。

功能与特点

| 能力 | 说明 |
| 透明桌宠 | 106 段 VP9-alpha 透明动画；待机、点击、拖拽、移动、碎碎念、余额气泡等状态 |
| 文字对话 | 走 DSH 当前模型；人设、记忆落盘、上下文压缩；支持气泡与右键对话 |
| 实时语音 | 本地 SenseVoice ASR + edge-tts 语音合成；按住说话，无需显卡；支持全局热键 |
| 屏幕感知 | 截图仅在内存中处理，交给 DSH 视觉模型，再以气泡搭话；默认关闭，可核对快照 |
| 游戏陪玩 | 识屏的「陪玩模式」：看战况、点评、提醒开团 |
| 游戏代打 | 键鼠注入 + 决策循环 + 三层急停；默认空跑，需显式开启 |
| 桌面窗口 | 透明置顶的 Electron 助手窗口，可与浏览器 overlay 并存 |
| DSH 原生命令 | /whale-pet、/whale-chat、/whale-balance，不会和 dsh-pet 的命令撞名 |
| 设置页 | 形象、动画、语音、识屏、游戏、模型、快捷键等集中配置 |
| 独立数据 | 数据在 $DSH_HOME/dsh-whale-girl/，不碰 dsh-pet，也不碰 QQ 群聊插件 |

环境要求

- DeepSeek Harness 桌面版（推荐最新版）
- Node.js 22.12+、pnpm 9+
- Windows 10/11（桌面窗口、全局热键、键鼠注入以 Windows 为主）
- 语音识别需要本机可用的 SenseVoice 运行时；不装也能用文字对话
- 识屏与看图需要所选 DSH 模型支持图片输入

安装

git clone https://github.com/SenuMirai/dsh-whale-girl.git
cd dsh-whale-girl
pnpm install
pnpm run bundle

然后在 DSH 的 profile 中把本目录 link 进去（或使用 dsh plugin --profile desktop add <绝对路径>）：

// <DSH_HOME>/profiles/desktop/package.json
{
"dependencies": {
"dsh-whale-girl": "link:/absolute/path/to/dsh-whale-girl"
},
"dsh": {
"profile": {
"bundles": [
// ... 其它插件 "dsh-whale-girl" ] } } }

重启 DSH。dsh.profile.bundles 只在启动时读取，热重载不会捡起新插件。

使用

1. 启动 DSH 后，右下角出现鲸鱼娘；拖动可换位置，单击/双击触发互动，右键打开菜单。
2. 打开「设置 → 鲸鱼娘」配置人设、模型、语音、识屏与游戏选项。
3. 语音：在设置里选择麦克风与热键，按住热键说话；首次使用会检查 ASR 运行时。
4. 识屏/陪玩：开启后她会按间隔截图并请求视觉模型；截图只在内存中，可保存快照核对。
5. 代打：默认 dry-run（只决策、不注入键鼠）。确认游戏窗口、键位与急停键后再开启真实注入。

配置与数据

| 路径 | 内容 |
| $DSH_HOME/dsh-whale-girl/main-config.jsonc | 用户配置（只写覆盖项） |
| $DSH_HOME/dsh-whale-girl/memory.json | 对话记忆 |
| $DSH_HOME/dsh-whale-girl/main-animation/ | 自定义动画 |
| $DSH_HOME/dsh-whale-girl/memes/ | 自定义表情包 |
| $DSH_HOME/dsh-whale-girl/pet/ | 额外 pet pack |

仓库不包含任何用户记忆、聊天记录、截图、账号或令牌；上述文件只存在于本机。

与 dsh-pet 的隔离

| 项 | dsh-whale-girl | dsh-pet |
| 包名 / entry id | dsh-whale-girl | dsh-pet |
| 路由前缀 | /dsh-whale-girl/ | /dsh-pet-7340/ |
| 数据目录 | $DSH_HOME/dsh-whale-girl/ | $DSH_HOME/dsh-pet/ |
| 斜杠命令 | /whale- | /balance /pet /chat |
| 桌面协议 | dsh-whale-girl-bridge:// | dsh-pet-bridge:// |

两者可以同时安装，不会共享人设、记忆或配置。

开发

pnpm run bundle # 构建 lib/
pnpm test # 单元测试
pnpm run typecheck # 类型检查

已知边界

- 语音识别与游戏注入依赖本机环境，Linux/macOS 未完整验证；
- 识屏/看图受模型能力限制；模型不支持图片时会退回文字；
- 代打涉及键鼠注入，请只在单机/允许的场景使用，并保留急停；
- 上游美术素材的授权边界以 NOTICE.md 为准。

致谢

- dsh-pet：上游桌宠框架、渲染、记忆、桌面窗口与素材链；
- DeepSeek Harness：插件宿主、模型、附件、设置与命令系统；
- edge-tts / SenseVoice / Electron 等开源依赖；
- 上游素材由豆包生成，详见 NOTICE.md。

许可

MIT。上游部分 © 2026 PC2005-cloud；本仓库修改部分 © 2026 SenuMirai。见 LICENSE。

这是什么

不是动态贴纸，而是有记忆、有声音、能看屏幕、能在游戏里吐槽的桌面伙伴。它把大语言模型变成一扇透明小窗，住在 DSH 里：拖她、戳她、跟她说话，或者让她安静待在角落。

功能

| 功能 | 说明 |
| 透明桌宠 | 106 个 VP9-alpha 动画：待机、点击、拖拽、移动、嘟囔、余额气泡 |
| 文字聊天 | 使用当前 DSH 模型；人设、持久记忆、上下文压缩、气泡与右键聊天 |
| 实时语音 | 本地 SenseVoice ASR + edge-tts；按住说话，无需 GPU，支持全局热键 |
| 识屏 | 截图在内存中处理，发给 DSH 视觉模型，再用气泡吐槽；默认关闭，快照可回看 |
| 游戏陪玩 | 「观战吐槽」模式：读对局、吐槽、喊开团 |
| 游戏代打 | 键鼠注入 + 决策循环 + 三层急停；默认 dry-run，需显式开启 |
| 桌面窗口 | 透明置顶 Electron 辅助窗口；可与浏览器浮层共存 |
| DSH 原生命令 | /whale-pet、/whale-chat、/whale-balance；与 dsh-pet 不冲突 |
| 设置界面 | 外观、动画、语音、屏幕、游戏、模型、热键 |
| 数据隔离 | $DSH_HOME/dsh-whale-girl/；不碰 dsh-pet 或 QQ 群插件 |

环境要求

- DeepSeek Harness 桌面版（建议最新）
- Node.js 22.12+、pnpm 9+
- Windows 10/11（桌面窗口、全局热键与输入注入优先支持 Windows）
- 语音识别需要本地 SenseVoice 运行时可用；没有它文字聊天照常可用
- 识屏/视觉功能需要支持图片输入的 DSH 模型

安装

git clone https://github.com/SenuMirai/dsh-whale-girl.gitbash
cd dsh-whale-girl
pnpm install
pnpm run bundle

把它链接进你的 DSH 配置档（或运行 dsh plugin --profile desktop add <absolute-path>）： jsonc // <DSH_HOME>/profiles/desktop/package.json {
"dependencies": {
"dsh-whale-girl": "link:/absolute/path/to/dsh-whale-girl"
},
"dsh": {
"profile": {
"bundles": [
// ... other plugins
"dsh-whale-girl"
]
}
}
}

重启 DSH。 dsh.profile.bundles 只在启动时读取，热重载不会加载新插件。

用法

1. DSH 启动后，鲸鱼娘出现在右下角。拖动可移动，单击/双击可互动，右键打开菜单。
2. 打开 设置 → 鲸鱼娘，配置人设、模型、语音、屏幕感知和游戏选项。
3. 语音：选择麦克风和热键，按住说话。首次使用时检查 ASR 运行时。
4. 屏幕/游戏陪伴：开启后，她按间隔截屏并询问视觉模型。截图只留在内存里，快照可选。
5. 自动游玩：默认空跑（只做决策，不注入输入）。开启真实注入前，先确认游戏窗口、按键绑定和紧急停止。

配置与数据

| 路径 | 内容 |
| $DSH_HOME/dsh-whale-girl/main-config.jsonc | 用户配置（仅覆盖项） |
| $DSH_HOME/dsh-whale-girl/memory.json | 聊天记忆 |
| $DSH_HOME/dsh-whale-girl/main-animation/ | 自定义动画 |
| $DSH_HOME/dsh-whale-girl/memes/ | 自定义表情包 |
| $DSH_HOME/dsh-whale-girl/pet/ | 额外宠物包 |

仓库里没有用户记忆、聊天记录、截图、账号或 token；这些文件只存在于你的机器上。

与 dsh-pet 的隔离

| | dsh-whale-girl | dsh-pet |
| 包名 / 入口 id | dsh-whale-girl | dsh-pet |
| 路由前缀 | /dsh-whale-girl/ | /dsh-pet-7340/ |
| 数据目录 | $DSH_HOME/dsh-whale-girl/ | $DSH_HOME/dsh-pet/ |
| 斜杠命令 | /whale- | /balance /pet /chat |
| 桌面协议 | dsh-whale-girl-bridge:// | dsh-pet-bridge:// |

两者可以并排安装，人设、记忆和配置各自独立。

开发 bash
pnpm run bundle # build lib/
pnpm test # unit tests
pnpm run typecheck # type check

已知限制

- 语音识别和输入注入依赖本地环境；Linux/macOS 未完全验证。
- 视觉功能依赖所选模型；纯文本模型会回退到文本。
- 自动游玩会注入键盘/鼠标输入。只在单人/允许的场景使用，并保持紧急停止可触达。
- 素材许可遵循 NOTICE.md 中的上游条款。

致谢

- dsh-pet：上游桌面宠物框架、渲染、记忆、桌面窗口和素材管线。
- DeepSeek Harness：插件宿主、模型、附件、设置和命令。
- edge-tts、SenseVoice、Electron 等开源依赖。
- 上游美术资源由豆包生成，详见 NOTICE.md。

许可证

MIT。上游部分 © 2026 PC2005-cloud；修改部分 © 2026 SenuMirai。详见 LICENSE。