跳过主要内容
@ 提及是 Cline 最强大的功能之一，可让您将外部上下文无缝地引入对话中。您无需复制粘贴代码、错误消息或文档，只需使用 @ 符号来引用它们。
@ Mentions Overview
当您在聊天输入中输入 @ 时，Cline 会显示一个可用提及类型的菜单。这些提及允许您在对话中直接引用文件、文件夹、问题、终端输出、Git 更改甚至网页内容。

​
可用的 @ 提及

Cline 支持多种类型的 @ 提及，每种类型都旨在将不同类型的上下文引入您的对话中

文件提及

使用 @/path/to/file 引用工作空间中的任何文件。Cline 会查看完整的文件内容，包括导入、相关函数和周围上下文。

文件夹提及

使用 @/path/to/folder/ 引用整个目录。Cline 会查看文件夹结构和所有文件内容，非常适合理解多个文件之间复杂的交互。

问题提及

使用 @problems 向 Cline 显示工作空间中的所有错误和警告。Cline 会查看包含文件位置和错误消息的完整列表。

终端提及

使用 @terminal 分享您最近的终端输出。Cline 会查看保留格式的完整输出，非常适合调试构建错误或测试失败。

Git 提及

使用 @git-changes 引用未提交的更改，或使用 @[commit-hash] 引用特定的提交。Cline 会查看完整的差异、提交消息和其他相关信息。

URL 提及

使用 @https://example.com 引用网页内容。Cline 会获取并查看完整的网页内容，非常适合引用文档或 GitHub 问题。

​
为何 @ 提及至关重要

@ 提及通过以下方式改变您与 Cline 的交互方式：
  1. 消除复制粘贴：无需再复制粘贴代码、错误消息或终端输出。只需直接引用它们。
  2. 保留上下文：Cline 会查看完整的上下文，包括导入、相关函数以及可能相关的周围代码。
  3. 保持格式：终端输出、错误消息和网页内容都会保留其格式，使其更易于理解。
  4. 启用复杂工作流：结合多个 @ 提及，为 Cline 提供您问题的完整视图 
    I'm getting these errors: @problems

Here's my component: @/src/components/Form.jsx
And the API endpoint: @/src/api/users.js

The error happens when I submit: @terminal

I think this commit might have caused it: @a1b2c3d

​
入门

使用 @ 提及
  1. 在聊天输入中输入 @
  2. 从菜单中选择提及类型或继续输入
  3. 对于文件和文件夹，浏览您的工作空间结构
  4. 照常发送您的消息
Cline 将自动处理提及并将引用的内容包含在发送给 AI 的上下文中。 尝试在下次与 Cline 的对话中使用 @ 提及——当您可以无缝引入外部上下文时，您会惊讶于交互效率和效果的提高。

​
幕后工作原理

当您在消息中使用 @ 提及时，幕后会发生一个复杂的过程
  1. 检测：当您发送消息时，Cline 使用正则表达式扫描文本中的 @ 提及模式
  2. 处理：对于每个检测到的提及，Cline 会
    • 确定提及类型（文件、文件夹、问题、终端、Git、URL）
    • 获取相关内容（文件内容、终端输出等）
    • 适当格式化内容
  3. 增强：原始消息会通过结构化数据得到增强 
    Your original message with @/path/to/file

<file_content path="/path/to/file">
[Complete file content]
</file_content>
  4. 上下文包含：此包含所有嵌入内容的增强消息会发送给 AI 模型
  5. 无缝响应：AI 现在可以“看到”所有引用的内容，就像您手动复制粘贴一样
每当您使用 @ 提及时，整个过程都会自动无缝发生，无需您手动复制任何内容，即可为 AI 提供完整的上下文。 每种类型的 @ 提及都有其特定的实现细节，您可以在各自的文档页面中找到。