前言¶
在 DSH 裏做開發或跑智能體時，本機磁盤常被緩存、殘留和大文件佔滿，卻又不希望用「一鍵刪光」類工具直接永久刪除。系統自帶存儲管理往往只給容量數字，缺少分檔建議、審計與撤銷。DeepClean MyDisk 是掛在 DSH 側邊欄的原生磁盤插件：掃描階段只讀，清理階段只移動文件到廢紙簍或隔離區，永久刪除需二次確認且限於本插件移入的批次。下面介紹它的定位、能力與安裝用法。
這是什麼¶
DeepClean MyDisk（npm 包名 deepclean-mydisk）由 huangxiaoliang 維護，分類爲 DSH 客戶端插件，支持 macOS 與 Windows（Linux 宿主有分支但未驗收）。它在 DSH 面板內提供實時容量、體檢掃描、分類清理、空間分析、相似照片、跨盤移動、歷史恢復，以及只讀的 AI 解讀入口；AI 不參與掃描與寫操作，清理判斷仍以面板分檔與二次確認爲準。
倉庫：huangxiaoliang/deepclean-mydisk-plugin
目錄頁：SkillHub 插件頁
核心功能¶
體檢與清理¶
打開面板即可看到實時容量，不必先跑完體檢。支持快速掃描與完整掃描，結果分爲推薦清理、可選清理、需確認、受保護四檔；受保護與只讀項不可勾選，「需確認」項不會自動勾選。清理頁按 7 類內容組織：開發緩存、瀏覽器緩存、應用緩存、應用殘留、聊天軟件緩存、其他緩存、系統緩存（Windows 的聊天軟件專項分類與應用緩存掃描能力與 macOS 不完全一致，詳見下文限制）。
移入廢紙簍（macOS）或隔離區（Windows）不會立即釋放空間；要在歷史中永久刪除本批次後才真正釋放，且永久刪除需二次確認。單次超過 200 項時服務端自動分片，每片獨立批次、可統一撤銷；掃描結果超過 10 分鐘會過期並禁用清理。
空間與相似照片¶
「空間」以家目錄爲範圍做目錄分佈（環形圖、麪包屑、下鑽）與大文件列表，可篩選、排序，並支持把大文件移動到其他磁盤（移動不可撤銷）。相似照片基於 dHash，掃描 Pictures / Downloads / Desktop / Documents，最多 600 張、單張至少 200 KB；雲盤目錄與照片圖庫會跳過。
歷史、保護與 AI¶
歷史頁記錄掃描趨勢、隔離區/廢紙簍佔用、可恢復批次與永久刪除；審計日誌在 $DSH_HOME/deepclean-audit.log，歷史數據在 $DSH_HOME/deepclean-history.json。設置頁可維護保護名單（絕對路徑及其子目錄永不進入清理允許集合）、權限檢查與中英切換。
AI 輔助爲只讀：體檢解讀、逐項解釋、清理前複覈、大文件「這是什麼」、失敗診斷與趨勢分析等，僅把面板已算好的脫敏數據注入當前 DSH 會話；無可用會話時降級爲複製提示詞。
安裝與啓用¶
插件要求 DSH 版本在 >=0.2.1-rc.5 <0.3.0-0 範圍內（見 package.json engines.dsh）。當前 npm 版本爲 0.12.1，許可證 MIT。
先做 profile 選擇，再執行下面之一（安裝或修改 host/client 代碼後需要重啓 DSH）：
# 從 npm 安裝（推薦；預構建，無構建步驟）
dsh plugin --profile <name> add deepclean-mydisk
# 或從 GitHub 安裝
dsh plugin --profile <name> add github:huangxiaoliang/deepclean-mydisk-plugin
# 或在本地開發目錄安裝（改動即時映射）
dsh plugin --profile <name> add link:/絕對路徑/deepclean-mydisk-plugin
平臺依賴與權限¶
- macOS：系統自帶
python3，掃描依賴du/plutil/sips；需「完全磁盤訪問」才能掃全受保護路徑，未授權時不掃描。 - Windows：
py -3（或python），掃描與照片解碼爲純 Python + PowerShell.NET，不需要 Pillow；部分系統目錄清理需管理員權限。
缺失本機 Python 3 時，掃描與權限檢查不可用。
典型用法¶
- 安裝並重啓 DSH 後，從側邊欄打開 DeepClean MyDisk；在設置頁完成權限檢查（macOS）與保護名單配置。
- 在「體檢」查看實時容量，按需選擇快速或完整掃描；根據四檔結果進入「清理」，用搜索、排序與「選擇推薦項」勾選後二次確認，文件進入廢紙簍/隔離區。
- 若要真正釋放空間，到「歷史」對對應批次永久刪除（再次確認）；誤刪可用「恢復此批次」（跨重啓可用）。
- 在「空間」下鑽目錄或篩大文件；跨盤移動前確認目標盤空間，注意雲盤與 App 數據目錄不可移動。
- 需要文字說明時，在體檢或清理項上使用 AI 入口；仍以面板分檔與確認爲準。
界面入口對照：
| 入口 | 內容 |
|---|---|
| 體檢（首頁） | 實時容量、掃描與建議、AI 解讀、掃描選項、嚮導、最近整理 |
| 清理 | 分類垃圾清理與相似照片 |
| 空間 | 目錄分佈與大文件 |
| 歷史 | 趨勢、隔離區/廢紙簍、掃描歷史、恢復與永久刪除 |
| 設置 | 安全說明、雙語、保護名單、權限、環境信息 |
適用場景與注意¶
適合在 DSH 日常使用中順帶做磁盤體檢、可控清理與空間分析，尤其適合希望「先移走、可撤銷、再決定是否永久刪」的流程。插件以當前 DSH 進程權限運行；安裝前應閱讀倉庫源碼與 MIT 許可證，自行評估路徑與數據風險。
務必知曉的安全邊界（摘要）：掃描與查詢只讀；清理與移動默認只移動；只接受最近 10 分鐘內的掃描結果；保護名單、符號鏈接、雲盤與 App 數據目錄由宿主二次校驗。企業自建網盤可通過環境變量 DEEPCLEAN_CLOUD_ROOTS 補充雲盤根路徑。
已知限制包括：Windows 永久刪除後可用空間可能因卷影副本短暫滯後；相似照片範圍與格式受系統解碼限制；撤銷僅針對會話內批次時與「歷史恢復」行爲不同；AI 依賴當前會話且可能答錯。完整列表見倉庫 README「已知限制」。
問題反饋請開 GitHub Issues；安全問題勿公開 Issue，按 SECURITY.md 私下聯繫維護者。
結尾¶
DeepClean MyDisk 把「只讀體檢 + 可撤銷清理 + 空間與照片整理」收進 DSH 側邊欄，並與 DSH 會話中的只讀 AI 解讀銜接，適合不想離開 Harness 就管理本機磁盤的用戶。更多細節見倉庫 DETAIL.zh.md 與 CHANGELOG.md。
- 目錄頁：https://www.skillhub.cn/plugins/huangxiaoliang/deepclean-mydisk-plugin
- GitHub：https://github.com/huangxiaoliang/deepclean-mydisk-plugin
