前言¶
用 DeepSeek Harness（DSH）跑長任務時，一個常見場景是：Agent 在後臺改代碼、跑測試，你 meanwhile 切到 VS Code、瀏覽器或終端繼續別的事。WebUI 標籤頁一關或一擋，就很難一眼判斷 DSH 是在思考、執行、等你確認，還是已經報錯結束。
社區插件 dsh-dafeiyu（DSH 大肥魚）針對的正是這個痛點。它由維護者 QCYTSN 開發，在 SkillHub 插件庫 歸類爲「客戶端」，GitHub 倉庫約 252 星、27 個 fork。插件以 npm 包 dsh-dafeiyu 發佈，代碼採用 MIT 許可證。
需要先說清生態背景：DSH 的核心理念是「一切皆插件」，SkillHub 等社區目錄是第三方整理的發現入口，與 DeepSeek / 幻方並無官方從屬關係。安裝任何社區插件前，都建議自行查看源碼與許可證——插件以當前 dsh 進程權限運行。
這是什麼¶
DSH 大肥魚 是一個桌面原生的 BigFish 伴侶：由 DSH 插件機制啓用，生命週期跟隨 DSH Host，在桌面上以透明、無邊框、始終置頂的原生窗口展示 Agent 狀態。
它不是需要單獨啓動的桌寵程序，也不會讀取屏幕或監聽 VS Code、瀏覽器裏的操作。狀態變化全部來自 DSH 的真實 Agent 事件；沒有待辦數據時，只顯示「分析階段」「實現階段」等可靠信息，不會編造完成百分比。
當前 README 標註版本爲 0.1.5，支持 Windows 10/11 x64、WSL2（經 Windows interop 拉起桌面 Helper）、Linux x64 桌面（X11 或 XWayland），macOS 12.0+ 爲實驗性支持。
核心功能與亮點¶
- 離開 WebUI 也能看狀態：大肥魚常駐桌面最上層，切到別的軟件仍能看到 DSH 在做什麼。
- 事件驅動，非屏幕抓取：思考、查找、修改、執行、驗證、等待、完成、錯誤等狀態，對應不同動畫與文案。
- 信息適量：狀態卡可展示項目目錄名、當前階段、進行中的步驟，以及 DSH 提供的結構化待辦進度（如「已完成 3/5 步」）。
- 多 Session 優先級：多個 DSH Session 同時運行時，按「等待確認 > 錯誤 > 工作 > 思考 > 空閒」排序，氣泡可同時列出多個活動任務。
- 零額外入口：隨 DSH 啓停，無需單獨裝 Python、配端口或手動開 Helper；Windows / Linux / macOS 的 Helper 已打包在發佈物中。
- 可配置交互：角色與氣泡大小、氣泡顯示策略、空閒微動作、減少動態、提示音、是否響應子 Agent 等，均在 WebUI 設置中調整。
安裝與啓用¶
安裝前請完全退出 DSH Host（不只是關瀏覽器標籤），避免舊版插件進程殘留。
在 DSH 安裝目錄下執行（PowerShell 或終端均可）：
dsh plugin --profile web add dsh-dafeiyu
若系統未全局暴露 dsh，可用項目內的 pnpm 調用：
pnpm exec dsh plugin --profile web add dsh-dafeiyu
想試用 @alpha 測試版，將包名改爲 dsh-dafeiyu@alpha 即可。也可從 GitHub Releases 下載 dsh-dafeiyu-<version>.tgz（勿解壓），本地安裝：
dsh plugin --profile web add "C:\Users\you\Downloads\dsh-dafeiyu-<version>.tgz"
WSL2 用戶在 WSL 終端執行同一條命令，插件會通過 cmd.exe 啓動包內 Windows Helper。Linux x64 用戶同樣一條命令；遠程無桌面 Linux 與容器不在顯示目標範圍內。macOS 安裝命令相同，但當前爲實驗性支持，下載包可能遇 Gatekeeper 攔截（ad-hoc 簽名，尚未公證）。
安裝完成後照常啓動 DSH WebUI。設置入口：
設置 → 插件 → 插件配置 → 大肥魚桌面伴侶
確認「啓用大肥魚」已勾選。更新插件時，先完全退出 DSH，再執行：
dsh plugin --profile web update dsh-dafeiyu
卸載：
dsh plugin --profile web remove dsh-dafeiyu
典型用法¶
安裝後無需額外操作，按日常流程使用 DSH 即可：
- 啓動 DSH，在 WebUI 中開始一個項目任務。
- 大肥魚根據 DSH 事件切換動作與狀態卡（思考、工作、等待確認、完成、錯誤等）。
- 切換到其他窗口繼續工作；伴侶窗口保持置頂。
- DSH Host 真正退出後，大肥魚自動關閉。
桌面交互方面：可拖動調整位置（自動保存）；單擊或雙擊觸發短互動；右鍵菜單可改大小、隱藏氣泡、打開 WebUI、「本次隱藏」或「本次關閉」。「本次關閉」會抑制當前 DSH 運行期間的自動重啓，下次啓動 DSH 纔會再出現。
若安裝後看不到大肥魚，依次檢查：是否使用 --profile web、是否重啓了 DSH Host、設置裏是否啓用、是否使用了含預構建 Helper 的發佈包（僅克隆源碼通常不夠）。
適用場景與注意事項¶
適合誰：
- 長時間讓 DSH Agent 跑任務，又需要在 IDE / 瀏覽器裏並行工作的開發者；
- 希望桌面一眼看到「是否在等我確認」「是否已報錯」的用戶；
- Windows / WSL2 桌面環境爲主，或 Linux x64 本地圖形會話的用戶。
需要注意：
- 插件綁定 DSH Host 生命週期，不是瀏覽器標籤頁；關網頁但 Host 仍在跑時，大肥魚會繼續顯示。
- 數字進度僅在 DSH 寫入結構化待辦時展示；無待辦時只顯示階段信息，這是刻意設計，避免虛假百分比。
- 隱私邊界（據官方 README）：不讀取 API Key、不截圖、不遙測、不監聽鍵盤或其他應用、不新開網絡端口。
- 社區插件需自行審計代碼；角色視覺資產另有 ASSET_LICENSE.md 約束，與 MIT 代碼許可分開。
- 同作者的獨立桌寵項目 ds-local-pet 與本文插件不同：本倉庫只服務 DSH 狀態展示。
小結¶
如果你希望 DSH 的 Agent 狀態「離開 WebUI 也看得見」，dsh-dafeiyu 把真實事件映射到桌面置頂伴侶，安裝成本低、信息來源可靠，是客戶端類插件裏較受歡迎的選擇之一。
