前言¶
使用 DeepSeek Harness 時，Agent 在後臺運行，你很難感知當前進度。PetPal 是一個桌面寵物插件，把 petdex.dev 的寵物展示在桌面上，並通過企業微信把關鍵狀態推到手機。它不搶焦點、不佔 Dock，適合在瀏覽器、IDE 或其他應用中作爲常駐提示。
是什麼¶
PetPal（dsh-petpal）由維護者 flowers-59f 開發，歸類爲「趣味換裝」類插件。它把 petdex.dev 的寵物下載到 DSH 自己的寵物目錄，再由插件自帶的原生桌面小應用在桌面上渲染。寵物會根據 Agent 的狀態移動和顯示氣泡，需要你確認或一輪工作結束時，通過企業微信機器人推送消息。
核心功能¶
- 寵物庫：按寵物頁面鏈接或標識（slug）從 petdex.dev 下載，直接落到
~/.dsh/pets，可切換、可刪除。 - 桌面常駐：原生桌面端（macOS Swift + WKWebView / Windows C# WPF），透明置頂、不搶焦點、不進任務欄。
- 外觀自定義：大小 50–200%、氣泡字號/寬度/停留、背景色、文字色、整體不透明度、點擊穿透。
- 會話氣泡：每個會話一個氣泡，實時顯示「正在分析請求 / 正在運行命令 / 正在生成回覆」，與 dsh 摘要顯示一致，點擊可回到 Harness。
- 狀態聯動：開始任務、工具調用、等待確認、完成任務、任務失敗均能正確映射動作。
- 主動通知：Agent 需要確認、一輪工作完成或出錯時，通過企業微信機器人推送消息，可一鍵開關。
- 失敗自愈：設置頁加載失敗自動退避重試，仍失敗則給出「重試」按鈕，不會卡在「加載中…」。
- 寵物交互：拖動換位置並寫回配置，拖動時按方向播放奔跑動畫，點一下會揮手。
- 跨平臺：同一套寵物文件在 macOS 與 Windows 通用，桌面端隨包分發，無需裝 Xcode / .NET SDK。
安裝與啓用¶
需要 DSH 0.2.1+，以及 macOS 12+ 或 Windows 10 1903+ / Windows 11。
dsh plugin --profile <profile> add github:flowers-59f/dsh-petpal
安裝後重啓 DSH，打開 設置 → 寵物。插件市場收錄後也可以從 插件 → 發現 安裝。
安裝包裏已帶編譯好的桌面端，不需要 Xcode、Swift、.NET SDK 或 Python。
典型用法¶
下載寵物¶
打開 petdex.dev 找到喜歡的寵物，複製地址欄鏈接（或鏈接最後一段的標識），粘貼到「下載寵物」輸入框，點「查找」，確認預覽後點「下載並使用」。
- 寵物頁面：
https://petdex.dev/pets/yinyue-2 - 寵物標識：
yinyue-2
已經裝過的寵物會顯示「使用」或「使用中」，不會重複下載。插件讀取 petdex.dev 的安裝腳本，把 pet.json 和雪碧圖寫進 ~/.dsh/pets/<slug> 並切換過去，不需要安裝 Codex。
調整外觀¶
同一頁面往下就是外觀設置：拖動即時生效（桌面端每 0.35 秒讀一次配置），頂部「預覽」跟着當前寵物、字號、寬度、配色實時變化；再往下是通知設置。
配置企業微信通知¶
- 創建機器人：企業微信 -> 通訊錄 -> 點擊最上方的智能機器人 -> 創建 -> 創建一個普通模式的機器人、可見範圍勾選上自己，名稱簡介等其他設置隨意。
- 拉羣：右上角 “+” 號 -> 發起羣聊並勾選上創建的機器人，進入羣裏中點擊右上角 “···” 下滑至消息推送 -> 添加一個消息推送。
- 複製它的 Webhook 地址（形如
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx）。 - 回到 設置 → 寵物 → 通知，打開「啓用通知」，把地址粘進輸入框，點「保存」或按回車。
- 出現綠色「✓ 已保存，配置即刻生效」就生效了。
之後 Agent 需要你確認、或一輪工作結束時，羣裏就會收到消息：
✅ DeepSeek Harness 通知
會話：<會話標題>
狀態：已完成
輸出token：xxxx
時間：2026/10/24 09:52:18
地址必須以 https:// 開頭，格式不對會標紅且無法保存；關掉開關只會暫停發送，已填的地址會保留。
適用場景與注意¶
適合需要在開發或工作過程中保持 Agent 進度可見的開發者或團隊。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
桌面端只讀寫本地文件，不聯網、不開端口，因此沒有常駐後臺服務，也不會和 Harness 搶資源。
小結¶
PetPal 把 petdex.dev 的寵物接入 DeepSeek Harness，提供桌面常駐氣泡和手機通知，在不干擾工作流的情況下保持任務可見。更多細節見 GitHub 倉庫：https://github.com/flowers-59f/dsh-petpal
