前言¶
DeepSeek Harness (DSH) 运行时，进程在后台运行，状态变化难以直接感知。为了解决这个痛点，引入鲸娘桌宠插件，通过桌面浮窗实时反馈工作状态。
插件定位¶
这是一个运行在鲸港 WhaleHarbor 上的桌面宠物插件，由 MoonlitDropOfBlood 维护。它通过 2D 拆件与 CSS 动画技术，将 DeepSeek Harness 的运行状态映射到桌面上。
核心功能¶
- 2D 拆件 + CSS 动画：原画拆分为 13 个零件（底座、眼、嘴等），通过 CSS keyframes 驱动呼吸、眨眼、汗滴等动作，支持 60fps 动画。
- 实时状态反映：支持空闲、忙碌、审批等待、提问等待、出错、完成庆祝、打盹、子代理分身等 8 种状态切换。
- 桌面交互：支持拖动、戳一戳（点击）、右键菜单（小/中/大号尺寸切换）、托盘菜单。
- 气泡副栏：实时统计本次开机工具调用数、累计忙碌分钟、被戳次数。
- 浮窗特性：透明置顶浮窗，不抢焦点，避免打断工作流。
安装与启用¶
安装命令如下：
dsh plugin --profile web add @duke-dsh-plugins/dsh-whaleharbor-pet
国内网络环境下，请显式指定 --registry=https://registry.npmjs.org 以避免镜像源干扰。
装完必须重启 DSH 核心（Ctrl+Alt+R 或设置 → 核心 → 重启）才能生效。
典型用法¶
本地开发时，可使用 node 命令导出浮窗页面：
node -e "console.log(require('./index.js')._buildPetPage())"
浏览器直接打开生成的 index.html，可添加参数 ?mood=xxx 钉死特定状态进行预览。
适用场景与注意¶
- 平台要求：需要 WhaleHarbor 桌面壳提供浮窗能力（当前仅发布 Windows 构建）。纯浏览器或 CLI 启动时插件会安静空转，无副作用。
- 浮窗限制：每插件浮窗限额 3 个，全局限额 6 个；本插件仅使用 1 个。
- 窗口行为：改变浮窗大小会关闭并重建浮窗，位置会重置为默认。
- 降级处理：零件缺失时自动退回占位鲸鱼，不会白屏。
- 状态同步：
float.window.state为替换最新值语义，页面刷新时会自动补发最新状态。
总结¶
该插件通过可视化的方式解决了后台进程状态不透明的问题，适合需要监控 DSH 运行状态的开发者。
