这是什么
一个 DeepSeek Harness（DSH）桌宠插件。工作时它待在角落替你盯着任务：跑起来了它会巡游，出错会发抖冒火，要你审批会蹦跳提醒，完成了会顶着一条通到页底的水柱横渡整屏庆祝。
它有两种形态：住在 DSH 页面里，或者悬浮在整台电脑的一切窗口之上（任意应用、任意全屏 Space，鲸鱼之外全部鼠标穿透）。
✨ 亮点
- 🖥️ 桌面悬浮模式 —— 用 DSH 自带的运行时开出全屏透明置顶窗口，鲸鱼真正出圈
- 🔔 任务提醒 —— 运行中 / 等待审批 / 出错 / 完成，四种状态四种表现，审批和提问直接在气泡里处理
- 🎭 情绪反应 —— 失败抖动冒火、等待蹦跳、完成时全屏水帘庆祝
- 🚿 摇晃喷水 —— 抓住鲸鱼甩一甩，像素水帘从天而降、在屏幕底堆积摊平化光
- 🎲 摸头盲盒 —— 单击摸摸头，50% 冒爱心、50% 喷一股水
- 🗺️ 自动巡航 —— 不定期离家溜达一圈，频率可调
- 🧩 可编程 ——
window.dshPetWhale 脚本接口，任务状态和全部操作开放
完整功能与参数见 功能全览。
🖼️ 更多实拍
📦 安装
- 克隆本仓库到固定位置：
git clone https://github.com/15372010668-dot/dsh-pet-whale.git ~/dsh-plugins/dsh-pet-whale
HTTPS 连接不稳定时改用 SSH（默认 22 端口不通就走 443 备选）：
git clone git@github.com:15372010668-dot/dsh-pet-whale.git ~/dsh-plugins/dsh-pet-whale
git clone ssh://git@ssh.github.com:443/15372010668-dot/dsh-pet-whale.git ~/dsh-plugins/dsh-pet-whale
- 在 DSH profile 的
package.json 中引用：
{
"dependencies": { "dsh-pet-whale": "link:~/dsh-plugins/dsh-pet-whale" },
"dsh": { "profile": { "bundles": ["...", "dsh-pet-whale"] } }
}
- 在 profile 目录执行
pnpm install --offline，重启 DSH；
- ⚠️ 若被 DSH 版本校验静默拦截（装了没反应），需按 manifest 授一次豁免：
dsh plugin --profile desktop allow-version dsh-pet-whale@1.2.0 --dsh-version <你的DSH版本> --accept-risk
目前仅支持 macOS（悬浮模式依赖 DSH 自带的 Electron 运行时）。数据目录在 ~/.dsh/pet-whale/，卸载不丢宠物。
🎮 交互
| 动作 | 反应 |
|---|
| 单击 | 摸头：挥手压扁，50% 爱心 / 50% 喷水 |
| 双击 | 跳跃 |
| 拖动 | 移动位置（自动记忆）；摇晃会喷水 |
| 右键 | 菜单：设置、收起、恢复通知等 |
🛠 开发
npm run check # 语法检查（4 个入口文件）
npm test # 69 项自动化测试：宿主 HTTP / 漫游引擎 / 通知状态机
npm run sync # 同步到本地 DSH 插件目录
lib/*.js 为直接维护的 esbuild 产物，架构与血统说明见 FORK.md。
📜 License
Apache-2.0。本项目是 @michengai/dsh-codex-pet 的衍生作品，上游署名与第三方素材声明见 NOTICE。
