鲸鱼娘 · dsh-whale-musume

DeepSeek Harness 的桌宠看板娘：安静陪你写代码，工作一开始她就抱起笔记本，绝不插嘴。

一分钟上手 · 看看她长什么样 · 她有什么 · 常见问题 · English

为什么是鲸鱼娘

大部分桌宠要么只是「会动的图」，要么会在你专注时抢注意力。鲸鱼娘的三条硬规则：

而且她是真的会看你在干什么：不是定时随机换图，而是读取宿主的结构化标记（工具卡状态、会话运行标记、终端块）来判断你在忙什么，再决定摆哪个姿势、要不要闭嘴。

目录

• 一分钟上手
• 看看她长什么样
• 她有什么
• 兼容性
• 第一次使用
• 使用说明
• 设置面板
• 更新 / 回滚 / 卸载
• 版本更新
• 数据与隐私
• 常见问题
• 故障排查
• 路线图
• 项目结构
• 开发与测试
• 参与贡献
• 致谢
• License

一分钟上手

# 桌面端（Electron 壳）——把路径换成你的安装位置
$Desktop = "D:\DeepseekHarnessDesktop"
$Cli = "$Desktop\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js"
$env:ELECTRON_RUN_AS_NODE = "1"
& "$Desktop\DeepSeek Harness.exe" --expose-internals $Cli plugin --profile desktop add github:Sutera-Diffusus/dsh-whale-musume

# 旧版 Web profile
dsh plugin --profile web add github:Sutera-Diffusus/dsh-whale-musume

装完重启宿主（桌面端重启应用；旧版 Web 重启 dsh web 后 Ctrl+F5），她就出现在右下角了。

在宿主页面按 F12 打开控制台，执行：

window.__dshWhaleMusumeBooted                                  // true
document.querySelectorAll('[data-dsh-whale-root]').length      // 1
getComputedStyle(document.querySelector('[data-dsh-whale-root]')).display  // "block"（首页可见）
window.__dshWhaleMoeDebug                                      // state 非 "hidden"，含当前姿势/视图等信息

四项都对说明安装成功。任一项不对，见故障排查。

另有一种脚本安装（注入前端资源 + 自带备份回滚），只适合主题集成或没有组合包支持的旧环境：见 scripts/apply-theme.mjs。两种方式二选一，不要混用。

看看她长什么样

更多素材：交互动作总览 · 新增立绘总览 · 宣传海报 v1 / v2 / v3 / v4

她有什么

🐋 本体与行为

💼 工作状态联动

📈 养成与成就

• 基础数值：心情、好感度、饱食度、等级、连续签到、陪伴时长
• 每日任务：3 个槽位每日自动刷新，完成领好感奖励
• 周签到：本周 7 格签到板，集满 1 / 3 / 7 天有里程碑奖励
• 羁绊等级：Lv3 解锁新待机动作、Lv5 称号「鲸汐守护者」、Lv7 隐藏彩蛋
• 39 个成就 + 成就墙：互动类 / 陪伴类 / DSH 用量类 / 游戏类 / 任务类，已解锁高亮、未解锁灰显
• 成长日记：按时间记录羁绊升级、成就解锁等节点，倒序显示最近 12 条

💬 台词与陪伴

• 530+ 条台词：全场景覆盖，可爱为主，叠加打工人 / 摸鱼 / DDL / 画饼 / 发疯文学等安全梗
• 梗关键词表情：命中 13 个关键词（kyun、OMG、doge、sike、膜拜、peace、怀疑人生、waku waku 等）现场变身表情包
• 5–8 分钟主动闲聊：按当前任务内容本地分类贴题，工作态绝不插嘴；深夜 23:00–5:59 不主动打扰
• 心情分层：心情低落时温柔、高涨时元气；羁绊等级解锁专属台词
• 天气陪伴：城市留空即零联网；填写后走 Open-Meteo（免费无需 Key），附带雨 / 雪 / 雷闪 / 风 / 雾 / 热浪 / 霜雾等全屏氛围特效，工作态自动降档
• 主动关怀：久坐提醒（连续忙 25 分钟）／深夜劝休息／卡住陪伴（状态停滞 8 分钟）／回来打招呼（离开超 3 分钟），两次之间至少隔 15 分钟
• 可选台词播报：检测到宿主装有 dsh-xiaomi-tts 服务时才会出现「台词播报」开关，默认关闭；未安装、未配置或播放失败都不影响原有交互

🎀 互动与视觉

• 分区点击：头 / 肚子 / 尾巴三区独立判定，各有专属立绘、特效与台词
• 点击特效：爱心 / 星星 emoji 飞出；三连击触发星星眼庆祝 + 粒子特效 + 旋转动画
• 90+ 张立绘：待机、工作中、思考、离开、成长四态、游戏四态、天气三态、节日五套（圣诞 / 万圣 / 中秋 / 春节 / 情人节，当天自动换装）
• 小游戏「戳泡泡·泡泡派对」：4×4 网格，普通 / 星星 / 炸弹三种泡泡，连击加分，30 秒一局三档结算；鼠标 + 键盘双通道可达；每日 3 局养成上限防刷

🧩 工程特性

• 零侵入：纯前端注入 + 一个只读静态资源路由，不改任何内置包文件
• 无构建步骤：仓库里的 assets/ 就是运行产物，装入即用
• 立绘预加载：首屏只预载 5 张常用姿势，其余 90+ 张在空闲时段每 120ms 取一张，冷启动切姿势不迟滞；预取失败完全静默
• 无障碍模式（默认关闭）：可 Tab 聚焦、Enter / 空格摸头、方向键微调位置（Shift 加速），状态变化经 aria-live 播报
• 主题跟随：跟随宿主明暗主题，只影响气泡/菜单这类 UI，立绘不做滤镜，不改画风
• 可测试性：核心状态机与表现层分离，142 项单元测试可直接 node --test 跑

兼容性

数据不互通：桌面端主窗口 origin 是 dsh-app://app，旧版 Web 是 http://127.0.0.1:<端口>，两边 localStorage（whale-moe:*）互不相通，也不会自动迁移。详见数据与隐私。

v2.2.0 适配桌面端时，逐条核对了 DSH 0.2.0-rc.2 的真实契约并写了证据文档（docs/desktop-0.2.0-rc.2-contract.md）：

这些行为都补了回归断言（test/desktop-client.test.mjs，34 项）。

第一次使用

装好后按顺序试一遍，一分钟知道她好不好用：

1. 点她一下 —— 脸红立绘 + 爱心特效；
2. 连点三次 —— 星星眼庆祝 + 粒子特效 + 旋转动画；
3. 拖着她走 —— 切「被拎起来」立绘、跟随光标摇摆，松手后滑行一小段并保存位置；
4. 右键她 —— 投喂 / 戳一下 / 夸夸 / 戳泡泡小游戏 / 回到原位 / 打开设置；
5. 跑一次工具调用 —— 她自动抱起笔记本，带淡蓝光晕；
6. 打开 设置 → 看板娘 —— 15 个开关、养成数据、成就墙、成长日记都在这里。

使用说明

拖拽

• 按住她移动，松手后位置自动保存；移动超过 4px 才进入拖拽状态（所以单击不会误触发拖拽）
• 右键 → 回到原位 恢复默认右下角

右键菜单

设置面板

路径：DSH 设置 → 看板娘（共 15 个胶囊开关 + 6 个折叠分组）。

默认关闭（涉及读取聊天内容或账户金额）：关键词感知、余额关心、余额显示数字、台词播报、无障碍。

更新 / 回滚 / 卸载

更新

# 桌面端：升级后重启桌面端应用
& "$Desktop\DeepSeek Harness.exe" --expose-internals $Cli plugin --profile desktop add github:Sutera-Diffusus/dsh-whale-musume

# 旧版 Web：升级后重启 dsh web 并 Ctrl+F5
dsh plugin --profile web add github:Sutera-Diffusus/dsh-whale-musume

更新不会动你的养成数据（whale-moe:* 留在宿主 origin 的 localStorage 里）。

卸载

# 桌面端
& "$Desktop\DeepSeek Harness.exe" --expose-internals $Cli plugin --profile desktop remove dsh-whale-musume

# 旧版 Web
dsh plugin --profile web remove dsh-whale-musume

组合包方式无任何残留文件改写，卸载即干净移除；养成数据仍保留，重装后还在。只想让她暂时消失的话，直接关掉设置面板里的「看板娘」开关即可。

脚本安装方式

脚本会在 DSH_WHALE_BACKUP（默认系统临时目录）生成备份，回滚：

node scripts/apply-theme.mjs --rollback "<backup dir>"

版本更新