dry-run 与 clean

dry-run 的职责

tnmsc dry-run 用来预览当前执行会写出哪些文件与目录。它适合在这些场景先跑一遍：

• 第一次接入某个项目
• 刚修改过 plugin.config.ts
• 刚改过 输出范围
• 准备验证某次批量源内容变更的影响

clean 的职责

tnmsc clean 用来清除已生成的输出文件。它不是“无差别删目录”，而是依据当前输出模型和清理保护规则执行。

在完成常规 cleanup 之后，tnmsc clean 还会继续扫描当前 project 的源码树，把剩余的空目录一并清掉。这个 empty-dir sweep 会明确跳过 Git 内部目录，以及依赖、构建产物、缓存一类目录树。

在真正执行前，优先用：

tnmsc clean --dry-run

--dry-run 也会把这些后续会被清掉的空目录一起展示出来。

风险边界

如果输出目录里混有人工文件或其他工具产物，必须先看 清理保护。没有保护规则时，clean 的风险会显著上升。

推荐习惯

1. 改配置或换项目时先 dry-run
2. 真要清理时先 clean --dry-run
3. 出现异常时再结合 排障 定位