一、它是什么
dsh-whale-girl-pet 是一个 DeepSeek Harness（DSH）的 Web 插件——不是独立 EXE 桌宠，而是挂载在 Harness 网页界面里的悬浮角色。
当前版本：
0.3.10
许可：MIT
作者：yanzwzz（社区作品，非 DeepSeek 官方出品）
它由两半组成：宿主侧（Node，负责计费/路由/事件）＋ 浏览器侧（React，负责渲染与交互），所以任何更新都必须重启 DSH 进程，刷新页面不够。
二、安装链接
安装不下载 zip、不点安装包，一条命令即可：
--profile后面填你实际在用的 profile 名。桌面版（Electron）默认是desktop，CLI 用户通常是web或tui。填错的表现是「命令成功了，但界面里没有」。国内网络拉 npm 慢的话，可以显式指定镜像（
dsh plugin会把参数透传给 pnpm）：
装指定版本：dsh plugin --profile web add dsh-whale-girl-pet@0.3.10 从本地 tarball 装：dsh plugin --profile web add ./dsh-whale-girl-pet-0.3.10.tgz
三、装完必做：重启
重启后打开 Web 界面，右下角就出现她了。
为什么必须重启：DSH 在进程启动时把插件的浏览器 bundle 载入内存，并按 URL 缓存编译结果；宿主侧路由同理。只按 F5 刷新页面，你看不到任何变化——这是最常见的「装了没反应」。
验证装上了没有（以 web profile 为例）：
package.json 里应能看到两处变化：
还可以探一下她的只读接口（正常返回 JSON）：
四、兼容性（这一节决定她能不能出现）
作者在 README 里写得很细，我提炼成三句话：
已验证：DSH
0.1.7-alpha.1与0.2.0-rc.1均可正常工作（32 项自检通过）。
peer 范围是
^0.2.0-rc.1：pnpm 的 semver 规则要求预发布版本必须点名同 patch 才算满足，所以 DSH 每换一条 alpha 线，这个范围都要跟着走。
DSH ≥ 0.2.0 会在启动前做兼容性预检：范围不满足 → 该 bundle 被拒绝加载，日志里是
skipping profile bundle，表现就是桌宠完全不出现（不是加载了但看不见）。
遇到第 3 种情况，两个办法：把 DSH 升/降到兼容版本线，或在 profile 目录给这个包做 exact-version 豁免。别去改 node_modules 里的 package.json——下次 pnpm install 就被覆盖。
历史坑（如果你在旧版本上）：DSH 0.1.7 有三处破坏性变更（SettingsProvider → SettingsForms、jobs.onJobDone → jobs.events.subscribe、shell.run → shell.execute），0.3.2 及更早的版本在 0.1.7 上会整体失效，apply() 抛 TypeError，DSH 判定该 entry「did not activate」，桌宠直接消失。0.3.3 起已适配，并且把每段可选功能各自兜住——以后单个 API 漂移只会丢那一个功能，不会让她从页面上消失。
五、她都会干什么
工作链路：开工时变出悬浮电脑桌开始敲键盘；工作中每 10.5 秒在「认真工作 / 工作摸鱼 / 工作思考 / 摸鱼被抓」之间随机切换；收工伸懒腰 → 比耶庆祝；忙的时候点她会「惊到 → 嫌弃 → 继续干」；长任务超时会看表叹气（阈值可调）。
钱相关的三件套（这是它最实用的部分）：
计价口径：按 DeepSeek 官方价目，按每条用量的事件时间选档，所以跨调价、跨峰谷的一次任务也能算准；高峰为北京时间工作日 9:00–12:00、14:00–18:00（空闲价 2 倍），周末与法定节假日整天按空闲。子代理的开销也计入。
📊 分时段看板：手写内联 SVG，零图表依赖。今日分时 / 近 7 天两种视图，花费 ↔ token 一键切换，三桶堆叠柱、高峰底纹、当前时段高亮、悬停 tooltip；可拖动、可缩放，位置尺寸记住。
其它：💰 余额与今日花费、☁️ 明日天气（wttr.in，中文城市名或自动定位）、🍪 投喂「TOKEN 小鱼干」、😴 空闲 5 分钟自动入睡、🕐 时间感知（早上睡眼惺忪、12 点吃盒饭、深夜犯困）、46+ 个透明 WebM（VP9 alpha）动画。
六、配置放在哪
设置面板：DSH 设置 → 桌宠配置，改完即时生效。
落盘位置随 DSH 版本变过，这点容易踩：
DSH ≤ 0.1.6：写在
$DSH_HOME/settings.yaml的whale-pet:段
DSH ≥ 0.1.7：写在 profile 补丁
$DSH_HOME/profiles/<profile>/cordis.patch.yml里该插件条目的config
升级后旧的
settings.yaml会被 DSH 一次性改名成settings.yaml.imported，第三方插件的段不会自动导入，需要手工搬。
常用项：番茄钟间隔、深夜关怀、随机小剧场、漫游开关、按钮左右、看板历史补扫、看板窗口天数、长任务阈值、天气城市、尺寸（40–400px，可拖动编辑框调整）、固定坐标 X/Y、默认角落、隐藏宠物（贴边偷看）。
注意：位置、尺寸、看板窗口状态存在浏览器 localStorage，跟 Web GUI 的地址绑定。换了端口或清了浏览器数据，外观会重置一次。
七、进阶：把素材放到别的盘
插件会从 $DSH_HOME/pet-assets/ 读 1200×1200 的原始母版素材（/pet/full/<动画名>.webm）。这些是可选的，不下载也能用，会退回内置缩略素材。
想把它们放到 D 盘，用目录联接（Junction）即可，不用改插件：
删除联接时不要加 -Recurse，否则会把 D 盘素材一起删掉：
八、排错清单
九、卸载
然后重启 DSH。若要一并清理：
十、两点说明
不是官方插件。DeepSeek 官方没有发布过任何桌宠/鲸鱼娘插件，npm 上
@deepseek-ai作用域里全是 harness 基础设施（dsh-base、dsh-fs、dsh-session…）。这个插件是社区作者 yanzwzz 写的，用爱发电，MIT 协议。
它会读你的用量数据。计费、余额、看板都建立在会话事件之上，这是它工作的前提；数据只在本地处理，请求只发往 DeepSeek 官方接口（余额）和 wttr.in（天气），没有第三方上报。