如何配置在Trae中使用Harness

Harness（在 Trae IDE 里），通俗说就是：给 AI 配的 “项目管家 + 规则手册 + 记忆大脑”。

AI 是野马：能力强，但容易跑偏、忘事、乱输出。Harness 就是 “缰绳 + 马鞍 + 马厩 + 赛道”：

• 不让它乱跑（遵守你的规则）

• 记住项目所有事（长期记忆）

• 按你的规范干活（代码风格、接口格式、命名统一）

• 踩过的坑不再踩（避坑指南）

• 进度、决策、变更全记下来（项目档案）

但是我们如果只是把 .harness 创建在项目目录下，Trae 默认情况下是不能识别的，或者配置后仍然没有效果，请按下面的步骤检查一遍。

一、先检查：为什么 Harness 没生效？

Trae AI 默认只索引代码、不自动读 .md 文档，也不知道 .harness/ 是你的记忆库。

常见问题：

• ❌ 没加「文档集」→ AI 看不到 .harness/*.md

• ❌ 没建「索引」→ 内容没被解析、无法召回

• ❌ 没写「规则」→ AI 不知道要优先参考这些记忆

二、Step 1：把 .harness/ 设为 Trae 文档集（核心）

让 Trae 把你的记忆文件当作项目知识库，自动读取。

操作路径：

1. 打开 Trae → 右上角 设置（⚙️） → 上下文（Context）

2. 找到 文档集（Document Sets） → 添加文档集

配置：

• 名称：Harness-Memory（项目记忆）

• 路径：选择项目下的 .harness/ 目录

• 包含：**/*.md（只读 Markdown 记忆文件）

• 自动更新：✅ 开启

• 构建索引：点击 立即构建（必须做）

验证：

• 状态显示：已索引（N 个文件）

• 以后修改 .harness/ 下的 .md 文件，Trae 会自动更新索引

三、Step 2：开启「自动上下文」（AI 自动加载记忆）

让 AI 每次对话、每次生成代码时，自动带上 Harness 记忆，不用手动 # 引用。

1. 开启 CUE 上下文引擎（必须）

设置 → 通用设置 → CUE 面板

• ✅ 启用 CUE 上下文理解引擎

• ✅ 智能导入、智能推荐 全开

2. 配置 AI 自动参考文档集

设置 → AI 设置 → 上下文

• 默认上下文范围：选 工作区 + 文档集

• 文档集优先级：把 Harness-Memory 拖到 最顶部

• 自动召回条数：设为 5–10（确保关键记忆都被读到）

四、Step 3：把 Harness 写入「项目规则」（强制生效）

最关键一步：让 AI 必须遵守你记录的项目规范、决策、坑点。

1. 生成项目规则文件

在 Trae AI 对话里输入：

请在 .trae/rules/ 生成 project_rules.md，内容从 .harness/AGENTS.md、decisions.md、pitfalls.md 提取项目规范、禁止行为、关键决策、技术选型，作为强制规则。

AI 会自动生成 .trae/rules/project_rules.md

2. 开启规则自动加载

设置 → 规则和技能 → 项目规则

• ✅ 自动加载项目规则

• ✅ 规则优先级：最高

3. 效果（立刻生效）

• AI 生成代码时自动遵守你记录的规范

• 自动避开 pitfalls.md 里的坑

• 自动按 decisions.md 的决策做技术选型

五、Step 4：日常开发流（Harness 自动生效）

配置完成后，完全不用手动操作，Harness 自动工作：

1. 打开项目

• Trae 自动加载：文档集（.harness）+ 项目规则

• 打开 AGENTS.md，10 秒恢复上下文

2. 写代码 / 问 AI

AI 自动读取：AGENTS.md、progress.md、decisions.md、pitfalls.md

例如你问：“帮我写登录接口”，AI 会自动知道当前进度、JWT 规则、禁止事项、项目架构和命名规范等。

3. 记录记忆（边写边记）

• 做决策 → 修改 decisions.md

• 踩坑 → 修改 pitfalls.md

• 改进度 → 修改 progress.md

• 保存即生效：Trae 自动重建索引，AI 立刻使用新记忆

4. 关闭 / 重启 / 换设备

• Git pull 拉最新 .harness/

• Trae 自动重新索引

• 10 秒完全续上，不会断片

六、验证 Harness 是否真的生效（测试一下）

在 Trae AI 里问：

“我们项目当前在做什么？技术规范是什么？有哪些禁止的坑？”

✅ 生效表现：

• AI 直接回答当前任务、规范、坑点（内容来自你的 .harness/）

• 生成代码完全符合你记录的规则

• 无需手动引用 #Harness-Memory

❌ 没生效表现：

• AI 说 “我不知道项目信息”

• 生成代码乱选技术或踩已记录的坑

七、常见问题

1. 文档集没构建解决：上下文 → 文档集 → 重新构建索引

2. 规则没自动加载解决：检查 .trae/rules/project_rules.md 内容是否正确 → 重启 Trae

3. AI 还是不读记忆解决：临时用 #Harness-Memory 帮我写XX 强制引用；长期优化文档集优先级和 CUE 设置

八、你现在立刻做（3 步见效）

1. 上下文 → 添加文档集 → 选 .harness/ → 构建索引

2. AI 设置 → 上下文 → 把 Harness-Memory 优先级调至最高

3. 生成 .trae/rules/project_rules.md → 开启自动加载

做完后：

• Harness 完全自动生效

• Trae AI 永远记得你的项目上下文

• 再也不会 “断片、忘记、重复踩坑”

手机扫描二维码访问