Explain Changes

此功能仅在 **VS Code** 中可用。带内联注释的差异视图需要 VS Code 的原生差异功能。

解释更改是一个 AI 驱动的代码审查功能,它向你的代码更改添加内联解释。当 Cline 修改你的代码库时,你可以点击按钮获取流式、上下文感知的解释,这些解释直接出现在 VS Code 的差异视图中。

工作原理

解释更改需要启用 **[检查点](/features/checkpoints)**。在使用此功能之前,请确保在 Cline 设置中启用检查点。

当 Cline 完成涉及文件更改的任务后,你会在完成消息中看到"解释更改"按钮与"查看更改"按钮并排。点击此按钮:

  1. 打开显示所有已更改文件的多文件差异视图

  2. 将 AI 生成的解释作为内联注释流式传输

  3. 在相关代码位置放置注释,以解释更改内容和原因

AI 使用完整的对话上下文提供有意义的解释,不仅描述代码的作用,还解释更改背后的推理。

交互式注释线程

解释更改最强大的方面之一是注释是完全交互式的。你可以直接在每个注释线程中进行对话。

提出后续问题

每个解释注释都有一个回复输入,你可以询问有关该特定代码片段的问题:

  • "你为什么使用这种方法而不是 X?"

  • "你能更详细地解释这个模式吗?"

  • "如果我们将其更改为 Y 会发生什么?"

AI 将响应具有上下文感知的答案,理解正在讨论的代码和原始任务上下文。

移动到主聊天

如果注释线程中的对话变得复杂,或者你想要继续处理该代码,点击注释线程的标题区域,将整个对话移动到 Cline 的主聊天输入中。这让你可以:

  • 继续讨论,具有完整的 Cline 能力

  • 让 Cline 根据讨论进行其他更改

  • 从审查对话中保留上下文

何时使用解释更改

学习和用户接入

当你是新加入代码库或使用不熟悉的模式时,解释更改帮助你不仅理解 Cline 做了什么,还理解为什么。解释涵盖:

  • 设计决策和权衡

  • 使用的技术概念和模式

  • 不同更改之间的关系

代码审查

使用解释更改作为你审查过程的一部分:

  • 在提交之前理解复杂的更改

  • 验证 AI 的推理是否符合你的期望

  • 通过理解完整上下文来捕获潜在问题

知识转移

解释作为你更改的文档。当其他团队成员审查你的代码时,他们可以看到每个修改背后的推理。

最佳实践

  1. 提出具体问题:你的后续问题越具体,AI 的响应就越有用。

  2. 用于复杂更改:解释更改对于多文件更改或复杂逻辑最有价值。对于简单更改,仅差异视图可能就足够了。

  3. 将重要讨论移动到聊天:如果注释线程揭示需要更多工作的内容,将其移动到主聊天以采取行动。

  4. 在提交之前审查:使用解释更改作为提交更改之前的最后检查,以确保你理解 Cline 所做的一切。

相关功能

Last updated