DeepSeek Harness（DSH）採用插件化架構，旨在通過模塊化擴展能力。在開發與多會話管理場景中，用戶往往需要直觀的狀態反饋和任務進度追蹤。dsh-foxbell-pet 插件通過在 DSH Web 或桌面端右下角提供可拖拽的桌寵系統，將多項目狀態監控、效率用量看板與語音交互集成在一個可視化的界面中。
該插件由 jarvislee90s-dot 維護，默認內置小狐狸 Foxbell，支持通過外部寵物體系進行熱切換。
核心功能¶
多項目狀態監控
桌寵頭頂會根據 MAM（多 Agent 管理）色彩口徑顯示狀態卡片：
* 紅：待審批
* 黃：運行中
* 綠：完成未讀（點擊可確認消失）
* 深紅 + ⚠：錯誤斷聯（與待審批紅區分）
點擊狀態卡片可直接切換到該項目會話並標記已讀。
外部寵物體系
插件提供完整的寵物管理功能：
* 熱切換：內置寵物與導入寵物同場管理，點擊即可切換，無需刷新頁面。
* 多來源導入：支持本地文件夾、Zip 包、Codex 寵物目錄以及 Petdex 在線倉庫導入。
* 完整性守衛：切換時校驗圖集、語音與清單的完整性，確保運行穩定。
* 磁商店管理：寵物數據存儲在 ~/.dsh/foxbell-pet/pets/<id>/，支持安全刪除（移入回收站）。
效率與用量看板
* 效率看板：基於事件時間軸展示“節奏姿態”，包括高強度、活躍、長任務、空閒及摸魚狀態。懸停寵物可查看五口徑 Token 用量（請求輸入、緩存命中、命中率、產出、你的輸入）。
* 用量看板：提供三級披露（L1 迷你條、L2 小黑板、L3 主列大看板），支持按日/小時/路由/工具摺疊數據，並提供導出圖片功能。
交互與物理手感
* 拖拽物理：支持水平拋擲慣性、重力墜落以及落地壓扁回彈，位置記憶與邊界鉗制。
* 語音交互：完成播 done 組、待審批播 approval 組（10s 限流）、報錯播 error 組。
* 右鍵菜單：提供顯隱開關、大小調節（0.75/1/1.25）、五場景動作綁定、寵物切換及關於信息。
安裝與啓用¶
使用官方安裝命令即可完成安裝，插件構建產物隨倉庫提交，無需本地構建。
dsh plugin --profile web add github:jarvislee90s-dot/dsh-foxbell-pet#release
安裝完成後，重啓 dsh web 並硬刷新瀏覽器（Cmd/Ctrl+Shift+R）即可看到桌寵。設置頁面會出現 foxbell-pet 配置卡，側欄底部有顯隱開關。
使用說明¶
- 切換寵物：在右鍵菜單或設置卡的“寵物管理”區點擊切換，即時生效。
- 查看用量：鼠標懸停在桌寵上約 0.5 秒可查看迷你條，點擊右鍵選擇“📊 查看最近總結”或“📈 用量看板”可展開詳細數據。
- 動作綁定：在右鍵菜單的“五場景動作綁定”中可配置雙擊、紅燈、黃燈、深紅燈、綠燈對應的動作，並支持實時預覽。
環境要求與注意事項¶
- 宿主版本：需安裝 DeepSeek Harness (DSH) ≥ 0.1.2-rc.1。v2.3.0 版本已適配 DSH 0.2.0-rc.2 桌面端運行時。
- 版本兼容：v1.x 版本不支持，請確保使用 v2.x 系列。
- 依賴說明：插件不直接依賴
@deepseek-ai/dsh-settings，該服務由宿主運行時提供。 - 本地開發：若需從源碼安裝，需 Node ≥ 20 與 pnpm，使用
dsh plugin --profile web add .以 link 方式安裝。
總結¶
dsh-foxbell-pet 是一款將實用監控工具與桌面寵物結合的 DSH 插件。它通過可視化的方式解決了多項目狀態追蹤與 Token 用量統計的需求，同時提供了豐富的交互與自定義空間。
