CX CLEAR
GitHub
文档参考
参考

安全机制

防止误删的多重保护设计。

Cx Clear 是个删除工具,误删的代价远高于少清一点。下面这些机制写死在代码里,GUI 和 CLI 共用同一套。

扫描冻结,清理只执行计划

路径只在扫描时展开一次,冻结成一份删除计划;清理时只删计划里的条目,绝不重新遍历目录或重新匹配。扫描后才出现、或中途被替换掉的文件不会被删,只能重新扫描。

删除前逐条核对身份

每个文件删除前都会核对它确实属于扫描时冻结的那个清理项,身份对不上就拒删。GUI 的文件清理和会话删除共用同一份判定逻辑。

工具在运行就整批阻断

删除前检测目标工具进程,命中就在删第一个文件之前整体终止——GUI 提示先退出工具,CLI 返回退出码 2 和 blocked_tools。进程枚举失败时按「正在运行」处理。

不跟随软链接

遍历时遇到符号链接直接拒绝,不会顺着链接删到目录外面;路径中间任何一段是链接都拒绝清理。

永久保护路径

每个工具声明了一组永不删除的路径——登录态、主配置、会话主库这类。保护路径无法通过父目录规则绕过,即使整目录删除也会跳过它们。

CLI 的双保险

CLI 里 delete / clean 不带 --yes 永远只返回预览计划,不会真删;先 find 看匹配再删也是推荐流程。详见 使用方式。

场景行为
删除计划外的文件不删
文件被替换 / 修改过拒删,要求重新扫描
目标工具正在运行整批终止,一个都不删
路径中出现软链接拒绝清理
永久保护路径任何规则都删不到