前言¶
用 DeepSeek Harness（DSH）跑智能体时，任务进度和审批请求多半只在终端或 Web 界面里出现。窗口切走之后，很难一眼判断「还在跑」还是「等你点同意」。下面介绍 dsh-desktop-pet，它把基于 vlln/whale-girl 的鲸鱼娘桌宠，适配到 Linux 与 Windows 桌面，让 DSH 的执行状态留在屏幕一角。
这是什么¶
dsh-desktop-pet 由 xiaoshihou514 维护，在 SkillHub 社区目录中归类为「趣味换装」。项目自述为「DeepSeek Harness：鲸鱼娘桌宠」，当前版本 v0.1.0（MIT 许可）。
它包含两部分协作关系，README 写得很清楚：
- DSH 插件侧：通过
whale-girl插件与 Harness 通信。 - 桌面应用侧：独立安装的「大肥鱼」客户端（
productName: dafeiyu），负责在桌面上展示角色与状态。
维护者在 README 中注明：这是对 @vlln 作品的 Linux / Windows 桌面版适配。
核心功能¶
根据 README 与 package.json，目前可核实的能力如下：
- 桌面桌宠展示：角色可在桌面常驻，README 配图展示了多套外观。
- 任务状态可视化：运行时可显示「干活进度」。
- 审批提醒：可反映当前是否需要用户审批。
- 跨平台桌面包：发行版提供 Linux AppImage、RPM，以及 Windows 安装包与便携版。
桌面端基于 Electron 构建（npm run start 为 electron .），打包脚本同时保留 Tauri 相关命令；日常安装以 Releases 预编译包为主。
安装与启用¶
下面按 README 给出的顺序操作。插件以当前 dsh 进程权限运行，安装前建议浏览仓库源码并确认 MIT 许可证。
1. 安装 DSH CLI¶
npm i -g @deepseek-ai/dsh
全局安装 @deepseek-ai/dsh，后续用 dsh plugin 管理插件。
2. 添加 whale-girl 插件¶
dsh plugin --profile web add "github:vlln/whale-girl#main"
README 使用 --profile web，插件源为 vlln/whale-girl 的 main 分支。这是桌面伴侣与 Harness 通信的插件入口，不要自行改成其他仓库名。
3. 安装桌面客户端¶
在发行版页面下载对应平台的安装包：
https://github.com/xiaoshihou514/dsh-desktop-pet/releases
Linux 可选 AppImage 或 RPM；Windows 可选 NSIS 安装包或 portable 便携版。装好后启动「大肥鱼」即可与已配置的 DSH 环境配合。
典型用法¶
完整链路可以概括为三步：
- 全局安装
dsh，并用上面的命令添加whale-girl插件。 - 按常用方式启动 DSH 会话（Web profile 与安装命令中的
--profile web对应）。 - 打开桌面端「大肥鱼」，观察角色旁的任务进度与审批状态变化。
README 未给出更细的 CLI 子命令示例；状态展示依赖 DSH 与 whale-girl 插件的正常通信，桌面端负责渲染。
适用场景与注意¶
适合谁
- 长时间开着 DSH 跑任务，希望桌面一角持续反馈进度的人。
- 需要醒目感知「等待审批」、又不想反复切回终端或浏览器的人。
- 喜欢桌宠交互、并接受「趣味换装」类 UI 的开发者。
使用前注意
- 插件与 DSH 以当前用户权限运行；
add之前请检查vlln/whale-girl与xiaoshihou514/dsh-desktop-pet的源码与许可证。 - 桌面端是独立应用，需从 Releases 单独下载，不能只装 CLI 插件就期望出现桌宠窗口。
- 项目版本为 0.1.0，API 与打包形态可能随版本调整，以 GitHub 仓库为准。
- SkillHub（目录页）是社区插件目录，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本仓库是其中一例。
