File Mentions

文件引用让你可以直接将工作区中的任何文件拉入与 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 提供完整的上下文，而无需你手动复制任何内容。