在使用 Trae 编写 README 时，一个常见痛点在于：尽管上传了大量参考资料（如部署手册、接口文档、产品 PRD），AI 生成的输出却依旧是空泛的套话。本质上，AI 并不会自动理解这些资料，它缺乏主动读取能力。你需要明确“指令”它，它才会响应。

那么问题究竟出在哪里？解决方案隐藏在 Trae 的一个看似不起眼的设置中。接下来，我们将详细拆解关键步骤，助你彻底掌握。

确认参考资料已就绪

进入 Trae 界面，在左侧边栏找到【资料库】。定位你上传的 PDF、TXT 或网页快照，检查右侧是否显示绿色“已就绪”标签。该标签是资料能否被有效引用的关键标志，若缺失此标签，后续输入再多的提示词也毫无意义。

若显示“处理中”，请稍等约 30 秒后刷新页面。若显示“失败”，通常是因为文件格式不受支持——目前仅支持 PDF、TXT、MD、DOCX 以及合法 URL。非标准格式需重新上传。

在提示词开头强制绑定参考资料

这一方法最为直接，却常被忽略。在提示词的首行，独立写入以下指令：

“请严格依据以下参考资料回答问题，不要自行补充外部知识。”

请务必原封不动使用上述指令，词序和语气均不可更改。避免使用“请尝试参考”“可以结合这些内容”等模糊表述——这类限定词会被 AI 忽略，效果全无。

另一种更稳妥的方法是：设定角色锁定。适用于文档复杂、易偏离主题的场景。可参考如下写法：

“你现在是这份参考资料的专属解析助手，所有输出必须来源于该文档原文或其直接推论，禁止联想、禁止举例、禁止使用常识。”

注意一个硬性限制：此设定仅对当前对话窗口生效。若开启新对话，需重新输入。

在脚本中动态插入关键片段

该功能在需要精确引用资料时尤为实用，操作步骤简单，大致分为三步：

第一步：在 Trae 编辑器中，将光标定位到需要引用资料的位置；

第二步：返回左侧资料库，找到目标文档，用鼠标拖选一段你想引入的关键原文——例如“启动命令为 ./start.sh -p 8080”——然后点击“插入引用”按钮（图标为纸张加箭头）。该段文字将以灰色高亮块的形式嵌入提示词中；

第三步：在引用块的前后补充引导句子。例如：“根据以下用户提供的部署说明：[插入块] → 请生成对应的 Shell 启动脚本。”

注意一个陷阱：插入的引用块无法编辑。若原文含有错别字或过时命令，Trae 将直接基于错误内容生成脚本。因此，插入前务必确认资料的准确性。

验证参考资料是否真正生效

完成以上步骤后，建议先不要急于运行脚本，而是进行一次预验证。操作很简单：发送一条测试消息。

例如：“请逐条列出参考资料中提到的所有端口号。”

如果 AI 返回空结果，或回答“未提供端口信息”，甚至自行编造一个 8080，则表明前述步骤中某环节存在问题，需立即排查。

这四个步骤——从确认资料状态、强制绑定、动态引用到最终验证——缺一不可。Trae 并非一个“自动理解并处理”的工具，而是一台需要你亲手调教、亲自验证的生产力机器。