安全设计
放心地清理。
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 安全机制部分实现
发现安全漏洞时我该怎么办?
请先私下报告——绝不要发布到公开 issue。使用 GitHub Security Advisory 流程。维护者承诺 24 小时内确认收到,7 天内给出修复方案。
适用于: 负责任披露 · 适用于所有受安全支持的版本