Trae 是 2025 年字节跳动发布的 AI 原生集成开发环境工具（AI IDE）；
使用Trae的Filesystem-MCP进行代码批量注释和逻辑分析的具体操作指南，帮助你高效完成相关任务：

操作

1. 在Trae的"AI侧栏"点击设置
   
2. 创建智能体

3. 填写提示词

为当前项目中所有.cpp和.h文件添加中文注释、逻辑分析，包括：
1. 为每个类添加类功能说明
2. 为函数添加参数、返回值和功能说明
3. 为关键成员变量添加注释
4. 保持原有代码格式不变
5. 遇到英文注释，请翻译成中文，并保留原英文注释
6.文件不需要审查，全部接受，你的修改我都需要
7. Qt版本升级至5.15.2
   - 全面检查项目中所有使用Qt框架的代码
   - 找出因Qt版本升级（从当前版本到5.15.2）需要修改的函数/方法
   - 在每个需要修改的函数/方法定义前，添加格式为"// TODO: Qt5.15.2升级 XXX(新)"的注释标记
   - 特别关注已废弃API的替代方案、新增功能的合理应用以及行为变更的适配
8. C++标准升级至C++17
   - 检查项目中所有C++代码对C++17特性的兼容性
   - 识别需要修改以支持C++17标准的代码部分
   - 优先考虑使用C++17新特性优化现有代码
   - 确保所有修改符合C++17标准规范
9. 生成升级说明文档
   - 在项目根目录的readme.md文件中添加"版本升级说明"章节
   - 记录Qt5.15.2升级的主要变更点、影响范围及解决措施
   - 记录C++17升级的主要调整点、采用的新特性及兼容性处理
   - 列出所有标记了"// TODO: Qt5.15.2升级 "的位置及说明
10.生成2个Mermaid思维导图
   - 在项目根目录的readme.md文件中添加"执行逻辑关系"章节
   - 类根节点1：包括类相互使用关系、执行逻辑
   - 函数根节点2：包括函数、类函数执行逻辑、相互使用关系
   - 生成后保存为readme.md在项目顶级目录(main.cpp目录)
11.最后在项目顶级目录(main.cpp目录)生成Readme.md,记录每个类功能、代码执行逻辑

5. 添加 MCP Servers
   • 配置安装 Filesyste
     

     ${workspaceFolder}
     

   注意左下角环境安装 按提示操作即可
   

6. 使用
   
   

通过以上方式，Filesystem-MCP能高效完成批量注释和逻辑分析，同时保持代码风格一致性，特别适合Qt+C++项目的升级前评估和重构准备。