Workspace Cleaner 综合评估
核心用法
Workspace Cleaner 是一款面向 OpenClaw 工作区的自动化清理工具，采用 Python 脚本实现。其核心工作流遵循"先预览、后执行"的安全原则：默认 dry-run 模式展示待删除文件清单（含大小估算），用户确认后再通过 --execute 触发实际清理。所有删除操作均调用系统 trash 命令，确保文件可恢复而非永久删除。
工具支持多维度过滤：按文件大小（--min-size）、按年龄（--min-age）、自定义路径（--workspace）及 JSON 输出（--json）便于自动化集成。配置系统通过 JSON 文件管理匹配模式与保护规则，允许用户扩展临时文件识别规则。
显著优点
1. 安全优先设计：dry-run 默认 + 回收站机制双重保险，避免误删；内置保护列表自动豁免 .git、memory/、核心配置文件等关键目录
2. 开发者友好：支持 Node 模块、Python venv、macOS 系统文件等开发场景常见垃圾识别，JSON 输出便于 CI/CD 集成
3. 灵活可配置：正则式匹配模式 + 年龄/大小阈值 + 自定义排除规则，适应多样化工作流
4. 透明可控：执行前完整清单展示，每项标注大小与风险等级
潜在局限
- 外部依赖：需预装
trash/trash-cli，跨平台配置成本存在差异（macOS brew vs Linux 包管理） - venv 识别风险：Python 虚拟环境标记为 ⚠️ 需谨慎，依赖白名单机制（
known_venvs），未知命名模式可能误触 - 无内嵌备份：依赖系统回收站，若用户清空 trash 则无法恢复，建议大清理前额外备份
- 年龄判断依赖 mtime：若文件被复制/移动可能重置时间戳，导致清理策略偏离预期
适合人群
- 本地开发环境频繁的软件工程师与 AI 研究者
- OpenClaw/Multi-Claw 工作区重度用户
- 需要定期磁盘维护的 macOS/Linux 开发者
- 追求自动化运维的 DevOps 工程师（可集成至 HEARTBEAT.md 定时任务）
常规风险
| 风险场景 | 说明 |
|---------|------|
| 误删活跃 venv | 未列入 `known_venvs` 的虚拟环境可能被清理 |
| 回收站溢出 | 大量清理可能导致系统 trash 体积激增 |
| 权限不足 | 对系统目录无写入权限时 trash 操作失败 |
| 配置漂移 | 共享配置未及时更新保护新关键文件 |