前言¶

在 Windows 上騰磁盤，常見做法是系統自帶「磁盤清理」或第三方一鍵刪。前者覆蓋面有限，後者往往直接刪除，路徑一長就很難判斷某個緩存目錄是否仍被程序使用。DeepSeek Harness（DSH）把能力拆成插件後，可以在 Harness 裏掛一個本地工作臺：先掃描、再解釋、最後由用戶確認。下面介紹社區插件 dsh-disk-cleanup（維護者 miyunmoshi，分類 admin-security），它把「分析」和「清理」拆開——掃描階段只讀，清理階段先移入隔離區而不是立刻永久刪除。

這是什麼¶

dsh-disk-cleanup 是面向 Windows 的 DSH 磁盤空間分析與安全清理插件，npm 包名 dsh-disk-cleanup，當前版本 0.2.2（MIT）。安裝後左側欄會出現「磁盤清理」入口，打開即完整本地工作臺。

掃描、分類和風險判定在插件本地完成；Harness 裏的 AI 助手可以在會話中解讀掃描結果（每個候選文件的用途、來源、爲何可清理、風險等級與建議），避免不了解用途就誤刪。插件不會把文件內容或路徑上傳到網絡服務。

核心功能¶

掃描與展示¶

• 只讀掃描：用戶與 Windows 臨時目錄、AppData 緩存、瀏覽器緩存、更新殘留、卸載殘留線索、日誌與崩潰轉儲、開發工具緩存、Windows 日誌、回收站說明、大文件與重複文件等（詳見 README「掃描範圍」）。
• 可多盤同時掃描：系統盤深度掃描；其他盤僅掃常見緩存、日誌、臨時、更新與殘留目錄，不遍歷用戶文檔或遊戲內容。
• 多盤結果先按盤符（C:、D:、E: 等）分區，再按應用與類別展示；可點擊盤符標題收起或展開。
• 按類別與「垃圾類型」篩選（緩存、日誌、殘留、安裝更新、臨時、重複、大文件、回收站）；每條記錄帶用途說明、清理原因、風險等級與建議。
• 文件說明中可顯示常見中文應用名與公司/廠商名，並保留應用原名（例如：微信（騰訊 / WeChat））。

卸載殘留線索¶

插件對照 Windows「已安裝程序」登記：目錄長期未更新、登記中無匹配項，且仍含緩存、日誌、安裝包或更新文件時，列爲「疑似卸載殘留」。這類條目風險固定爲「需複覈」，默認不勾選；含 save、savedata、.sav 等存檔標記的目錄按用戶數據保護，不會當作殘留。

清理方式：隔離區¶

用戶勾選並確認後，文件移入隔離區，可在隔離區恢復，或二次確認後永久刪除以釋放空間。系統盤隔離路徑爲 %LOCALAPPDATA%\DSH Disk Cleanup\Quarantine；其他盤爲該盤根目錄 $DSH-Disk-Cleanup\Quarantine，以保證移動在同一磁盤內完成。

清理只接受當前掃描結果中的候選，並重新校驗路徑、大小與修改時間；路徑不在允許目錄、已變化、爲符號鏈接或受保護系統目錄時會拒絕。

安全邊界（摘要）¶

• 掃描不寫入、不移動、不刪除任何文件。
• 插件接口只監聽或接受本機迴環地址請求，並校驗隨機會話令牌與同源請求。
• 用戶文件、OneDrive 同步目錄、應用配置、系統關鍵目錄、回收站與恢復數據不會自動處理；Windows 日誌會標註「謹慎」後列出。
• 清理瀏覽器或應用緩存前建議先退出對應程序；佔用中的文件會在結果中報告，不會強殺進程。

掃描有時間、候選數量與哈希預算上限；達到上限時結果標記爲「部分完成」。重複文件使用 SHA-256，哈希預算最多 1.5 GB。

安裝與啓用¶

已抓取 README 未給出獨立的 CLI 安裝命令行；按 DSH「一切皆插件」的用法，應在 Harness 的插件管理 中從社區目錄安裝本插件（目錄頁：https://www.skillhub.cn/plugins/miyunmoshi/dsh-disk-cleanup）。package.json 要求 Node >= 22。

安裝後刷新 Harness 頁面；桌面版若仍看不到「磁盤清理」入口，重啓一次應用。安裝前應自行查看 GitHub 源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，權限過大時掃描與移動範圍會隨之擴大。

典型用法¶

經過上面的安裝與刷新，可按 README 步驟操作：

1. 在左側欄點擊「磁盤清理」。
2. 在「掃描磁盤」卡片中勾選要掃描的磁盤，點擊「開始全面掃描」。
3. 掃描完成後，在左側選擇類別，或用頂部「垃圾類型」下拉框篩選，並展開應用分組。
4. 點擊文件名查看詳細用途、應用原名、公司或廠商和清理原因；需要時在會話中請 AI 解讀列表。
5. 勾選要處理的文件，或使用「全選安全項」「選中當前篩選」。
6. 點擊底部「移入隔離區」，閱讀確認提示後執行。
7. 在「隔離區」中恢復文件，或在確認無誤後永久刪除以釋放空間。

本地持久化路徑（便於排查）：

%LOCALAPPDATA%\DSH Disk Cleanup\last-scan.json          # 上次掃描摘要與候選清單
%LOCALAPPDATA%\DSH Disk Cleanup\Quarantine\...\manifest.json
%LOCALAPPDATA%\DSH Disk Cleanup\quarantine-roots.json   # 其他盤隔離批次索引
# 其他盤示例：E:\$DSH-Disk-Cleanup\Quarantine\批次目錄\

適用場景與注意¶

適合：主要在 Windows 上使用 DSH、希望先看清「刪的是什麼」再釋放空間、並需要多盤與開發/瀏覽器緩存等常見垃圾類型梳理的用戶。

注意：

• 僅 Windows；非 Windows 環境不適用。
• 疑似卸載殘留只是登記未匹配的線索，便攜軟件也可能無登記，務必人工複覈。
• 在 Harness 插件管理中卸載本插件時，隔離區目錄不會自動刪除；確認無需恢復後可手動刪除 %LOCALAPPDATA%\DSH Disk Cleanup。
• SkillHub 社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-disk-cleanup 把 Windows 磁盤清理做成 DSH 內的本地工作臺：只讀掃描、可解釋候選、隔離區可恢復，適合在 Harness 裏結合 AI 解讀再做決定。更多信息見目錄頁 skillhub.cn/plugins/miyunmoshi/dsh-disk-cleanup 與倉庫 github.com/miyunmoshi/dsh-disk-cleanup。