前言¶

在 DeepSeek Harness（DSH）里长时间跑任务、盯日志，界面往往只有任务流和工具状态，缺少一点「有人在旁边」的反馈。常见做法是开第二个窗口放视频或静态壁纸，但那和当前任务没有联动，也容易分散注意力。

dsh-whale-musume（社区称「鲸鱼娘」）是面向 DSH 的桌面看板娘插件：悬浮在页面一角，待机时做小动作，检测到工具运行就切到「抱笔记本工作」姿势，还能摸头、养成、玩小游戏。资源与状态默认都在本机，README 写明无遥测、无外部请求；天气功能可选联网，城市留空则零联网。下面介绍它是什么、能做什么，以及两种官方安装方式怎么选。

这是什么¶

dsh-whale-musume 由维护者 Sutera-Diffusus 发布，当前版本 1.4.1，MIT 许可证，适配 DSH 0.1.0-rc.6 或同系列版本。在 SkillHub 社区目录中归类为「趣味换装」，GitHub 仓库约 32 stars。

一句话定位：纯前端注入的 DSH 桌宠插件——不改动 DSH 业务 DOM，通过脚本或 bundle 把样式、脚本和 90+ 张立绘挂进 Web 界面，在右下角（或你拖到的任意位置）陪伴写代码。

核心功能¶

看板娘本体与工作状态联动¶

默认 200px 悬浮形态，支持拖拽；拖拽时切换「被拎起来」立绘，身体随光标方向摇摆。待机时随机喝咖啡、伸懒腰等小动作；待机与工作状态之间用「下压 → 换图 → 弹起」过渡，避免叠影或闪黑。

当页面检测到工具运行（data-running / data-state="ongoing"）时，鲸鱼娘自动切到抱笔记本姿势，带淡蓝光晕和「工作中」标签。工作状态下点击会随机出现害羞或偷吃内存条等反应，不打断 running 姿势，也不随机切小剧场。

立绘、台词与互动¶

立绘覆盖待机、工作、思考、离开，以及摸头 / 戳肚子 / 戳尾巴分区互动；另有成长、游戏四态、天气三态、节日换装（圣诞 / 万圣 / 中秋 / 春节 / 情人节），以及 13 种梗关键词触发的表情包变身。

台词库 530+ 条，5–8 分钟按任务内容本地贴题闲聊；工作态不插嘴。分时问候覆盖白天各时段，深夜 23:00–5:59 不主动打扰。心情与羁绊等级（Lv3 / Lv5 / Lv7）解锁不同台词。

单击摸头触发脸红与粒子；三连击星星眼庆祝；右键菜单提供投喂、戳一下、夸夸、小游戏、回到原位、打开设置。

小游戏与养成¶

小游戏「戳泡泡·泡泡派对」：4×4 网格，普通 / 星星 / 炸弹三种泡泡，30 秒一局；支持鼠标与方向键 + Enter / Esc。每日 3 局计入养成奖励，超出只计分。

养成维度包括心情、好感、饱食、等级、连续签到、陪伴时长。每日 3 个任务槽、周签到板、39 个成就，设置面板内有成就墙。羁绊 Lv3 解锁新待机动作，Lv5 称号「鲸汐守护者」，Lv7 隐藏彩蛋。

天气与设置¶

路径：DSH 设置 → 看板娘。分组包括陪伴表现、天气、日常与养成、成就墙、数据与重置。胶囊开关可单独关闭看板娘、台词气泡、粒子、小游戏、关键词感知、摸鱼提醒、深夜模式、天气特效等。

天气在设置里填城市（API Key 选填）；Open-Meteo 免费且无需 Key，城市留空则不联网。开启天气特效后，雨 / 雪 / 雷等全屏氛围随真实天气切换，工作态自动降档。

工程侧特点¶

核心状态机（whale-moe-core.js）与 DOM 表现层分离；安装脚本自带备份与回滚；资源 URL 带版本号便于刷新缓存。仓库含 97 个单元测试，另有 CDP 与动效 QA 脚本供二次开发参考。

安装与启用¶

安装前确认：Windows 10 / 11（官方开发与测试环境）、Node.js 18+（脚本安装需要）、Edge / Chrome 最新版。脚本方式会改写 DSH 安装目录中的前端资源，建议先关闭 DSH 页面并记录当前 DSH 版本；安装脚本输出里的 Backup: 路径请保留到验证无误。

DSH 安装目录通常含 DeepSeekHarness-Launcher.exe 和 node_modules；不确定时可读启动器配置中的 workDir：

Get-Content "<DSH_INSTALL_DIR>\DeepSeekHarness-Launcher.cfg"

方式一：组合包安装（零侵入，推荐新用户）¶

插件声明了 dsh.bundle.patch，可直接用 DSH 插件命令安装，无需脚本改内置包：

dsh plugin --profile web add github:Sutera-Diffusus/dsh-whale-musume

安装后重启 dsh web，在浏览器打开 DSH（默认 http://127.0.0.1:3080），强制刷新（Ctrl + F5），右下角应出现鲸鱼娘。此模式下宿主只注册 /api/dsh-whale-musume/assets 静态资源路由，浏览器侧注入本体；齿轮菜单与 localStorage（键名 whale-moe:）管理开关与养成数据。

方式二：Release 脚本安装（主题集成场景）¶

先做第 1 步，从 Releases 下载 dsh-whale-musume-plugin-vX.Y.Z.zip 并解压，例如 D:\dsh-whale-musume。

再做第 2 步，在插件目录执行两条安装命令：

node scripts/apply-theme.mjs --assets-only --target "<DSH_INSTALL_DIR>"
node scripts/apply-theme.mjs --mascot-settings --target "<DSH_INSTALL_DIR>"

也可用环境变量指定目录：

$env:DSH_INSTALL_DIR = "<DSH_INSTALL_DIR>"
node scripts/apply-theme.mjs --assets-only
node scripts/apply-theme.mjs --mascot-settings

经过上面的步骤，刷新 DSH 页面并验证：单击有脸红特效、三连击星星眼、拖拽切换拎起姿势、设置页出现「看板娘」栏目。

两种安装方式二选一，不要混用。临时关闭可在设置里关掉「看板娘」开关，资源仍保留。

典型用法¶

拖拽与位置¶

按住鲸鱼娘移动，松手后位置写入 localStorage；右键 → 回到原位 恢复默认右下角。

右键菜单¶

更新与回滚¶

更新：下载新版 zip，覆盖 assets/ 和 scripts/，重新执行脚本安装的两条命令，再强制刷新。

回滚示例：

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

卸载脚本注入时，对设置与资源各执行一次带 --rollback 的 apply-theme.mjs；bundle 模式按 DSH 插件管理流程移除即可。

适用场景与注意¶

适合希望在 DSH Web 界面里获得轻量陪伴、又不想开额外窗口的开发者。工作状态与 DSH 任务流联动，摸鱼小游戏和成就系统适合长时间挂机场景；需要克制打扰时可关台词气泡、深夜模式或整个看板娘开关。

务必注意：

1. 插件随 DSH 进程与浏览器上下文运行，安装前应阅读源码与 MIT 许可证，确认接受脚本改写前端资源或 bundle 注入的方式。
2. 官方测试环境为 Windows；其他系统需自行验证脚本与 bundle 是否可用。
3. 隐私方面，README 声明默认不发送遥测、不上传数据；养成数据在 localStorage（whale-moe: 前缀），不含 API Key 或凭据。仅在你主动配置天气城市或 API Key 时才会发起天气相关请求。
4. 刷新后看不到鲸鱼娘：确认安装输出含 Applied、强制刷新、检查「看板娘」开关；设置页无栏目时需确认 DSH 版本兼容并执行 --mascot-settings。

结尾¶

dsh-whale-musume 把看板娘、任务状态联动、本地养成和小游戏收进 DSH 同一页面，用 bundle 或脚本两种路径接入。若你正在 SkillHub 或 GitHub 浏览 DSH 插件，可以把它当作「趣味换装」类里功能较完整的一款桌宠方案。

• 社区目录：SkillHub - dsh-whale-musume
• 源码与文档：GitHub - Sutera-Diffusus/dsh-whale-musume