前言¶
DSH（DeepSeek Harness）插件化架構允許用戶自定義工具鏈。在 Agent 交互過程中，輸出通常僅限於文本，缺乏視覺反饋。nattocb/dsh-plugin-petdex-market 插件解決了這個問題：它將寵物市集集成到 DSH 的 Settings 界面中，允許用戶瀏覽、安裝並渲染一個原生 macOS 桌面寵物，使其成爲 Agent 的視覺夥伴。
核心功能¶
該插件提供了一套完整的寵物管理工具，核心能力包括：
- 實時市集：直連 petdex.dev，提供約 4,500 只寵物的目錄。支持按名稱、種類或作者搜索，支持分頁和多種排序方式。
- 寵物管理：支持安裝、啓用、重命名和刪除寵物。系統採用單活躍夥伴模型，啓用一隻寵物會自動禁用其他已安裝的寵物。
- 同源貼圖代理：服務端轉發貼圖請求，避免 WebView 出現 CORS 問題。
- 原生桌面寵物：使用 Swift/AppKit 構建的透明窗口。寵物可以自主行走、被拖拽，並支持右鍵菜單操作。
- 感知 Agent 狀態：訂閱 DSH 的 session/event 事件。當 Agent 開始工作時，寵物會奔跑；當 Agent 結束回覆時，寵物會揮手並顯示氣泡。
- 配置熱加載：所有設置保存在
petdex-market命名空間下，修改即時生效，無需重啓服務。
安裝與啓用¶
安裝過程分爲三步：
- 安裝插件
使用官方安裝命令將插件添加到webprofile：
dsh plugin --profile web add github:NattoCB/dsh-plugin-petdex-market
- 配置啓用
在~/.dsh/settings.yaml中開啓插件與桌面寵物功能：
petdex-market:
enabled: true
desktopEnabled: true
- 重啓服務
重啓dsh web，在 Settings 界面中會出現 Petdex 頁籤，選擇一隻寵物即可開始使用。
注意事項¶
- 系統依賴：桌面寵物渲染器爲 Swift/AppKit 原生二進制，僅支持 macOS 系統。
- 數據流向：目錄數據直連 petdex.dev 獲取，貼圖經過服務端同源代理轉發。
- 進程管理：渲染器進程由服務端管理。若進程崩潰，系統會在 2 秒後自動重啓。
