可通过SOLO Coder全量感知、分层上下文注入、错误堆栈反向建模、文档驱动绘图及6A工作流五种方式,在Trae平台自动生成精准可维护的代码架构图。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望借助Trae平台为大型项目自动生成清晰、可维护的代码架构图,但面临模块繁多、依赖复杂、手动绘图耗时等挑战,则可通过多种上下文注入与智能体协同方式驱动AI完成结构化建模。以下是实现该目标的多种操作路径:
一、启用SOLO Coder智能体执行全量架构感知
SOLO Coder是Trae内置的专用架构理解智能体,专为大型项目设计,能主动扫描文件系统、解析AST、推导模块边界并生成带语义标签的架构图。它不依赖单个文件,而是构建跨包、跨语言的统一语义图谱。
1、在Trae IDE主界面右上角点击「SOLO」按钮,选择「Activate SOLO Coder」。
2、确认弹窗中显示“已加载全部源码目录(共XX个文件)”,并观察状态栏出现「Architecture Graph Ready」提示。
3、在对话框中输入指令:“基于当前项目生成完整代码架构图,标注核心模块、数据流向、服务调用链及第三方依赖入口”。
4、等待AI完成分析后,点击生成结果中的「Export as SVG」按钮下载矢量图,或直接嵌入项目README.md中。
二、分层注入上下文后触发结构化绘图
针对超大型项目(如含50+子包的monorepo),全量索引可能影响响应效率。此时可采用分层上下文策略,先聚焦关键层级再逐级展开,确保架构图逻辑严密、无信息过载。
1、在对话框中键入#Folder,选择根目录下的packages/与src/core/两个核心路径。
2、再次输入#Code,选中main.ts中bootstrapApp()函数签名,右键添加为锚点上下文。
3、发送指令:“以选定目录和入口函数为基准,绘制三层架构图:展示应用层、领域层、基础设施层,并用箭头标明各层间依赖方向”。
4、AI将输出包含颜色编码图例、模块分组边框及依赖权重线宽的SVG架构图。
三、绑定运行时错误堆栈反向生成故障路径图
当大型项目存在偶发性崩溃或集成异常时,错误堆栈本身即蕴含关键架构线索。Trae可将报错位置映射至源码,并自动补全调用链上下游模块,生成聚焦问题域的精简架构子图。
1、在终端面板中右键点击某次失败构建的Error行,选择“Send Stack Trace to AI”。
2、AI自动识别出触发文件为packages/payment-service/src/handlers/refund.ts,并加载其所有import路径。
3、输入指令:“根据该堆栈生成故障影响范围图,高亮标出直接受影响模块、间接依赖模块及共享基础库”。
4、AI输出带红黄蓝三色节点的子图:红色为崩溃点,黄色为同层协作者,蓝色为被复用的基础包(如@shared/utils)。
四、使用Builder模式上传架构描述文档驱动绘图
若项目已存在《系统设计文档.md》或《模块职责说明.txt》,可将其作为权威输入源,让AI严格依据文本语义生成架构图,避免模型幻觉导致的结构失真。
1、切换至Builder模式,在左侧资源面板点击「Upload Doc」,上传本地ARCHITECTURE_OVERVIEW.md。
2、在指令框中粘贴文档关键段落:“用户服务通过gRPC调用认证中心,订单服务依赖库存服务的REST API,所有服务共享shared-types包中的DTO定义”。
3、发送指令:“严格依据上述文档内容,生成微服务间通信架构图,使用UML组件图风格,标注协议类型(gRPC/REST)、数据格式(JSON/Protobuf)及版本号”。
4、AI生成符合UML规范的组件图,每个服务为独立矩形框,连接线旁明确标注gRPC v1.5或REST JSON v2.1。
五、调用TRAE Rules激活6A工作流生成可交付架构资产
为保障生成结果具备工程交付质量,可启用6A工作流强制AI按专业流程执行:先对齐需求、再设计架构、拆解模块、人工审批、自动执行、最终评估,全程留痕可追溯。
1、在对话框中输入6A Architect,触发工作流初始化。
2、AI自动创建ARCHITECTURE_PLAN.md草案,列出待确认项:模块划分依据、依赖方向判定规则、图例标准定义。
3、您在草案中补充确认:“按DDD限界上下文划分,依赖方向禁止逆向,图例采用ISO/IEC/IEEE 42010标准”。
4、AI据此生成带版本号(V1.2)、修订记录与责任人字段的正式架构图PDF及配套SVG源文件。


















