发布准备
本页记录验证情况和发布门槛，不代表所有支持目标都已经在用户机器上验收。 最近审阅日期：2026-09-04。
版本范围与发布核验
分类筛选、跨筛选累积选择与 Shift+A 全局选择适用于 0.15.0 及后续版本。
下方兼容性说明记录 0.15.0 的恢复记录变更，详情见
更新记录。
公开发布状态及各平台的 release-evidence.json 请查看
v0.15.0 发行页。
下方记录历史源码检查与仍需进行的系统回收站验收，不能替代 0.15.0 发行包的安装验证。
录屏演示继续标注其实际版本 v0.14.0。
较新提交通过检查，不会使旧发行包自动获得相同验证。
支持与验证矩阵
| 平台 | 原生发行目标 | 已有证据 | 仍需验收 |
|---|---|---|---|
| macOS | Apple Silicon、Intel | e136149 的 CI 中 macOS 任务通过源码测试 macos_system_trash_round_trip_records_exact_locator：移动并恢复测试自己创建、包含中文与空格的目录，检查确切回收站位置和嵌套文件内容。 | 使用实际下载的发行包复验，并覆盖目标系统与卷类型。源码测试不证明所有文件系统或安装包可用。 |
| Windows | x64、x86 | 已有系统回收站清理/恢复实现与源码 CI。v0.14.0 对应源码 CI 曾有两个 Windows TUI 断言失败，后续修复不在该发行包内。 | Windows 真实回收站往返与内容检查，以及下载发行包后的首次运行验证。 |
| Linux | x86-64、ARM64、ARMv7 hard-float | 已有 Freedesktop 回收站清理/恢复实现与源码 CI。 | Linux 桌面真实回收站往返与发行包验证；无桌面环境、挂载策略和回收站可用性需单独测试。 |
发行目标不代表清理覆盖完全一致。Windows 常规系统范围刻意收窄，macOS 的已命名应用 与开发者缓存位置更多。单测通过、资产生成成功或版本命令可执行，都不证明完整清理与 恢复行为已经验收。
升级与兼容性
按安装指南保持安装方式一致。可能需要恢复时，升级前保留本地配置与 历史。不要假定旧二进制能读取新版本的计划或清单；也不要手工修改计划来绕过兼容错误， 应使用准备执行的版本重新生成并审阅计划。
0.15.0 兼容性变更： 新恢复记录使用 cleanr.restore.v2，0.15.0 读取器继续接受 v1
历史。not-attempted 表示尚未调用后端，pending 表示已保存操作意图但结果尚未落盘。
中断后，pending 条目需要人工检查原路径、回收站和清单再决定后续操作。不要通过回退
旧二进制处理 v2 记录；请保留状态目录，使用当前或更新的兼容版本。
从 0.15.0 起，清理与恢复在整个操作期间持有状态目录中的操作系统文件锁。另一操作会报告冲突， 进程退出后由操作系统释放锁；不要删除锁文件来绕过。回收站与 JSON 写入仍无法成为 同一个原子事务。文件操作结果落盘失败时，后续条目停止，返回的运行/清单信息供人工 恢复参考。
回退二进制不会撤销文件移动、恢复历史或配置变更。不再需要恢复之前，请保留系统回收站和清单。
正式发布前
按照仓库的发布流程， 为各项门槛记录确切提交、包版本、平台和验证证据：
- 发布提交的必要源码检查与发行包冒烟检查全部通过。
- 每条准备推广的安装路径能够运行
--version、--help和隔离只读分析。升级与卸载 单独测试，并保留恢复记录。 - 目标平台通过真实回收站与恢复场景，使用生成样本，并包括原路径冲突与恢复中断。
- 已部署
/Cleanr/网站、CSS/JS、中英文安装页和分享卡都能访问；本地修复不代表部署完成。 - 发行说明区分已发布能力、待发布能力、格式变更和已知限制。明确授权发布后，再验证 GitHub、npm、crates.io 的公开版本。
真实回收站测试会修改系统回收站，需要单独确定执行范围；只读分析或模拟后端测试 不构成这类操作的授权。
推广前
将 Cleanr 定位为 AI 友好、由用户掌控的磁盘清理工具，展示应用与浏览器缓存、日志、 临时文件、下载文件和开发产物。说明结构化只读证据如何帮助 Agent 解释候选项和准备 可审阅计划，同时展示直接使用终端的方式。用默认确认、计划与目标复核、系统回收站 和本地恢复记录说明安全性。每次演示选择一个范围，说明候选原因、用户选择和可恢复的回收站 操作。使用生成样本或脱敏路径，把审阅和恢复作为独立步骤，注明应用版本与平台； 仓库独有画面标为未发布。
准确展示候选字节数和已移动字节数，不将它们等同于新增可用空间，也不保证恢复必然 成功。同时展示 TUI 与 Agent 入口，并让用户能看到云端 Agent 的数据边界。
先向熟悉终端的小范围试用者收集自愿反馈，涵盖日常清理与开发场景：安装是否成功、多久理解第一次审阅、空结果 是否造成困惑、是否出现意外规则匹配、恢复是否失败。本页尚未测量基线与真实需求； 本机场景通过不能代替真实用户证据。使用 支持渠道与 私密安全报告，不要索要原始分析 JSON。 对外发布宣传或联系用户是另一个发布决定。