DeepSeek Harness（DSH）的 Web profile 是智能體開發和調試的主要環境。在長時間的運行過程中，界面除了文字反饋外，往往缺乏可視化的動態元素。DSH 的插件體系支持擴展前端渲染能力，這款插件正是利用這一機制，將 Petdex 桌面寵物的視覺與交互功能引入 DSH 的 Web 界面。
插件簡介¶
dsh-petdex-pet 是一款由 zenglihunter 維護的客戶端插件。它將 Petdex 桌面寵物帶進 DeepSeek Harness Web 界面，通過純瀏覽器端渲染實現可視化陪伴。
核心功能¶
這款插件提供了以下具體功能：
- 右下角懸浮交互：寵物以懸浮形式出現在右下角，支持拖拽。點擊可展開菜單，狀態欄會根據 DSH 的活動實時切換（空閒、奔跑、跳躍、揮手、失敗、等待批准等）。
- 行爲動畫：鼠標懸停時，寵物會隨機揮手或進行「思考」問候；在奔跑狀態下，會自動輪播左右跑方向。
- 設置與配置：提供獨立的寵物設置頁，支持調整寵物大小（40%–150%）、啓用或關閉寵物、管理「我的寵物」列表、圖庫搜索預覽。
- 一鍵安裝：支持通過安裝代碼（如
npx petdex@latest install doraemon）或寵物鏈接/slug 一鍵安裝新寵物。 - DSH 狀態同步：寵物狀態與 DSH 任務深度綁定，例如任務開始時跳躍、執行中奔跑、完成後揮手、失敗或等待批准時顯示對應動畫。
- 開箱即用：內置 4 個全職獵人主角寵物包（Gon 小杰 / Killua 奇犽 / Kurapika 酷拉皮卡 / Leorio 雷歐力），包含精靈圖與配置文件。
- 無桌面依賴：純瀏覽器端渲染，不需要安裝 Petdex 桌面端程序。
安裝與啓用¶
本插件僅適用於 DeepSeek Harness（DSH）的 web profile（默認路徑 C:\Users\<你>\.dsh\profiles\web\）。
- 打開 DSH web profile 的目錄，編輯
package.json文件。 - 在
dependencies中添加：
"@dsh-external/dsh-petdex-pet": "github:zenglihunter/dsh-petdex-pet"
- 在
dsh.profile.bundles數組末尾添加：
"@dsh-external/dsh-petdex-pet"
- 在該目錄運行
pnpm install（或npm install）。 - 重啓 DSH。設置頁會出現「寵物」選項，右下角將顯示寵物。
使用示例¶
安裝並重啓 DSH 後，插件會自動將內置的 4 個獵人寵物播種到 ~/.petdex/pets/ 目錄（由 ~/.petdex/.dsh-petdex-bundled.json 標記，僅執行一次）。
若需安裝外部寵物，可在設置頁或命令行使用安裝代碼。例如，在終端中執行以下命令即可安裝一隻名爲 doraemon 的寵物：
npx petdex@latest install doraemon
適用場景與注意事項¶
- 權限與範圍：插件以 DSH 進程權限運行，需確保 DSH web profile 目錄有寫入權限。
- 文件共享：寵物文件存儲在
~/.petdex/pets/<slug>/目錄下，包含pet.json和精靈圖文件（pet.spritesheet.webp或png），與 Petdex 桌面端共享。 - 內置寵物行爲：如果目標機器上已存在同名寵物，內置寵物不會覆蓋；用戶手動刪除後，內置寵物也不會復活。
- 開源再分發：內置的精靈圖素材來源於 Petdex 社區圖庫。如需開源再分發，請務必確認素材授權條款，並在說明中註明來源與致謝。
總結¶
通過 dsh-petdex-pet，DSH 用戶可以在 Web 界面獲得與桌面端類似的寵物陪伴與狀態反饋。如果你正在尋找一種方式讓 DSH 的運行狀態更加生動，可以訪問 目錄頁 或 GitHub 倉庫 獲取更多信息。
