前言¶

在 DeepSeek Harness (DSH) 的使用過程中，系統緩存和臨時文件會佔用磁盤空間，可能影響系統性能。手動清理這些文件存在誤刪風險。dsh-system-cleanup 插件提供了一套可複用的 skill，用於在 macOS / Linux / Windows 上保守地自動清理系統緩存與垃圾文件。

插件定位¶

這是一個面向 DSH 的可複用 skill，由 Paul090515 維護。它解決的是系統垃圾文件積累導致磁盤空間不足的問題，同時確保清理過程不影響用戶正常工作。

核心功能¶

插件提供以下能力：
1. Dry-run 默認：默認只報告將要清理的內容，不進行實際刪除，確認無誤後再執行。
2. 可恢復刪除：刪除操作默認將文件移入廢紙簍或回收站，支持隨時還原。
3. 白名單制：只清理 references/safety-and-scope.md 中列出的已知安全目錄。
4. 年齡過濾：默認只處理 7 天前未修改的條目，避開正在使用的文件。
5. 使用中檢測：使用 lsof 檢測文件是否被進程打開，跳過正在使用的文件。
6. 全平臺支持：支持 macOS、Linux 和 Windows，自動分發對應的清理腳本。
7. 可選定時：提供定時任務安裝腳本，支持設置定期自動清理。

安裝¶

通過 DSH 插件管理器安裝：

dsh plugin --profile web add github:Paul090515/dsh-system-cleanup

安裝後需要重啓 dsh web。

使用方法¶

安裝完成後，可在命令行調用腳本。

手動清理

# macOS / Linux：僅檢查（dry-run）
bash ~/.dsh/skills/system-cleanup/scripts/cleanup.sh

# macOS / Linux：執行清理
bash ~/.dsh/skills/system-cleanup/scripts/cleanup.sh --apply

# macOS / Linux：更保守的清理（指定最小年齡）
bash ~/.dsh/skills/system-cleanup/scripts/cleanup.sh --apply --min-age-days 14

# Windows：僅檢查（dry-run）
powershell -ExecutionPolicy Bypass -File ~/.dsh/skills/system-cleanup/scripts/cleanup.ps1

定時清理

# 安裝定時任務（每週執行 dry-run）
bash ~/.dsh/skills/system-cleanup/scripts/schedule.sh --install

安全機制¶

該插件設計了多重機制保障系統安全：
1. 默認 dry-run：不確認不刪除。
2. 可恢復：移入廢紙簍/回收站，不使用 rm -rf。
3. 白名單：不觸碰文檔、下載、桌面、項目、主目錄根等目錄。
4. 無安全回退則不刪：系統上找不到「移入廢紙簍」工具時，跳過實際刪除。
5. 不自動提權：需要管理員權限的目錄一律跳過。

總結¶

dsh-system-cleanup 提供了一套安全、可控的系統清理方案。通過默認 dry-run 和白名單機制，降低了誤刪風險。適合需要定期維護系統磁盤空間的 DSH 用戶。完整源碼與文檔見 GitHub 倉庫。