Explain Changes
此功能仅在 **VS Code** 中可用。带内联注释的差异视图需要 VS Code 的原生差异功能。
解释更改是一个 AI 驱动的代码审查功能,它向你的代码更改添加内联解释。当 Cline 修改你的代码库时,你可以点击按钮获取流式、上下文感知的解释,这些解释直接出现在 VS Code 的差异视图中。
工作原理
解释更改需要启用 **[检查点](/features/checkpoints)**。在使用此功能之前,请确保在 Cline 设置中启用检查点。
当 Cline 完成涉及文件更改的任务后,你会在完成消息中看到"解释更改"按钮与"查看更改"按钮并排。点击此按钮:
打开显示所有已更改文件的多文件差异视图
将 AI 生成的解释作为内联注释流式传输
在相关代码位置放置注释,以解释更改内容和原因
AI 使用完整的对话上下文提供有意义的解释,不仅描述代码的作用,还解释更改背后的推理。
交互式注释线程
解释更改最强大的方面之一是注释是完全交互式的。你可以直接在每个注释线程中进行对话。
提出后续问题
每个解释注释都有一个回复输入,你可以询问有关该特定代码片段的问题:
"你为什么使用这种方法而不是 X?"
"你能更详细地解释这个模式吗?"
"如果我们将其更改为 Y 会发生什么?"
AI 将响应具有上下文感知的答案,理解正在讨论的代码和原始任务上下文。
移动到主聊天
如果注释线程中的对话变得复杂,或者你想要继续处理该代码,点击注释线程的标题区域,将整个对话移动到 Cline 的主聊天输入中。这让你可以:
继续讨论,具有完整的 Cline 能力
让 Cline 根据讨论进行其他更改
从审查对话中保留上下文
何时使用解释更改
学习和用户接入
当你是新加入代码库或使用不熟悉的模式时,解释更改帮助你不仅理解 Cline 做了什么,还理解为什么。解释涵盖:
设计决策和权衡
使用的技术概念和模式
不同更改之间的关系
代码审查
使用解释更改作为你审查过程的一部分:
在提交之前理解复杂的更改
验证 AI 的推理是否符合你的期望
通过理解完整上下文来捕获潜在问题
知识转移
解释作为你更改的文档。当其他团队成员审查你的代码时,他们可以看到每个修改背后的推理。
最佳实践
提出具体问题:你的后续问题越具体,AI 的响应就越有用。
用于复杂更改:解释更改对于多文件更改或复杂逻辑最有价值。对于简单更改,仅差异视图可能就足够了。
将重要讨论移动到聊天:如果注释线程揭示需要更多工作的内容,将其移动到主聊天以采取行动。
在提交之前审查:使用解释更改作为提交更改之前的最后检查,以确保你理解 Cline 所做的一切。
相关功能
检查点 - 解释更改工作所必需的
/explain-changes - 用于解释任何 git 差异的斜杠命令
Last updated