介绍
SweepX 是一个安全优先的 Rust 磁盘分析项目。当前仓库已有可运行的开发版扫描 CLI/TUI，以及需要显式确认和实时重验的系统回收站 preview；Permanent 删除仍不存在。
WARNING
当前唯一真实 mutation 是单对象 Trash preview：交互确认并实时重验后移到系统回收站。没有 Permanent、plan、approve 或 execute CLI，Trash 失败也不会降级为永久删除。
当前状态
- Linux scanner 能在用户明确选择的绝对路径上做同步、只读扫描，能力状态为
degraded。 - macOS scanner 现已接入 handle-bound 的同步、只读 live scan，仍只报告
degraded，不是发布资格。 - Windows scanner 现提供 handle-relative 的同步只读 live scan，并通过
scan/scan --tui暴露；能力仍为 development-grade/degraded，不是发布资格。 - Linux 上
statusjournal-first 读取 terminal snapshot；macOS 读取 legacy operation snapshot。Windows durable state 当前禁用：默认state_dir=None，不持久化终态 snapshot，显式--state-dir失败关闭。cancel因没有 live operation registry 而保持disabled。 - Linux 已有 bounded SQLite journal 与单事务完整流/terminal persistence，并支持 degraded 的
sweepx --format ndjson status --operation-id ID --watch [--after SXCUR1]completed replay：先做一次同 snapshot 全量校验，再对已完成且已持久化的 stream 按每页最多 1024 条事件续读；unknown 但语法有效的 cursor 返回stream.reset_required，malformed cursor/usage 返回 usage error。由于事件仍在 scan 后批量构造，这不是 live stream，不等待新事件，不创建后台 operation，也不支持 cancel；因此当前机器扫描输出仍使用 JSON，scan --format ndjson继续 disabled。 explain从有界scan.resultJSON 生成解释，但导入数据被降级为 stale/incomplete，候选只能 report-only。cache status在 Linux/macOS 上提供 preview cache 的只读诊断，输出cache.status.result；Windows 当前 disabled。它只支持 human/JSON，NDJSON 是 usage error；缺失 state/cache 返回absent且不创建目录。检查范围只限preview-cache/current.json、current generation、generations/与quarantine/的浅层结构、近似字节数和健康状态；它不 scan、不 repair、不 quarantine，也不暴露 cache 条目或 path 内容。available只表示缓存结构/校验可读，不代表 live/current 文件事实。- 内置 Cleaner 支持 metadata-only 的 list/show，并在 core 版本不兼容时失败关闭。
sweepx scan --tui在根目录准入后立即打开同一二进制内的文件管理器式浏览器；当前层先出现，直接子目录的递归大小由 single-flight 后台任务回填（30 秒 deadline），后代不会作为列表行长期保留。可用d/Delete选择单项移到回收站；确认发生在退出全屏之后，并再次验证 live scan identity。- P3 已实现 immutable plan、simulation-only authorization、Unix audit/recovery 和 sealed deterministic simulated executor，但只有 library API；Linux journal 路径虽已公开 degraded 的 completed-stream replay，仍不具备 live、runtime 或跨平台资格，且仍没有可信 HumanApproval broker。
这些是代码和测试覆盖到的开发能力。仓库已有跨平台归档、安装器和发布自动化，但尚未发布稳定版本，也不是生产支持或三平台扫描资格声明。
产品定位
SweepX 位于通用磁盘分析器与应用专用 Cleaner 之间：
- Scanner 回答“当前能看见的空间在哪里”，同时保留权限错误、链接、挂载边界和大小不确定性。
- Analyzer 将事实、推导、启发式与未知项分开，而不是把目录年龄或名字当作“可安全删除”的证明。
- Cleaner 用版本化 manifest 和声明式规则描述领域知识；当前只展示元数据，不执行脚本。
- CLI、TUI 与未来 Agent workflow 共用同一 Core 合同，不给某个表面额外 mutation 权限。
为什么强调 development-grade
degraded、qualified、report_only、unsupported 与 disabled 是能力单元的状态，不是营销等级。比如：
- Linux scan 已实现，但还没有满足路线图中的全部基准、故障注入和跨平台发布门槛；
- explain/TUI 在合同测试覆盖内可用，不代表导入 JSON 可成为 live execution evidence；
- Cleaner metadata 可读取，不代表 Cleaner 可运行；
- P3 fake executor 的测试不证明任何真实文件系统 adapter。