前言¶
在 macOS 上做系統清理，很多人會用 Mole CLI：健康檢查、清理預覽、磁盤分析、應用清單與維護歷史都在終端裏完成。對長期在 DeepSeek Harness（DSH）裏編排任務、看面板的開發者來說，頻繁切到終端再記子命令，成本和誤操作風險都不低。
大肥魚 clean（dafish-clean）是社區維護的 DSH 客戶端插件，在 Harness Web UI 裏提供與 Mole CLI 能力對齊的深色面板，而不是另一套清理引擎。下文介紹它是什麼、能做什麼、如何安裝，以及使用時的邊界與安全模型。
這是什麼¶
- 名稱：大肥魚 clean（Big Fat Fish clean）
- 維護者：lzyxczw-cyber
- 分類：客戶端插件
- 倉庫：github.com/lzyxczw-cyber/dafish-clean
- 定位：非官方的 Mole CLI 圖形面板；不打包 Mole 代碼或資源，通過調用本機已安裝的
mole二進制讀寫其 JSON/文本輸出。與 Mole 項目無隸屬關係。 - 插件代碼許可證：MIT（
package.json中版本爲 1.0.3）。Mole CLI 爲 GPL-3.0，需用戶自行安裝。
依賴環境：node >= 20，dsh >= 0.2.1-rc.2；文檔標明兼容 0.2.1-rc.2+ 與 0.2.2-rc.1+。
核心功能¶
面板通過多個 Tab 映射 Mole 子命令，並在破壞性操作前普遍使用 --dry-run 預覽。
| Tab | 對應能力 | 安全說明 |
|---|---|---|
| Status | mole status --json，約每 3 秒刷新 |
只讀 |
| Clean | 先 mole clean --dry-run，確認後再 mole clean |
刪除前需明確確認 |
| Apps | mole uninstall --list 與 --dry-run |
實際卸載交給 Terminal |
| Optimize | 先 mole optimize --dry-run，確認後再執行 |
維護前預覽 |
| Analyze | mole analyze --json <path>，樹圖與下鑽 |
只讀 |
| Tools | mole purge / installer / slim --dry-run |
刪除類操作交給 Terminal |
| History | mole history --json --limit 60 |
只讀 |
設計要點（來自上游 README）：
- 長任務以後臺作業運行，單行狀態展示當前項、計數與耗時，可展開日誌；切換 Tab 後運行狀態與結果保留在持久化存儲中。
- CLI 輸出爲英文時，面板將分組名、任務名、狀態與摘要映射爲中文，文件路徑、應用名與進程名保持原樣。
- 未檢測到
mole時展示安裝引導：可一鍵brew install mole（後臺執行、不調用sudo），或複製官方安裝方式後「再次檢查」。二進制查找路徑包括 Homebrew、/usr/local/bin、~/.local/bin、MOLE_BIN。
平臺限制：當前僅支持 macOS（交接終端時使用 open / Terminal）。
安裝與啓用¶
任選一種方式安裝到指定 profile，安裝後刷新 DSH 頁面（若提示則重啓 host），從側欄打開 大肥魚 clean。
插件市場：在 DSH 中打開 Plugins → Plugin Market，搜索 dafish-clean / 大肥魚 / Mole，點擊安裝。
從 GitHub 源碼：
dsh plugin --profile <profile> add github:lzyxczw-cyber/dafish-clean
從 Release 壓縮包（v1.0.3）：
dsh plugin --profile <profile> add https://github.com/lzyxczw-cyber/dafish-clean/releases/download/v1.0.3/dafish-clean-1.0.3.tgz
npm：
dsh plugin --profile <profile> add dafish-clean
包頁：npmjs.com/package/dafish-clean。
安裝前建議在倉庫閱讀源碼與 LICENSE，確認與己方合規要求一致；插件以當前 DSH 進程權限運行，能否讀寫系統路徑取決於 host 的啓動方式與用戶權限。
典型用法¶
- 確認 Mole：若側欄打開後面板顯示安裝引導，按引導安裝 Mole CLI 或手動安裝後點擊「再次檢查」。
- 看健康狀態：進入 Status，面板週期性拉取
mole status --json，用於快速判斷系統概況。 - 清理前預覽：在 Clean 先跑 dry-run，覈對將要刪除的項，再在確認對話框後執行真實
mole clean。 - 磁盤分析：在 Analyze 指定路徑，查看 JSON 驅動的樹圖並下鑽；該 Tab 爲只讀。
- 卸載應用：在 Apps 用 dry-run 預覽後，按面板說明在 Terminal.app 中完成卸載（面板生成
.command交接，不假裝全自動）。 - 查歷史：在 History 查看最近最多 60 條清理相關記錄。
破壞性寫操作受作業鎖約束，避免同類掃描或破壞性任務重疊；變更類本地路由要求同源請求並攜帶 x-dsh-mole 頭。面板不執行 sudo，需提權的系統級清理仍由用戶在終端完成。
適用場景與注意¶
適合誰
- 已在 macOS 上使用或打算使用 Mole CLI，且主要工作界面在 DSH 的開發者或運維人員。
- 希望在同一瀏覽器窗口內完成「預覽 → 確認 → 執行/交接」，減少在 Harness 與終端之間來回切換的場景。
需要注意
- 非官方集成：顯示名稱刻意與 Mole 區分，不捆綁 Mole 商標資源；Mole for Mac（mole.fit）爲獨立產品，與本插件無關。
- 僅客戶端：不替代 Mole CLI 的安裝與許可義務；GPL-3.0 的 Mole 與用戶自行安裝的
mole二進制適用其原項目條款。 - 社區目錄 skillhub.cn 上的插件頁 爲生態收錄站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令以倉庫 README 爲準。
結尾¶
大肥魚 clean 把 Mole CLI 的系統健康、清理預覽、磁盤分析、應用清單、維護與歷史收斂到 DSH 側欄中的一塊深色面板，並強調 dry-run 與顯式確認。若你已經在 Harness 裏編排工作流，可以先在測試 profile 安裝，確認 mole 檢測與 Tab 行爲符合預期後再用於日常機器。
