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