trae可通过四种方法自动生成代码架构图:一、cli命令离线生成依赖/调用图;二、ide中用自然语言指令触发mtc智能分析;三、上传figma设计图实现设计-代码双向映射;四、通过trae rules配置ci/cd周期性快照。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望快速掌握一个代码库的模块组织与调用逻辑,但手动绘制架构图耗时且易出错,则Trae可通过自然语言指令自动解析项目结构并生成可视化图表。以下是实现该目标的多种方法:
一、使用Trae CLI执行一键依赖图生成
该方法基于Trae Agent内置的Code Knowledge Graph(CKG)引擎,直接读取本地代码库的AST结构,提取导入/引用关系,并调用Graphviz后端渲染为PNG或SVG格式图像。它不依赖外部服务,全程离线运行,适合对隐私敏感的私有项目。
1、在终端中进入您的项目根目录。
2、执行命令:trae graph --type=dependency --output=deps.png。
3、等待CLI输出“Graph generated: deps.png”,打开该文件即可查看模块级依赖关系图。
4、如需调用链路图(含函数级跨文件调用),改用参数:trae graph --type=callflow --depth=3。
二、在Trae IDE中通过MTC模式触发可视化任务
该方式利用Trae的SOLO Builder智能体理解高层意图,将模糊需求转化为结构化分析任务,并自动调度CKG与前端渲染组件完成端到端生成。适用于缺乏命令行经验的用户,且支持交互式调整节点布局与分组逻辑。
1、在Trae桌面端或网页端中,点击右上角「+ 新建任务」按钮。
2、输入自然语言指令:“请为当前项目生成模块依赖关系图和前后端调用链路图,按微服务边界分组”。
3、确认任务描述后,SOLO Builder将自动执行项目上下文分析、依赖扫描与图谱构建。
4、生成完成后,右侧面板将展示可缩放、可拖拽的交互式图表,支持点击节点查看对应文件路径与依赖明细。
三、上传Figma设计图联动生成双向映射架构图
该方法适用于已有UI/架构草图的场景,Trae通过TRAE Rules机制将设计图语义与代码实体对齐,反向推导出实际模块划分与接口契约,最终输出带标注的双向映射图。它能暴露设计与实现之间的偏差,辅助架构治理。
1、在Trae中打开MTC模式,选择「Design-to-Code Sync」模板。
2、上传Figma导出的JSON架构图文件或截图(支持PNG/JPEG)。
3、系统自动识别图中模块框、箭头连接与文字标签,并匹配当前代码库中的服务名、API路径及组件文件。
4、执行匹配后,生成包含两栏对比的HTML图表:左侧为原始设计图,右侧为代码实际调用链路,差异处以红色高亮标注。
四、通过TRAE Rules配置自动化周期性架构快照
该方法面向团队协作与持续治理,借助TRAE Rules定义的项目规则文件,使架构图生成成为CI/CD流水线一环。每次Git push后,自动触发CKG增量更新与图表重绘,并推送至Confluence或内部Wiki页面。
1、在项目根目录创建.trae/rules.yaml,写入以下内容:
on: push\n paths: ["**/*.py", "**/*.ts", "**/package.json"]\n actions:\n - graph: {type: "dependency", output: "docs/arch/deps.svg"}\n - graph: {type: "callflow", output: "docs/arch/callflow.png"}
2、提交该文件并推送到远程仓库。
3、Trae Agent监听到推送事件后,自动拉取变更文件列表,仅重新解析被修改的模块AST。
4、生成的新图表将覆盖docs/arch/目录下对应文件,并触发Webhook通知团队成员。











