Trae自动生成代码库模块依赖关系图和调用链路图

代码库的架构可视化，听起来像是那种“很重要但总被拖到明天”的事情。模块依赖哪里是瓶颈？调用链路到底乱不乱？手动画图不仅累，还容易跟不上代码迭代。Trae 在这方面提供了一套挺完整的自动化方案，下面这四种方法基本覆盖了从个人到团队、从一次生成到持续治理的场景。

如果你只想快速摸清一个项目的模块组织与调用逻辑，又不想折腾工具链，Trae 可以通过自然语言指令直接解析项目结构并生成图表。具体路径有四条，咱们一条条来看。

一、使用 Trae CLI 执行一键依赖图生成

这是最直接、最干净的方法，尤其适合对隐私敏感的私有项目。Trae CLI 内置了 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 配置自动化周期性架构快照

最后一种方法面向团队协作和持续治理。你可以写一个规则文件，把架构图生成嵌入到 CI/CD 流水线里——每次 Git push 之后，Trae 自动触发增量更新并重新渲染图表，然后推送到 Confluence 或内部 Wiki。这样一来，架构图永远跟代码保持同步，不用任何人手动维护。

操作步骤：

1. 在项目根目录创建 .trae/rules.yaml，写入下面的内容：

on: push
paths: ["**/*.py", "**/*.ts", "**/package.json"]
actions:
- graph: {type: "dependency", output: "docs/arch/deps.svg"}
- graph: {type: "callflow", output: "docs/arch/callflow.png"}

2. 提交该文件并推送到远程仓库。
3. Trae Agent 监听到推送事件后，自动拉取变更文件列表，只重新解析被修改的模块 AST，避免全量扫描。
4. 新生成的图表会覆盖 docs/arch/ 目录下的对应文件，同时触发 Webhook 通知团队成员。

这四种方法各有所长，可以根据实际场景灵活选用。说到底，架构可视化不是一次性的交付，而是应该成为代码管理的一部分——Trae 的这些能力，算是把这个事情真正落地了。