前言¶

在 DSH 中跑任务时，经常需要切换回主界面确认状态。长任务、卡在授权环节时，这种切换成本很高。DSH macOS Pet 解决这个问题，它是一个浮在所有窗口之上的 macOS 桌宠，实时显示 Agent 的状态。

它不需要你切换窗口，也不占用 DSH 页面的任何空间。你只需要瞄一眼屏幕角落，就能知道现在的 Agent 是在干活、等待授权，还是已经跑完了。

安装与启用¶

在安装之前，确保你的环境已经配置好 DSH。使用以下命令安装插件：

dsh plugin --profile web add dsh-macos-pet

安装完成后，启动 DSH Web 页面即可看到桌宠浮在桌面之上：

dsh web

如果是从旧版本升级，需要指定 @latest：

dsh plugin --profile web add dsh-macos-pet@latest

如果不安装 DSH，只想单独运行这个程序，可以直接克隆仓库并运行 ./bin/dsh-macos-pet。

功能特性¶

这个插件通过一个原生 macOS 窗口展示 Agent 的状态，覆盖在所有窗口之上。

状态监控¶

宠物会跟随本地 DSH 自动改变状态，无需额外配置。主要包含以下几种状态：

• 空闲：无事可做，会呼吸、偶尔眨眼。
• 干活：DSH 正在执行任务。
• 等你：卡在确认或授权环节。
• 报错：任务执行失败。
• 开心：刚跑完一轮，3.2 秒后自动回落到空闲。
• 睡着：Agent 闲着且鼠标也不动时才会打盹，任何动静或戳它一下都会唤醒。

皮肤系统¶

插件内置了 7 种皮肤，支持深索鲸、蓝鲸、线核、鹦鹉螺、水母、Claude 和星星。每套皮肤包含六个状态，每个状态三帧动画。

此外，插件支持从一张图片 DIY 生成皮肤。利用插件自带的技能，可以让 Agent 将一张图扩写成一套皮肤所需的十八个姿势。生成的皮肤保存在 ~/.dsh-macos-pet/skins/ 目录下，升级插件时不会丢失。

常用操作¶

你可以通过右键菜单或命令行参数来控制宠物。

调整大小¶

调整宠物的显示大小：

./bin/dsh-macos-pet --scale 0.5

（默认大小为 0.7）

指定皮肤¶

启动时指定使用的皮肤：

./bin/dsh-macos-pet --skin jellyfish

生成皮肤预览图¶

制作好皮肤后，可以使用以下命令将六个状态拼成一张图以便预览：

./bin/dsh-macos-pet --skin-sheet <你的皮肤id>

其他操作¶

• 重置设置：./bin/dsh-macos-pet --reset
• 停止宠物：./bin/dsh-macos-pet --stop
• 前台运行：./bin/dsh-macos-pet --foreground（日志会输出到当前终端）

注意事项¶

在决定使用之前，请注意以下几点：

• 系统限制：仅支持 macOS。Windows 和 Linux 未测试。
• 交互逻辑：宠物四周有一圈透明边距，点击该区域不会穿透到后面的窗口。
• 缺少的功能：当前版本没有设置窗口和贴边的 mini 模式。
• 生成进度：生成皮肤时不显示进度条，只能通过 Agent 的输出查看。
• 零依赖：插件不依赖其他第三方库，使用系统自带的 Python 运行。

参考资料¶

• GitHub 仓库：Dkrillex/dsh-macos-pet
• 社区目录：DSH macOS Pet