前言¶
在 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
