上下文提及
上下文提是一种强大的方式，可以向 Roo Code 提供有关项目的特定信息，使其能够更准确、更高效地执行任务。你可以使用提及来引用文件、文件夹、问题和 Git 提交。上下文提及以 @ 符号开头。
上下文提及概述，显示聊天界面中的 @ 符号下拉菜单。
提及类型
文件提及将实际代码内容添加到对话中，用于直接引用和分析。
| 提及类型 | 格式 | 描述 | 示例用法 |
|---|---|---|---|
| 文件 | @/path/to/file.ts | 包含文件内容在请求上下文中 | "解释 @/src/utils.ts 中的函数" |
| 文件夹 | @/path/to/folder | 包含文件夹中所有文件的内容（非递归） | "分析 @/src/components 中的代码" |
| 问题 | @problems | 包含 VS Code 问题面板的诊断信息 | "@problems 修复我代码中的所有错误" |
| 终端 | @terminal | 包含最近的终端命令和输出 | "修复 @terminal 中显示的错误" |
| Git 提交 | @a1b2c3d | 通过哈希引用特定提交 | "提交 @a1b2c3d 中有什么变化？" |
| Git 变更 | @git-changes | 显示未提交的变更 | "为 @git-changes 建议一条提交消息" |
| URL | @https://example.com | 导入网站内容 | "总结 @https://docusaurus.io/" |
文件提及
文件提及将带行号的源代码纳入上下文，用于精确定位。
| 功能 | 详细信息 |
|---|---|
| 格式 | @/path/to/file.ts（始终从工作区根目录开始以 / 开头） |
| 提供 | 完整的文件内容和行号 |
| 支持 | 文本文件、PDF 和 DOCX 文件（带文本提取） |
| 适用场景 | 初始请求、反馈响应和后续消息 |
| 限制 | 非常大的文件可能被截断；不支持二进制文件 |
文件夹提及
文件夹提及包含指定目录中所有文件的内容。
| 功能 | 详细信息 |
|---|---|
| 格式 | @/path/to/folder（无尾随斜杠） |
| 提供 | 目录中所有文件的完整内容 |
| 包含 | 直接位于文件夹内的非二进制文本文件的内容（非递归） |
| 最佳用途 | 从目录中的多个文件提供上下文 |
| 提示 | 引用大型目录时要注意上下文窗口限制 |
问题提及
问题提及直接从 VS Code 问题面板导入诊断信息。
| 功能 | 详细信息 |
|---|---|
| 格式 | @problems |
| 提供 | VS Code 问题面板中的所有错误和警告 |
| 包含 | 文件路径、行号和诊断消息 |
| 分组 | 问题按文件组织，以便更清晰 |
| 最佳用途 | 无需手动复制即可修复错误 |
有关 Roo Code 如何与 VSCode 诊断系统集成的详细信息，请参阅 诊断集成。
终端提及
终端提及捕获最近的命令和完整输出，用于调试和分析。
| 功能 | 详细信息 |
|---|---|
| 格式 | @terminal |
| 捕获 | 最后一条命令及其完整输出 |
| 保留 | 终端状态（不清空终端） |
| 限制 | 仅限于可见的终端缓冲区内容 |
| 最佳用途 | 调试构建错误或分析命令输出 |
Git 提及
Git 提及提供提交消息和差异，用于上下文感知的版本分析。
| 类型 | 格式 | 提供 | 限制 |
|---|---|---|---|
| 提交 | @a1b2c3d | 提交消息、作者、日期和完整差异 | 仅在 Git 仓库中工作 |
| 工作变更 | @git-changes | git status 输出和未提交变更的差异 | 仅在 Git 仓库中工作 |
URL 提及
URL 提及导入外部网页内容并将其转换为可读的 Markdown 格式。
| 功能 | 详细信息 |
|---|---|
| 格式 | @https://example.com |
| 处理 | 使用无头浏览器获取内容 |
| 清理 | 删除脚本、样式和导航元素 |
| 输出 | 将内容转换为 Markdown 以提高可读性 |
| 限制 | 复杂页面可能无法完美转换 |
如何使用提及
- 在聊天输入框中键入
@以触发建议下拉菜单 - 继续键入以筛选建议，或使用箭头键导航
- 按 Enter 键或单击鼠标选择
- 在请求中组合多个提及："修复 @/src/component.ts 中的 @problems"
下拉菜单会自动建议：
- 最近打开的文件
- 可见的文件夹
- 最近的 git 提交
- 特殊关键字（
problems、terminal、git-changes） - 所有当前打开的文件（无论忽略设置或目录过滤器如何）
下拉菜单会自动过滤掉常见的目录，如 node_modules、.git、dist 和 out，以减少干扰，即使手动键入时仍可包含其内容。
重要行为
忽略文件交互
| 行为 | 描述 |
|---|---|
.rooignore 绕过 | 文件和文件夹的 @提及 在为上下文获取内容时会绕过 .rooignore 检查。如果直接提及，来自被忽略文件的内容将被包含。 |
.gitignore 绕过 | 类似地，文件和文件夹的 @提及 在获取内容时不会遵守 .gitignore 规则。 |
| Git 命令遵守 | Git 相关的提及（@git-changes、@commit-hash）会遵守 .gitignore，因为它们依赖于 Git 命令。 |