[BUG] Trae Agent 启动后安装的工具不会自动更新 PATH 环境变量

Bug 描述

问题

Trae Agent 在启动时加载 PATH 环境变量，但之后在系统内安装的工具不会自动更新 PATH，导致自动化脚本无法找到新安装的命令。

环境信息

• 操作系统: Windows
• 安装的工具:
  • Git 2.54.0
  • GitHub CLI 2.92.0
  • Node.js 24.16.0
  • Python 3.12.10
  • .NET SDK 8.0.421
  • PowerShell 7.6.1
  • winget 1.28.240

复现步骤

1. 安装 Trae Agent IDE
2. 首次启动 Trae Agent（此时 PATH 条目数为 4 条）
3. 在系统中安装开发工具（如 Git、Node.js、Python 等）
4. 在 Trae Agent 中尝试执行这些工具的命令
5. 命令执行失败，提示"命令不存在"

预期行为

Trae Agent 应该能够检测到系统 PATH 的变化，或者提供一种机制让新安装的工具能够被识别。

实际行为

1. Trae Agent 启动时只加载了有限的 PATH 条目（4条）
2. 安装新工具后，PATH 环境变量在系统中已更新
3. 但 Trae Agent 的自动化环境仍然使用旧的 PATH
4. 必须重启 Trae Agent 才能加载新的 PATH

Trae Agent 启动时 PATH（仅4条）

1. c:\Users\Administrator\.trae-cn\tools\trae-gopls\current
2. c:\Users\Administrator\.trae-cn\sdks\workspaces\...\versions\node\current
3. c:\Users\Administrator\.trae-cn\sdks\versions\node\current
4. (空)

系统级 PATH 应包含的工具

• C:\Program Files\Git\cmd
• C:\Program Files\nodejs\
• C:\Program Files\GitHub CLI\
• C:\Program Files\dotnet\

用户级 PATH 应包含的工具

• C:\Users\Administrator\AppData\Local\Programs\Python\Python312\
• C:\Users\Administrator\AppData\Local\Microsoft\WindowsApps

临时解决方案

方案 1：重启 Trae Agent（有效）

完全关闭并重启 Trae Agent，重启后 PATH 会正常加载（29条）。

方案 2：手动刷新 PATH（在脚本中执行）

$env:PATH = "$([Environment]::GetEnvironmentVariable('PATH', 'Machine'));$([Environment]::GetEnvironmentVariable('PATH', 'User'))"

方案 3：使用完整路径调用命令

& "C:\Program Files\Git\cmd\git.exe" --version

影响范围

• 所有在 Trae Agent 启动后安装的开发工具
• 影响开发环境的正常使用
• 需要用户手动重启或使用 workaround

严重程度

中等 - 影响开发效率，但有临时解决方案

建议修复方案

1. 动态 PATH 监控: Trae Agent 定期检查系统 PATH 变化
2. 启动时完整加载: 启动时完整加载系统级和用户级 PATH
3. 提供刷新命令: 提供内置命令刷新 PATH
4. 文档说明: 在文档中说明此限制和临时解决方案

复现概率

100% - 每次在 Trae Agent 启动后安装工具都会出现此问题

报告日期: 2026-05-26 报告人: Goblin05