🐋 鲸鱼娘 v2.2.0｜陪你写代码的桌宠，现已支持桌面端（Electron 壳 + DSH 0.2.0-rc.2）

[Sutera-Diffusus]

🐋 鲸鱼娘 · dsh-whale-musume — 陪你写代码的桌宠，v2.2.0 起同时支持桌面端

她是谁

一只会陪你写代码的鲸鱼娘：待机时安静陪在角落，检测到工具运行就抱起笔记本陪你干活；可以摸头养成、解锁成就，也可以拖着她到处走。所有资源本地运行，无遥测、无外部请求。

有什么

• 工作状态联动：跑命令、改文件、搜索、测试、评审、部署、调试各有对应姿态；工作态绝不插嘴
• 养成：心情 / 好感度 / 饱食度 / 等级 / 连续签到 / 陪伴时长，每日任务 + 周签到 + 羁绊等级（Lv3/Lv5/Lv7）
• 90+ 立绘：待机、工作中、思考、离开、摸头/戳肚/戳尾巴分区互动、成长四态、游戏四态、天气三态、节日五套（圣诞/万圣/中秋/春节/情人节）
• 39 个成就 + 成就墙 + 成长日记
• 530+ 条台词：打工人 / 摸鱼 / DDL / 画饼 / 发疯文学等安全梗；13 种梗关键词表情（kyun、OMG、doge、sike、膜拜、怀疑人生、waku waku…）
• 天气陪伴：城市留空零联网；填了走 Open-Meteo（免费无需 Key），附带雨/雪/雷闪/雾等全屏氛围特效，工作态自动降档
• 主动关怀：久坐提醒、深夜劝休息、卡住陪伴、回来打招呼 —— 铁律是「陪着，不是指挥」
• 小游戏「戳泡泡·泡泡派对」：4×4 网格，键鼠双通道可达，每日 3 局养成上限防刷
• 无障碍模式（默认关闭）：可 Tab 聚焦、Enter/空格摸头、方向键微调位置，状态变化经 aria-live 播报
• 可选联动：检测到 dsh-xiaomi-tts 时多一个「台词播报」开关（默认关闭）

v2.2.0：桌面端适配（本轮重点）

同一份插件现在双端支持：DeepSeek Harness 桌面端（Electron 壳，内嵌 DSH 0.2.0-rc.2）与旧版 Web。

桌面端做适配时踩到并修掉的几个真问题，可能对其他插件作者也有参考价值：

问题	现象	处理
引导弹窗被误判成设置页	刷新后常驻的 OnboardingModal 也是 role="dialog"，桌宠被 display:none 永久隐藏	判据收敛到真正打开的面板根 [data-shortcut-modal="settings"]
工具卡标记换代	旧版 [data-role="tool"] 等在 0.2.0-rc.2 0 命中	改用 [data-tool]（值=工具名）+ 同元素 data-state
历史工具卡钉住忙态	卡片完成后仍留在 DOM（ok/stopped），按存在性匹配会让桌宠永远摆 running	只认 running / preparing 为「正在工作」
主题属性搬家	桌面端明暗写在 body[data-ds-dark-theme]（空串=暗）+ html[data-ds-theme-source]	补齐识别，旧 data-theme/dark class 保留为回落
冷启动误判工作态	toolGoneAt 初值 0 被当成「刚消失的工作信号」，首屏摆 running 并念工具台词	初值改为远期过去
惰性 CJS 契约	0.2.0-rc.2 要求副作用发生在 factory 物化期	boot() 从 apply() 移入 factory 体内

完整的逐条契约审计（带 DSH 源码行号证据）：docs/desktop-0.2.0-rc.2-contract.md
布局/主题等行为都补了回归断言：单元测试 142/142（含 34 项桌面端契约回归），CI 在 Node 18/22 上跑。

安装

桌面端（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

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

注意：桌面端主窗口 origin 是 dsh-app://app，与旧版 Web 的 localStorage 不互通，桌面端首次打开是全新养成数据（不会自动迁移）。

设置面板

装好后在 DSH 设置 → 看板娘：陪伴表现 / 天气 / 余额 / 日常与养成 / 成就墙 / 成长日记 / 数据与重置，共 15 个胶囊开关。默认关闭的是涉及隐私的那几个（关键词感知会读聊天内容、余额关心会读账户金额、无障碍、台词播报）。

隐私

• 状态全部存本机 localStorage（whale-moe:*），不含任何 API Key；
• 无遥测、不上传数据；
• 天气城市留空即零联网；
• 余额功能默认关闭，开启后也只访问本机余额代理 127.0.0.1:3020；
• 纯 DOM 注入，不修改 DSH 业务 DOM，不改任何内置包文件；卸载即干净移除。

链接

• 仓库：https://github.com/Sutera-Diffusus/dsh-whale-musume
• Release：v2.2.0（MIT）
• CHANGELOG · 版本更新栏 · English README

有任何问题、想要的功能或踩到的坑，欢迎在这条下面回帖，我会跟。🐳