安全设计

放心地清理。

MacLean 是一款删除文件的工具——因此删除被视为高风险操作。以下每项安全机制都属于你可审计的开源代码库。

模型

先扫描。标注影响。确认后再删除。

1

扫描与分类

每个候选项目都会获得影响标签:可重建、先复核或受保护。

2

保护重要的数据

受保护的应用与个人数据被额外的确认步骤拦在门外。

3

保守地删除

大文件默认进入废纸篓;纯缓存会在永久删除前被标记。

4

保持可恢复

待定快照与备份/恢复清单让删除可逆。

删除安全机制

安全层如何工作。

  • 物理身份校验(macOS):删除前与删除过程中,通过设备与 inode(st_dev/st_ino)比对文件身份,封堵 TOCTOU 窗口。 st_dev/st_ino
  • 分阶段原子重命名:候选文件先移动到暂存路径(RENAME_EXCL),在最终确认前再次校验。 RENAME_EXCL
  • 优先废纸篓策略:use_trash + is_restorable_by_move 决定哪些文件进入废纸篓而非永久删除。 use_trash + is_restorable_by_move
  • 超时保护的复核:300 秒窗口控制最终确认流程;中断的操作会保留待定快照。
  • Windows 的诚实说明:Windows 使用原子重命名缩短竞态窗口;物理身份比对在 Windows 上文档明确标注为尚未实现。
  • 无静默自动化:免费版绝不会在无用户明确操作时删除。开发者模式是编译期特性,且已从 CI 构建中排除。
  • 可审计的代码:安全层位于公共仓库——阅读 crates/maclean-core(安全、操作)与 docs/safety/SAFETY_MODEL.md。 crates/maclean-core

关于 MacLean 安全的快速解答

MacLean 会误删我的个人文件吗?

安全模型正是为防止这一点而设计:受保护的应用单独确认,浏览器数据等“先复核”项目绝不会被自动选中,大文件进入废纸篓,删除操作会被记录以便恢复。安全层开源且可审计。

适用于: 免费版默认行为 · 以 macOS 为主;Windows 安全机制部分实现

证据: crates/maclean-core 安全与操作模块;docs/safety/SAFETY_MODEL.md;2026-10-12 代码审查。 更新于: 2026-10-12

发现安全漏洞时我该怎么办?

请先私下报告——绝不要发布到公开 issue。使用 GitHub Security Advisory 流程。维护者承诺 24 小时内确认收到,7 天内给出修复方案。

适用于: 负责任披露 · 适用于所有受安全支持的版本

证据: SECURITY.md(负责任披露、响应承诺)。 更新于: 2026-10-12