让 AI 更懂你的需求！一文看懂如何在 Trae IDE 中巧用上下文

"上下文" 就是你与 Trae IDE 沟通时提供的各种背景信息。就像我们日常聊天时，需要知道对话的前因后果才能准确理解对方意思一样，Trae IDE 要更好地理解你的需求、提供精准帮助，也需要了解相关的 "背景资料"。

这些 "背景资料" 既包括 Trae IDE 内的信息，比如你正在编辑的代码仓库内容、终端显示的运行信息等；也涵盖外部信息，像你通过联网搜索获取的资料、主动上传的文档集等。有了这些上下文，Trae IDE 就能更懂你的需求，减少沟通成本，和你配合得更默契啦。

在Trae IDE中，你可以通过简单的 “#” 符号快速调用各类上下文，轻松与AI助手高效协作。以下分两类介绍常用操作：

如果你需要 AI 助手基于项目内的代码或文件信息提供帮助，可通过以下方式添加上下文：

1. 输入 # 唤起菜单：在对话输入框中输入 #，或点击左下角 # 上下文 按钮，选择对应类型（Code/File/Folder/Workspace）。

2. 按需选择内容：

#Code：快速定位函数或类（支持当前文件推荐、关键词搜索及代码预览）。

#File：指定单个文件内容（默认展示近期打开文件，支持目录预览避免错选）。

#Folder：添加整个文件夹内容（依赖项目代码索引，支持目录搜索）。

#Workspace：直接提问工作空间全局问题（AI 将自动匹配最相关内容）。

文档集与网页等外部上下文是 Trae AI IDE 中用于增强 AI 问答上下文理解的重要功能模块。通过将外部技术资料、接口文档、设计规范等预加载为上下文内容，Trae 的 AI 能够在回答问题时引用这些信息，提供更准确、更具项目相关性的回答。

1. 在 AI 对话窗口的右上角，点击 设置 图标 > 上下文，或在 AI 对话输入框中点击 # 上下文 >  Doc > 添加文档集。界面上显示 上下文 窗口。

2. 在 文档集 部分，点击 + 添加文档集 按钮。

3. 选择合适的方式添加文档集。

• 在菜单中选择 通过 URL 添加 选项，然后在弹窗中输入文档集名称和文档站的 URL。点击 确认 按钮后，Trae IDE 会自动抓取同一站点中与入口 URL 同级路径或子路径下，最多三次跳转内的页面内容。

• 在菜单中选择 从本地文件添加 选项，然后在弹窗中输入文档集名称并添加本地文件。Trae IDE 支持 .md 和 .txt 文件，单个文件最大 10 MB ，文档集最大 50 MB，共支持不超过 1000 个文件。

当需要将产品逻辑转化为代码时，通过 文档集（Doc） 上传产品需求文档、API 说明或业务规则文档，Trae 会基于这些上下文精准理解业务背景，避免 “需求偏差”：

● 操作实践：在对话中先引用文档集，再提出具体需求，例如：

• “#Doc 电商支付需求文档 请根据需求文档中的‘用户支付超时’规则，编写订单状态更新的后端逻辑”

• “#Doc API 接口说明 这个 API 的返回结构是什么样的”

● 作用：AI 直接关联文档中的业务规则、字段定义，生成的代码或回答更贴合实际需求，减少反复沟通确认的成本。

面对陌生依赖库或复杂工具时，通过 文档集（#Doc） 或 网页（#Web） 导入官方文档，AI 秒变 “随身手册”：

● 操作实践：

• 本地文档：将下载的库文档（如 Markdown/API 手册）通过 “从本地文件添加” 创建文档集，提问时直接引用（如 #Doc lodash文档 这个库怎么初始化？）。

• 在线文档：直接输入 #Web https://vuejs.org/guide/introduction.html Vue组件的生命周期钩子有哪些？，AI 会抓取指定网页内容并引用回答。

● 作用：无需手动切换页面搜索，AI 实时关联文档中的方法说明、参数示例，甚至能对比不同版本文档的差异，快速定位解决方案。

通过 #Doc 或 #Workspace 上传团队内部流程文档、代码规范、架构设计等资料，AI 化身 “智能导师” 辅助新成员上手：

● 操作实践：上传《代码提交规范.md》到文档集，新成员提问时直接调用（如 #Doc 代码提交规范 提交代码前需要运行哪些检查？）。

● 作用：新成员无需逐行翻看代码或频繁咨询同事，通过自然语言提问即可获取准确答案，加速熟悉项目技术栈和协作流程。

目前，Trae IDE 已经支持智能体，你可以将 #Doc 与 智能体 相结合，智能体将这些文档作为其工作理解的“知识根基”，从而做出更加贴合场景的响应。

● 操作实践： @前端项目工程师，向它提供 #Doc 项目规范，立即获得一位熟读项目手册的专家来帮你干活。

● 作用：当智能体与 #Doc 结合后，会形成“有内容、有能力、有边界”的 AI 协作体，每个智能体拥有独立的专业背景和知识域，共同协作完成复杂任务，更加接近“智能无限”。

实用技巧

在使用 #Doc 或 #Web 时，如果文档内容有所更新，请及时刷新 URL，使 Trae 可以掌握最新信息。

借助 #上下文，Trae IDE 的理解能力全面升级！ AI 从依赖模糊猜测的 “执行者”，转变为基于显式材料的 “理解者”。通过主动绑定代码、文件、文档集乃至全网信息，你可以 “教 AI 懂自己” ，塑造专属的 “知识型协作者”，让 AI 不仅理解自然语言，也理解“你的语言”。