前言¶
在 DSH 的插件生态里，本地 agent 的状态仍然需要靠终端、日志或网页确认。dsh-desk-pet 把这件事放到桌面上：它是 macOS 上的 DeepSeek Harness 桌宠，用真实窗口跟随本地 DSH agent 的状态变化，也支持用一张图片生成自定义皮肤。
下面介绍它的功能、安装命令和常用参数。
这是什么¶
anneheartrecord/dsh-desk-pet 由 anneheartrecord 维护，许可证为 MIT。
它的定位是 macOS 桌宠插件：提供真实 macOS 窗口，可浮在全屏应用之上，用于显示 DSH agent 的当前状态。
核心功能¶
状态显示¶
插件跟随本地 DSH agent 的状态变化，状态包括：
- 空闲
- 干活
- 等你
- 报错
- 开心
- 睡着
皮肤¶
内置五套皮肤，每套覆盖六个状态，每个状态三帧。
也可以把一张图片交给插件自带的 skill，用于生成自定义皮肤。生成过程使用用户自己的生图工具和额度，插件不上传素材。
自定义皮肤保存在：
~/.dsh-desk-pet/skins/
该目录位于安装包外，升级插件不会删除。
窗口与菜单¶
窗口是真实 macOS 窗口，可浮在全屏应用之上。
右键菜单提供：
- 会话清单
- 免打扰
- 皮肤
- 宠物位置
- 项目主页
- 检查更新
- 退出
运行要求¶
插件零依赖，使用系统自带 Python。
只支持 macOS；Windows 和 Linux 未测试，短期不打算做。
安装与启用¶
如果已经安装 DSH，先添加插件，再启动 dsh web：
dsh plugin --profile web add deepseek-desk-pet
dsh web
从旧版本升级时，需要带 @latest：
dsh plugin --profile web add deepseek-desk-pet@latest
不带 @latest 时，caret 版本范围可能锁住次版本号。
如果想使用 GitHub 的 main 分支，可以执行：
dsh plugin --profile web add github:anneheartrecord/dsh-desk-pet#main
注意包名是 deepseek-desk-pet，仓库名是 dsh-desk-pet，两者不一致。
插件以当前 dsh 进程权限运行；安装前建议检查源码和 MIT 许可证。
典型用法¶
启动与停止¶
也可以直接运行可执行入口：
./bin/dsh-desk-pet
停止当前宠物：
./bin/dsh-desk-pet --stop
启动参数¶
指定启动时使用的皮肤：
./bin/dsh-desk-pet --skin jellyfish
调整大小：
./bin/dsh-desk-pet --scale 0.5
执行重置：
./bin/dsh-desk-pet --reset
前台运行：
./bin/dsh-desk-pet --foreground
自检：
./bin/dsh-desk-pet --probe
查看皮肤帧清单：
./bin/dsh-desk-pet --inventory
使用 --skin-sheet 生成皮肤 sheet，并传入皮肤 id：
./bin/dsh-desk-pet --skin-sheet <你的皮肤id>
适用场景与注意¶
适合 macOS 上本地使用 DSH 的场景。
使用时需要注意：
- 宠物四周透明边距上的点击不会穿透到后面的窗口。
- 当前没有设置窗口，也没有贴边 mini 模式。
- 生成皮肤时插件侧不显示进度，只能查看 agent 输出。
- 生成自定义皮肤使用用户自己的生图工具和额度，插件不上传素材。
- 从旧版本升级时，需要带
@latest，否则 caret 版本范围可能锁住次版本号。 - 包名是
deepseek-desk-pet，仓库名是dsh-desk-pet，两者不一致。 - 插件以当前
dsh进程权限运行，安装前应检查源码和许可证。
结尾¶
dsh-desk-pet 的价值比较直接：在 macOS 桌面上用真实窗口显示 DSH agent 状态，并支持用一张图片生成自定义皮肤。
社区目录页：https://www.skillhub.cn/plugins/anneheartrecord/dsh-desk-pet
