Skip to main content

文件引用

文件引用让您可以直接将工作区中的任何文件拉入与 Caret 的对话中。无需再复制和粘贴代码片段 - 只需输入 @/ 并指向您需要帮助的文件。

当您在聊天中输入 @/ 时，Caret 会显示您的工作区文件。浏览文件夹，选择您想要的文件，它就会立即可供 Caret 使用 - 包含所有导入、相关函数和周围的上下文。

我在调试时经常使用文件引用。不需要考虑要复制代码的哪些部分，我只需直接引用文件：

我的表单提交时遇到这个错误：@terminal

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

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

我遗漏了什么？

这为 Caret 提供了所需的一切 - 错误消息、组件代码和 API 端点 - 而我无需复制任何内容。Caret 可以看到导入、依赖项和所有可能导致问题的周围上下文。

文件引用在处理跨多个文件的复杂错误时特别有用。以前，我必须仔细复制每个相关文件，确保不遗漏任何重要内容。现在我只需用 @/ 引用每个文件，Caret 就能获得完整的画面。

下次遇到问题时，尝试使用文件引用而不是复制代码。您将节省时间并获得更好的答案，因为 Caret 拥有所需的所有上下文。

底层工作原理​

当您在消息中使用文件引用时，以下是幕后发生的事情：

  1. 当您发送消息时，Caret 在您的文本中检测 @/path/to/file 模式
  2. 扩展程序相对于您的工作区根目录解析文件路径
  3. 它检查文件是二进制文件（如图像）还是基于文本的文件
  4. 对于文本文件，它读取完整的文件内容
  5. 文件内容以结构化格式附加到您的消息中： 
    <file_content path="path/to/file">
    [完整文件内容]
    </file_content>
  6. 这条包含嵌入文件内容的增强消息被发送给 AI
  7. AI 现在可以"看到"完整的文件内容，就像您复制粘贴了它一样

每当您使用文件引用时，这个无缝过程都会自动发生，为 AI 提供完整的上下文，而您无需手动复制任何内容。