前言¶

在 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 仓库。