Bug 反馈:Solo 模式"将 AGENTS.md 包含在上下文中"功能问题

反馈类型: Bug 报告 严重程度: 高(删除操作会删除本地文件) 影响模式: Solo 模式 报告时间: 2026-07-24 09:43:47 CST

一、环境信息

  • Trae IDE 版本:3.3.79
  • 操作系统:Ubuntu 24 LTS
  • 模式:Solo 模式
  • 功能入口:规则与记忆 → 导入设置 → 将 AGENTS.md 包含在上下文中

二、问题描述

启用"规则与记忆 → 导入设置 → 将 AGENTS.md 包含在上下文中"后,发现以下三个问题:

问题 1:扫描范围与说明不符

功能说明为"智能体将读取根目录中的 AGENTS.md 文件并将其添加到上下文中",但实际行为是递归扫描工作区下所有子目录中的 AGENTS.md,包括仅用于存档的文件。

问题 2:规则状态无法修改

被扫描到的子目录 AGENTS.md 全部被设置为"始终生效",且该状态在界面上无法修改。

问题 3:删除规则会物理删除本地文件

点击规则列表中的"删除"按钮时,操作的不是规则列表条目,而是直接删除本地磁盘上对应的 AGENTS.md 文件,且没有二次确认。

三、复现步骤

  1. 打开 Trae IDE Solo 模式(版本 3.3.79,Ubuntu 24 LTS)
  2. 准备一个工作区:
    • 根目录有一个 AGENTS.md (需要加载的规则文件)
    • 子目录中有若干 AGENTS.md (仅用于存档,不希望加载)
  3. 进入"规则与记忆"设置
  4. 开启"将 AGENTS.md 包含在上下文中"
  5. 查看"规则"列表:子目录中的 AGENTS.md 也被加载
  6. 尝试修改这些规则的"始终生效"状态:无法修改
  7. 点击某条规则的"删除":本地文件被删除

四、预期行为与实际行为

项目 预期 实际 扫描范围 仅工作区根目录的 AGENTS.md 递归扫描所有子目录的 AGENTS.md 生效状态 可修改每条规则的生效/禁用 子目录规则强制"始终生效"且不可改 删除操作 仅从规则列表中移除条目 直接删除本地文件

五、影响

  • 问题 3 会导致用户存档文件丢失,且无确认提示,误操作后难以恢复
  • 问题 1 + 2 会导致无关的归档规则被加载到上下文,增加 token 消耗,可能与根目录规则产生冲突

六、修复建议

  1. 删除功能 :将"删除"按钮的行为改为仅从规则列表中移除条目,不影响本地文件;如需提供删除文件功能,建议单独设计入口并增加确认提示
  2. 扫描范围 :按说明实现,仅加载根目录的 AGENTS.md;若需要支持子目录,建议让用户手动选择包含的目录,并默认关闭递归扫描
  3. 状态控制 :所有规则条目允许修改生效/禁用状态

七、临时规避方案

在修复前,可采取以下措施:

  1. 不要点击规则列表中的"删除"按钮
  2. 将存档用的 AGENTS.md 重命名为其他文件名(如 AGENTS.md.bak ),避免被扫描
  3. 如子目录文件较多导致上下文污染,可暂时关闭该功能,手动在对话中粘贴根目录 AGENTS.md 内容
  4. 使用该功能前,对 AGENTS.md 文件做好备份

你的运行环境(版本号「点击帮助-关于-复制」):

请替换此行填写

问题描述(你遇到了什么问题?):

请替换此行填写

复现步骤(如何才能重现这个 Bug/问题?):
1.
2.
3.

报错信息或截图(如有):

请在此处粘贴截图或日志代码

非常感谢你提供这么详细且专业的 Bug 反馈!:folded_hands:

你总结的这三个点非常清晰,特别是「点击删除会直接物理删除本地文件且无二次确认」确实是一个需要重点关注的高风险问题;同时,递归扫描子目录也与文档中「仅读取根目录」的设计预期不符。

因为你已经把问题发在了官方社区论坛的 Bug 反馈板块,这能让遇到类似情况的开发者第一时间看到并避坑。在官方修复上线之前,非常建议大家先采用你整理的这套临时规避方案(比如重命名归档文件、操作前做好备份、或暂时关闭该功能)来保护本地文件。

再次感谢你对 TRAE 的深度体验和严谨反馈!如果后续在使用中还遇到其他情况,随时来发帖交流~

1个多月了,问题还是没解决

当前帖子里的信息还不足以形成可靠结论。请在本帖补充当前的 TRAE IDE 版本、操作系统、复现步骤,以及可用的截图或日志。

建议备份的时候改个文件名


是这样设计的哈

亲,你好像没有理解问题在哪。根目录的AGENTS.md包含在上下文是正常的(如果是多个文件夹都是根目录,那么每个根目录文件夹的AGENTS.md都需要包含在上下文里),问题是现在会把不是根目录的AGENTS.md也包含进去,甚至很多层的子文件夹下面的AGENTS.md也会包含进去。

现在确实是这么做的,但是后时候忘记改名或者程序自动copy且没改名的时候,就会出现这种bug

版本管理建议用git,不要用文件备份的方式