对话与上下文

侧边对话与行内对话、图片与语音输入、会话副本、回退消息、分享对话；用

对话

TraeCode 提供多种与 AI 助手对话的方式，帮助你完成代码问答、仓库理解、代码生成、错误修复、代码优化等任务。可以按场景选择侧边对话或行内对话，也可以补充必要的上下文让 AI 更准确地理解需求。

侧边对话：面板位于 TraeCode 右侧，适合较完整的任务沟通，如解释代码仓库、生成代码片段、修复错误、规划实现方案；默认显示，被关闭时可以用快捷键（macOS：Command + U / Windows：Ctrl + U）重新打开。提问前建议按任务选择合适的模型与智能体，并添加必要的代码、文件、图片等上下文；输入问题后，可以点模型名称右侧的「优化输入内容」图标，让 AI 帮你把指令改得更清晰。行内对话：让你无需离开编辑器，在编码过程中围绕当前代码与 AI 交互，保持编码心流。打开方式：把光标置于目标位置，或选中一段代码，然后用快捷键（macOS：Command + I / Windows：Ctrl + I），选中代码时也可以点代码悬浮菜单里的「编辑」按钮。

图片输入：可以添加报错截图、产品设计稿或参考样式作为上下文，让 AI 更直观地理解需求。上传方式：从外部或项目文件树把图片拖进对话输入框；在输入框里粘贴剪贴板里的图片；点输入框左下角的 + > 上传图片从本地选择。语音输入：点侧边对话输入框右下角的语音输入图标开始说话，系统把语音转成文字填入输入框，发送前可以手动编辑；首次使用需要授权麦克风权限（macOS：系统设置 > 隐私 & 安全性 > 麦克风；Windows：开始 > 设置 > 隐私 & 安全性 > 应用权限里的麦克风）。创建会话副本（Fork Chat）：在多轮对话中，可以从任意一条 AI 回复创建新的独立对话，新对话继承该回复之前的全部上下文并自动切换进入，原对话保持不变（点 AI 回复底部右侧的「创建会话副本」图标）。回退消息：任务完成后，可以把对话和相关文件变更回退到某条消息发出前的状态：回退会移除所选消息及其之后的所有消息，并同步回退这些消息产生的文件变更，回退前要确认不再需要它们（需要保留的先复制或备份）；任务执行中无法回退，要先点输入框里的「停止」，再把鼠标悬浮到要回退的消息上点其下方的「回退」图标。分享对话：悬浮到任一 Query 或答复点底部的「分享」图标，或点对话框右上角的分享图标，进入「选择对话」面板选择要分享的内容，再选形式：生成图片（复制或下载后发给别人）或分享链接（生成链接和二维码，他人打开即可查看）。

上下文基础用法

与 AI 助手对话时，可以指定上下文供它阅读和理解，使答复更精准。把编辑器里的内容作为上下文：编辑器里有正在编辑的代码文件时，AI 默认能看到当前文件，可以直接提问；想针对某一段代码提问，先选中代码，再点悬浮菜单里的「添加到对话」，指定的上下文会显示在侧边对话底部的输入框里（显示文件名和所选行号），还可以继续添加其他片段或其他来源的上下文。把终端里的内容作为上下文：想对终端输出提问（如让它帮你修复报错），点终端里的输出内容片段，再点其右上角的「添加到对话」。

用 # 引用上下文

在侧边对话输入框里输入 #（或点输入框左下角的 # 图标），上方出现上下文类型列表；TraeCode 优先推荐与当前打开文件相关的内容，你也可以搜索，并可同时添加多种类型：

类型	适用场景
`#Code`	只需要让 AI 理解某个函数或类
`#File`	需要让 AI 阅读完整的文件
`#Folder`	需求涉及某个目录下的多个文件
`#Workspace`	需要 AI 从整个项目中查找相关内容
`#Doc`	需要引用个人文档集或外部文档
`#Problems`	需要 AI 分析「问题」页签中的诊断信息
`#Web`	需要联网搜索或读取网页内容
`#Rule`	需要引用为当前项目创建的项目级规则
`#Past Chats`	需要引用历史对话内容

#Code：把函数或类的相关代码作为上下文，列表默认展示当前编辑器打开文件里的函数或类，选择前可以预览，也可以按关键词搜索；如果没有安装对应语言的语言服务，可能识别不了代码符号，建议先安装对应语言扩展。
#File：把指定文件的全部内容作为上下文，默认列出近期在编辑器里打开过的文件，可预览所在目录以免选错同名文件。
#Folder：把指定文件夹的全部内容作为上下文；依赖项目代码索引是否构建完全，索引未建完会影响召回效果（提问时 References 位置会显示「索引构建中」或「索引暂未构建」）。
#Workspace：就整个工作空间提问，AI 自动在工作空间里查找最相关的内容，遇到不熟悉的项目时能帮你全局了解它实现的功能和代码；同样依赖代码索引。
#Doc：上传个人文档集作为上下文。创建时 TraeCode 会针对文档集内容构建索引：过程中文档数据被传输到 TRAE 服务器做矢量化，TraeCode 不读取或存储任何文档数据，矢量化完成后文档数据和矢量数据都从服务器删除，返回你的设备并存储在本地；在 TraeCode 里删除文档集后本地数据也被同步删除。创建步骤：设置 > 索引与文档 > 添加文档集，方式有两种：通过 URL 添加（以入口 URL 为起点，自动抓取同一站点里与入口 URL 同级路径或子路径下、最多三次跳转内的页面；遵循网页的 /robots.txt，被网站拒绝则无法索引，列表显示「网站限制无法访问」；只用于查看公开可访问的技术文档类网站，用于学习和研究）；从本地文件添加（文件格式 .md 和 .txt，单个文件最大 10 MB，文档集最大 50 MB，文件数不超过 1000 个）。添加完成后可以修改文档集名称、重新索引或删除。
#Problems：向 AI 发送指令时带上它，AI 会全量分析「问题」页签里报告的所有问题并提供解决方案。
#Web：把线上网站内容作为上下文：直接在 #Web 后输入指令会触发联网搜索；先输入网址再输入指令，AI 会直接从该网站查询相关内容，还能同时从多个网站检索。
#Rule：把当前项目 .trae/rules/ 里的项目级规则作为上下文。
#Past Chats：把当前项目里的历史对话作为上下文；要启用，前往设置 > Beta > 历史对话，打开「启用历史对话」开关。

工作区代码索引

可以为项目构建索引：构建后，通过 #Workspace 或 #Folder 与 AI 对话时，AI 能理解你当前打开的项目并用整个项目作为上下文回答，更精准。未构建或构建不完全时，可能召回不完整的上下文导致回答不完整。对文件数小于等于 5000 的项目，TraeCode 打开项目时自动构建索引；文件数大于 5000 又希望项目级回答更准确时，需要手动发起：前往设置 > 代码与索引，在「工作区」部分打开「代码索引构建」开关并点「构建」。可以通过配置忽略文件，指定构建索引时剔除哪些文件：被忽略的文件完全被排除在索引之外，有效保护敏感数据。