让说明跟上变化 — Noea Code 文档

修改意图或代码后，需要检查实现说明是否仍然适用。使用侧栏“解释”可处理项目中需要更新的说明；使用段落旁的“调查”可只检查一处内容。

先看变化发生在哪里

“可能已过时”不一定意味着结论错误，文件变化可能与该结论无关；“未发现更改”也不是测试通过或功能完整的证明。

如果你只在意一处内容，先保存文档，再将鼠标移到该段落，在左侧选择“调查”。已有说明的旁注也可能提供“重新调查”。

这只会更新所选内容的说明。有未保存的修改时，调查不可用，界面会提示先保存。

例如，刚改过奖励重复发放的代码，可以针对对应规则重新调查，检查它是否正确描述了当前实现。

点击侧栏“解释”，检查待调查的内容，以及依据文件发生变化的说明。没有关联实现文件夹、项目只读或未打开项目时，这项操作不可用。

手动发起解释后，会打开一个对话，显示阶段、进度和逐项结果。运行期间不能在这个对话中发送普通消息，但可以继续使用项目中的其他对话。

任务结束后，展开结果，查看哪些说明已更新、哪些仍然成立，以及哪些内容检查失败或尚未完成。“已结束”不表示所有内容都检查成功。

解释任务会对照意图和代码，检查总体说明与局部说明。仍准确的内容会保留，需要修正的部分才更新，不一定重写全部说明。

说明更新不等于重新运行过测试。需要验证具体行为时，先在普通对话中要求 Agent 执行验证，再调查相关内容。如何判断验证范围，见阅读实现说明与证据。

“设置 → 当前项目 → 自动化”中的“实现后自动解释”默认开启。以下是主要触发规则：

自动解释在后台运行，不会新建普通对话。你可以继续原对话，并在“运行记录”中查看进度。

侧栏“运行记录”保存解释任务。展开任务后，可以查看每次执行的只读记录；切换对话或重启应用后，记录仍然保留。

任务失败或停止后，使用“再次运行”，已有说明会保留。新任务结束后，检查此前失败或未完成的内容是否已处理。

解释使用哪个 Agent，取决于任务的发起方式。项目操作的配置入口与适用范围见Agent、模型与用量。

如果说明无法更新，见常见问题与故障排查。