> ## 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.

# URL 提及

URL 提及让你可以将网页内容直接引入与 Cline 的对话中。只需输入 `@` 后跟任何 URL，Cline 就能看到该网页的内容，而无需你复制粘贴任何内容。

当你在聊天中输入 `@` 后跟 URL（如 `@https://example.com`）时，Cline 将获取该网页的内容并将其包含在上下文中。这适用于文档页面、GitHub 问题、Stack Overflow 问题或你想要引用的任何其他网页内容。

当我使用外部 API 或库时，我经常使用 URL 提及。不再需要尝试解释 API 如何工作或复制文档片段，我只需直接引用文档：

```
我试图使用这个 API 实现认证：@https://api.example.com/docs/auth

你能帮我根据这些文档编写代码来获取访问令牌吗？
```

这为 Cline 提供了完整的文档页面，因此它可以看到所有认证要求、端点、参数和示例。然后 Cline 可以基于官方文档提供更准确和全面的帮助。

URL 提及对于引用 GitHub 问题或讨论特别有用：

```
我试图修复项目中的这个问题：@https://github.com/our-org/our-repo/issues/123

这是我当前的实现：@/src/components/Feature.jsx

我需要做什么更改来解决这个问题？
```

这向 Cline 显示了完整的 GitHub 问题，包括描述、评论以及任何代码片段或截图。然后 Cline 可以帮助你实现直接解决报告问题的解决方案。

下次使用外部文档或在线资源时，尝试使用 URL 提及而不是复制粘贴内容。你会得到更准确的帮助，因为 Cline 可以看到网页的完整上下文，包括格式、代码示例和周围信息。

## 底层工作原理

当你在消息中使用 URL 提及时，这是背后发生的情况：

1. 当你发送消息时，Cline 检测文本中的 `@http://...` 或 `@https://...` 模式

2. 扩展程序在后台启动无头浏览器（Puppeteer）

3. 它导航到 URL 并等待页面完全加载

4. 浏览器捕获页面内容，包括文本、格式和代码示例

5. 内容被转换为保留结构的 Markdown 格式

6. 这些内容以结构化格式附加到你的消息中：

   ```
   <url_content url="https://example.com/docs">
   # 示例 API 文档

   ## 认证

   要使用 API 进行认证，你需要...

   const token = await api.authenticate({
     username: 'user',
     password: 'pass'
   });

   [Markdown 格式的完整网页内容]
   </url_content>
   ```

7. 然后关闭浏览器以释放资源

8. 这个带有嵌入网页内容的增强消息被发送给 AI

每当你使用 URL 提及时，这个过程都会自动发生，为 AI 提供网页完整内容的访问权限，而无需你复制粘贴任何内容。


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