前言¶
DeepSeek Harness (DSH) 支持插件化擴展。除了網頁端的配置與監控，在桌面端保留一個可視化的狀態指示器能幫助開發者更直觀地追蹤當前會話（如空閒、工作中、等待、失敗或完成）。dsh-pet-desktop-linux 插件通過一個懸浮在桌面之上的透明窗口實現這一功能。
環境要求¶
安裝前請確認以下條件滿足：
- 平臺：Linux，且僅支持 X11 或 XWayland（原生 Wayland 會話不支持）。
- DSH：任意包含
webServer和settings.section槽位的 DSH 版本。 - Node.js：版本需 >= 22。
- 系統依賴：Python 3, PyGObject, GTK3, GdkPixbuf, xdotool。
- 額外依賴：
@michengai/dsh-codex-pet（僅用於讀取圖片素材）。
安裝¶
通過 DSH 的插件管理器安裝。
dsh plugin --profile web add github:Wlaeg/dsh-pet-desktop-linux
安裝完成後，需要刷新 DSH 的 Web UI 頁面，Settings 面板纔會註冊該插件。DSH 啓動時會自動啓動寵物窗口（autostart 默認爲 true）。
如果需要替換已安裝的插件（例如修改源碼後），必須重啓 DSH 的宿主進程，單純刷新頁面是不夠的。
功能說明¶
該插件包含三個部分：桌面程序 (desktop/pet.py)、宿主端 (lib/index.js) 和瀏覽器端 (client.js)。
- 窗口特性：
- 無邊框、透明的 GTK3 窗口，背景壁紙透出。
- 窗口常駐頂層（
_NET_WM_STATE_ABOVE）並跟隨工作區（_NET_WM_STATE_STICKY，通過xdotool實現）。
- 狀態動畫：
- 根據當前 DSH 會話狀態切換動作：空閒、工作中、等待回答、失敗、待審覈。
- 交互：
- 支持右鍵菜單。
- 提供工作狀態對話框。
注意事項¶
- 兼容性：不支持 Windows、macOS 或原生 Wayland。
- 依賴檢查：Settings 面板會自動探測 GTK3、GdkPixbuf 和 xdotool。如果 WebP 圖片無法顯示，可能需要安裝
webp-pixbuf-loader。 - 權限與安全：插件以 DSH 進程的權限運行，請從可信來源安裝並檢查源碼與許可證（MIT）。
