dry-run 与 clean

dry-run 会做什么

tnmsc dry-run 会预览当前执行将要写入的文件和目录。它在以下场景中特别有用：

• 首次接入一个项目时
• 修改 plugin.config.ts 之后
• 修改源 prompt 作用域或全局配置之后
• 想验证一次较大源内容变更的影响之前

clean 会做什么

tnmsc clean 会移除生成出的输出文件。它不是一个盲删目录的命令，而是遵循当前输出模型和运行时内建的清理声明来执行。

常规清理完成后，tnmsc clean 还会扫描当前项目源码树，删除剩余的空目录。这个空目录扫描会明确跳过 Git 内部目录，以及依赖、构建输出和缓存目录树。

在真正执行之前，优先先运行：

tnmsc clean --dry-run

--dry-run 也会显示后续将被移除的空目录。

风险边界

如果你的输出目录里还混有手写文件或其他工具生成的内容，不要依赖 ~/.aindex/.tnmsc.json 中的 cleanupProtection 配置块。应把这些文件移出 tnmsc 管理的输出路径，或者在真正执行清理前调整项目或插件装配方式。

推荐习惯

1. 当你修改配置、源作用域或插件装配时，先运行 dry-run。
2. 当你确实准备清理时，先运行 clean --dry-run。
3. 如果结果看起来不对，请继续查看 故障排查。