必须将项目文档等参考资料放入.ref/目录并用自然语言指令明确调用，TRAE才能结合ARCHITECTURE.md、OpenAPI规范等给出精准评审意见，否则仅按通用规则泛泛而谈。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Trae在代码评审中真正理解项目上下文、识别规范偏差、给出贴合团队实际的修复建议，就必须把项目文档、接口定义、历史PR评论等参考资料喂给它——否则AI只能凭通用规则泛泛而谈。
确认参考资料类型与存放位置
TRAE默认只读取代码文件和.git目录，【不自动扫描README.md、API文档、CONTRIBUTING.md、docs/目录或Jira链接】。你必须明确告诉它哪些外部材料属于本次评审的“参考依据”。常见有效资料包括：项目根目录下的ARCHITECTURE.md、后端服务的OpenAPI 3.0 YAML文件、前端组件库的Storybook链接、最近3次合并的PR评论快照（保存为pr_context.json）、团队内部《Java编码规范V2.3》PDF。
把这些文件统一放在项目根目录下新建的.ref/子目录里，例如.ref/api-spec.yaml、.ref/team-rules.pdf。TRAE会优先扫描该目录，避免路径配置错误。
在审查前手动注入参考资料
方法一：拖拽式注入（适合单次评审）
打开TRAE源代码管理界面 → 选中待审文件 → 点击右上角「添加参考」图标 → 将.ref/目录中的API文档、规范PDF、架构图等文件直接拖入弹窗 → 点击「确认绑定」。TRAE会在本次审查中将这些材料作为上下文输入模型，但不会缓存到下次评审。
方法二：配置全局参考源（适合团队长期使用）
进入设置 → 「代码审查」页 → 找到「默认参考源」字段 → 输入绝对路径，例如/home/user/myproject/.ref/ → 保存。此后每次触发审查，TRAE都会自动加载该路径下所有支持格式（.md、.yaml、.pdf、.json）的文件。注意：【PDF需含可复制文本层，扫描版PDF无法提取内容】。
用自然语言指令激活参考资料
第一步：在对话面板中输入明确指令，例如：“请结合.ref/api-spec.yaml中/v1/orders/{id}接口定义，检查当前修改是否违反响应字段命名规范。”
第二步：TRAE会立即定位spec中对应路径，比对代码返回结构，指出字段名大小写、嵌套层级、必选字段缺失等问题。
第三步：若发现规范冲突，它会直接引用PDF第12页“响应体字段命名”条款原文，并标注条款编号，而非笼统说“不符合规范”。
这一步不能省略——即使已配置全局参考源，TRAE也不会主动调用全部资料；必须用指令点名要参照哪份材料、用于哪类判断，否则它仍按通用规则运行。
验证参考资料是否生效
1、触发审查后，观察右侧diff视图顶部是否出现「参考源已加载：api-spec.yaml、team-rules.pdf」提示条。
2、点击任意Warning级问题 → 查看详情弹窗 → 若问题描述中包含类似“根据ARCHITECTURE.md第4.2节‘状态机流转必须经由EventBus’”的引用，则说明参考资料已成功介入分析链路。
3、若仅显示“建议使用枚举替代字符串”，未提具体文档条款，说明参考资料未被调用或格式不兼容。
