Skip to main content
文件提及让你可以将工作区中的任何文件直接引入与 Cline 的对话中。不再需要复制和粘贴代码片段 - 只需输入 @/ 并指向你需要帮助的文件。 当你在聊天中输入 @/ 时,Cline 会显示你的工作区文件。浏览文件夹,选择你想要的文件,它会立即对 Cline 可用 - 包含所有导入、相关函数和周围上下文。 我在调试时经常使用文件提及。不再需要尝试确定要复制代码的哪些部分,我只需直接引用文件:
我的表单提交时出现这个错误:@terminal

这是我的组件:@/src/components/ContactForm.jsx

这是 API 端点:@/src/api/contact.js

我遗漏了什么?
这为 Cline 提供了所需的一切 - 错误消息、组件代码和 API 端点 - 而我无需复制任何内容。Cline 可以看到导入、依赖关系以及可能导致问题的所有周围上下文。 当你处理跨越多个文件的复杂错误时,文件提及功能会发光。以前,我必须仔细复制每个相关文件,确保不遗漏任何重要内容。现在我只需用 @/ 引用每个文件,Cline 就能获得完整的图片。 下次遇到问题时,尝试使用文件提及而不是复制代码。你会节省时间并获得更好的答案,因为 Cline 拥有所需的所有上下文。

底层工作原理

当你在消息中使用文件提及时,这是背后发生的情况:
  1. 当你发送消息时,Cline 检测文本中的 @/path/to/file 模式
  2. 扩展程序解析相对于工作区根目录的文件路径
  3. 它检查文件是二进制文件(如图像)还是基于文本的
  4. 对于文本文件,它读取完整的文件内容
  5. 文件内容以结构化格式附加到你的消息中:
    <file_content path="path/to/file">
    [完整文件内容]
    </file_content>
    
  6. 这个增强的消息与嵌入的文件内容一起发送给 AI
  7. AI 现在可以”看到”完整的文件内容,就像你复制粘贴过一样
每当你使用文件提及时,这个无缝过程都会自动发生,为 AI 提供完整上下文,而无需你手动复制任何内容。