使用 Cleanr
选择扫描范围
启动时传入的路径会成为默认扫描根目录：
cleanr ~/projects/app-one ~/projects/app-two
不传路径时使用当前目录。启动 Cleanr 不会立即扫描；需要按 s 或运行
/scan。
也可以在命令面板中替换当前扫描根目录：
/scan /home/me/projects/app-one /home/me/Downloads
加上 --global 可以同时包含已知系统清理位置：
/scan /home/me/projects --global
在命令面板中，按 /，输入 global，再按 Enter，即可选择
/scan --global 快捷项，不需要记住参数。
使用 --global-kind 可以缩小全局预设范围。传入分类时会自动启用全局扫描：
/scan --global-kind browser-caches
TUI 中输入的路径不会经过 Shell 展开，因此 ~ 和环境变量会被当成普通文字。
请使用绝对路径。路径包含空格时，建议在启动 Cleanr 时通过带引号的参数传入。
审阅和选择候选项
扫描完成后按 r 或运行 /review。审阅页面会显示候选路径、大小、置信度、
匹配原因和风险说明。
来自内置规则或可信插件的高置信度条目可能会被预选。中低置信度条目，以及 未信任插件的所有匹配，默认不会选中。
TUI、cleanr analyze、cleanr plan 和 cleanr dry-run 使用同一项
[recommendations].preselect_after_days 策略。默认值是 90 天；设为 0 可关闭
年龄门槛。
审阅时常用快捷键：
| 按键 | 作用 |
|---|---|
j / k、↓ / ↑ | 在列表中移动 |
gg / G | 跳到第一项 / 最后一项 |
space 或 Enter | 选择或取消当前条目 |
a 或 % | 全选或全部取消 |
c | 进入清理确认 |
h 或 Esc | 返回首页 |
? | 打开快捷键帮助 |
q | 退出 |
列表移动支持数字前缀，例如 5j 向下移动 5 项，12G 跳到第 12 项。
清理已选条目
按 c 或运行 /clean，检查已选数量和大小。默认配置下，Cleanr 会要求
确认，并且初始选中“否”。
确认后，每个条目都会再次校验，然后移动到系统回收站。失败会逐项记录； 某一项失败不会掩盖其他条目的执行结果。
/clean --confirm 会跳过确认对话框，把当前选择作为本地用户的显式操作直接
执行。只应在已经审阅计划后使用。
恢复一次清理
运行 /restore，选择一条清理记录并按 Enter，确认后会尝试把可用条目移回
原路径。
以下情况可能导致恢复失败：
- 条目已经不在系统回收站；
- 原路径已经存在新的文件或目录；
- 操作系统无法识别原来的回收站条目；
- 当前平台不支持程序化恢复。
Cleanr 不会覆盖已经存在的恢复目标。
非交互命令
不需要打开 TUI 时，可以在脚本或终端中使用这些命令：
cleanr scan --json /path/to/project
cleanr analyze /path/to/project
cleanr plan --output cleanr-plan.json /path/to/project
cleanr dry-run --json /path/to/project
cleanr restore list
cleanr restore run <run-id> --confirm
analyze 始终输出带版本、仅限本地的 AnalysisReport JSON；不会创建清理计划或
移动文件。输出包含真实本地路径，除非自行完成脱敏，否则只应交给本地 Agent。它与
TUI、plan 和 dry-run 共用 [recommendations].preselect_after_days。dry-run
和 plan 只生成清理计划。恢复仍然要求显式传入 --confirm。
斜杠命令
按 / 打开命令面板。需要扫描结果的命令会在扫描完成后出现。
| 命令 | 作用 |
|---|---|
/scan [path...] [--global] [--global-kind=<kind>] | 扫描路径或已知系统清理位置 |
/scan --global | 扫描所有已知系统清理位置 |
/usage [path...] [--global] [--global-kind=<kind>] | 扫描并打开磁盘用量摘要 |
/usage --global | 扫描已知系统清理位置并打开用量摘要 |
/review | 生成并显示清理候选项 |
/plan | 生成当前清理计划 |
/clean | 检查当前选择并请求确认 |
/clean --confirm | 不显示对话框，直接执行当前选择 |
/export-plan [path] | 导出 JSON 计划，默认文件为 cleanr-plan.json |
/restore | 打开清理历史并恢复一次运行 |
/rules | 查看启用的规则包和规则 |
/plugins | 查看已加载的声明式插件 |
/languages | 查看并切换已安装语言 |
/tasks | 查看当前会话的任务活动 |
/help | 打开快捷键帮助 |
/quit | 退出 Cleanr |
/stats 是 /usage 的别名，/lang 是 /languages 的别名，/q 是
/quit 的别名。
只查看磁盘用量
按 u 或运行 /usage。它会执行扫描并打开以大小为主的视图，不会移动文件，
也不会自动执行清理计划。
安全取消或退出
- 扫描过程中按
Esc或x请求取消。 - 非扫描状态下，
Esc或h返回首页。 q或Ctrl+C退出 Cleanr 并恢复终端状态。