> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# @ 提及概述

@ 提及是 Cline 最强大的功能之一，让您可以无缝地将外部上下文引入对话中。无需复制粘贴代码、错误消息或文档，您只需使用 @ 符号简单引用它们。

![@ 提及概述](https://storage.googleapis.com/cline_public_images/docs/assets/at-mentions.png)

当您在聊天输入中键入 `@` 时，Cline 会显示可用提及类型的菜单。这些提及让您可以直接在对话中引用文件、文件夹、问题、终端输出、git 更改，甚至网页内容。

## 可用的 @ 提及

Cline 支持多种类型的 @ 提及，每种都设计用于将不同类型的上下文引入您的对话：

> [card] [文件提及](https://cat.mintlify.site/features/at-mentions/file-mentions.md)
>
> 使用 `@/path/to/file` 引用工作空间中的任何文件。Cline 可以看到完整的文件内容，包括导入、相关函数和周围上下文。

 

> [card] [文件夹提及](https://cat.mintlify.site/features/at-mentions/folder-mentions)
>
> 使用 `@/path/to/folder/` 引用整个目录。Cline 可以看到文件夹结构和所有文件内容，非常适合理解多个文件之间的复杂交互。

 

> [card] [问题提及](https://cat.mintlify.site/features/at-mentions/problem-mentions.md)
>
> 使用 `@problems` 向 Cline 显示工作空间中的所有错误和警告。Cline 可以看到包含文件位置和错误消息的完整列表。

 

> [card] [终端提及](https://cat.mintlify.site/features/at-mentions/terminal-mentions.md)
>
> 使用 `@terminal` 分享您最近的终端输出。Cline 可以看到保留格式的完整输出，非常适合调试构建错误或测试失败。

 

> [card] [Git 提及](https://cat.mintlify.site/features/at-mentions/git-mentions.md)
>
> 使用 `@git-changes` 引用未提交的更改或使用 `@[commit-hash]` 引用特定提交。Cline 可以看到完整的差异、提交消息和其他相关信息。

> [card] [URL 提及](https://cat.mintlify.site/features/at-mentions/url-mentions.md)
>
> 使用 `@https://example.com` 引用网页内容。Cline 获取并查看完整的网页内容，非常适合引用文档或 GitHub 问题。

## 为什么 @ 提及很重要

@ 提及通过以下方式改变您与 Cline 的交互：

1. **消除复制粘贴**：不再需要复制粘贴代码、错误消息或终端输出。只需直接引用它们。

2. **保留上下文**：Cline 可以看到完整的上下文，包括导入、相关函数和可能相关的周围代码。

3. **保持格式**：终端输出、错误消息和网页内容保持其格式，使它们更容易理解。

4. **启用复杂工作流程**：结合多个 @ 提及为 Cline 提供您问题的完整图片：

   ```
   我遇到了这些错误：@problems

   这是我的组件：@/src/components/Form.jsx
   这是 API 端点：@/src/api/users.js

   提交时发生错误：@terminal

   我认为这个提交可能导致了它：@a1b2c3d
   ```

## 开始使用

要使用 @ 提及：

1. 在聊天输入中键入 `@`
2. 从菜单中选择提及类型或继续键入
3. 对于文件和文件夹，导航您的工作空间结构
4. 像往常一样发送您的消息

Cline 将自动处理提及并将引用的内容包含在发送给 AI 的上下文中。

在您与 Cline 的下一次对话中尝试使用 @ 提及 - 当您可以无缝引入外部上下文时，您会惊讶于您的交互变得多么高效和有效。

## 底层工作原理

当您在消息中使用 @ 提及时，幕后有一个复杂的过程在进行：

1. **检测**：当您发送消息时，Cline 使用正则表达式扫描文本中的 @ 提及模式

2. **处理**：对于每个检测到的提及，Cline：
   * 确定提及类型（文件、文件夹、问题、终端、git、URL）
   * 获取相关内容（文件内容、终端输出等）
   * 适当格式化内容

3. **增强**：原始消息使用结构化数据增强：

   ```
   您带有 @/path/to/file 的原始消息

   <file_content path="/path/to/file">
   [完整文件内容]
   </file_content>
   ```

4. **上下文包含**：这个包含所有嵌入内容的增强消息被发送给 AI 模型

5. **无缝响应**：AI 现在可以"看到"所有引用的内容，就像您手动复制粘贴一样

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

每种类型的 @ 提及都有其特定的实现细节，您可以在各自的文档页面中找到。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.