1. 引言:当 AI 开始接管"架构图"

写技术文档、做架构评审、出方案 PPT,几乎每个工程师每周都要跟架构图打交道。传统的两条路都不太好走:Visio、draw.io 这类拖拽工具上手快,但改一次图等于重画一遍,维护成本高;Mermaid、PlantUML 这类代码式 DSL 能嵌入 Markdown,默认渲染出来的样式又往往"丑到没法直接放进 PPT"。

问题也由此而来:当 Claude Code、Codex 这类 AI 编程助手成了日常搭档,能不能让 AI 把"画架构图"这件事也接管过去?

随着 AI Agent 进入日常研发流程,开源社区已经涌现出一批专门面向 AI Agent 的画图 Skill 和工具,把"画架构图"从手工活变成了可执行、可复用、可校验的工程化能力。我把 GitHub 上 9 款代表性工具(Stars 从 809 到 33.9k)装进 Claude Code 逐个实测了一遍,按 Skill 生图、AI 辅助应用、GPT-Image2 模型生图 三大类整理出这份选型指南。

一句话结论先放在这:

想要 Mermaid 美化选 beautiful-mermaid;想要全能型选 fireworks-tech-graph;想要交互演示选 archify;想要可长期维护选 drawio-skill 或 next-ai-draw-io;想要 GIF 动效选 fireworks-tech-graph 或岚叔手绘风;想要汇报级视觉大片上 GPT-Image2 系列。

2. 铺垫:两类画图路线,以及为什么 AI 偏爱后者

在挑工具之前,先用一张表把"画图"的两条技术路线分清楚。

路线 代表 工作方式 谁更适配
可视化拖拽绘图 Visio、draw.io 鼠标拖拽,所见即所得
代码式图表 DSL Mermaid、PlantUML 文本代码定义图形,可版本化管理 人 + 程序 + AI Agent

为什么 AI 时代更偏后者?因为 AI Agent 的本质是"读写文本"。给它一段 Mermaid 源码,它能改、能扩、能重新渲染;给它一张 PNG,它什么都做不了。DSL 让架构图从"图形资产"变成了"代码资产",这是后面所有 Skill 生图工具的共同基础。

几个贯穿全文的基础名词:

名词 一句话说明
UML 统一建模语言,软件工程标准建模规范,覆盖类图、时序图、组件图、部署图等
DSL 领域专用语言,Mermaid / PlantUML 都属于画图领域的 DSL
SVG 矢量图格式,缩放不失真,适合网页嵌入和高清输出
PNG 位图格式,通用性好,适合截图和日常分享
C4 Context / Container / Component / Code 四层架构建模方法,适合表达大型系统

3. 九款工具全景速览

工具 GitHub Stars 类别 一句话定位
next-ai-draw-io 33.9k AI 辅助应用 draw.io 桌面画板 + AI 对话生图
beautiful-mermaid 10.7k Skill 生图 把 Mermaid 渲染得更漂亮
fireworks-tech-graph 9.4k Skill 生图 14 类工程架构图 + GIF/HTML 多格式
awesome-gpt-image-2 8.4k GPT-Image2 生图 500+ 工业级 Prompt 模板库
archify 7.4k Skill 生图 可交互 HTML 技术地图
architecture-diagram-generator 6.7k Skill 生图 固定深色模板的快速出图
drawio-skill 6.6k Skill 生图 生成可编辑的 .drawio 源文件
GPT-Image2-Skill 4k GPT-Image2 生图 Prompt 模板 + CLI 执行层
lanshu-animated-architecture-diagram 809 Skill 生图 黑底手绘风 GIF 动态架构图

4. Skill 生图类:6 款工具实测

先解释一个贯穿本节的概念。Skill(技能包)可以理解为给 AI 编程助手预装的一套"可执行技能":它不只是提示词,而是打包了固定输入格式、图表模板、渲染规则和输出约束的一整套规则文件。装进 Claude Code / Codex 之后,你在对话里用自然语言描述想要什么图,Agent 就会按 Skill 内置的模板和风格直接产出 SVG / PNG / GIF / HTML 等成品。它比纯提示词稳定,比手工拖拽自动化,也比直接文生图更能保证结构关系。

4.1 beautiful-mermaid

关键词:Mermaid 美化、6 类图、13 种主题、SVG + ASCII 双输出

官方 Mermaid 的默认样式一直是个痛点——能用,但拿出来做汇报总觉得差点意思。beautiful-mermaid 重新实现了 Mermaid 常见图类型的解析、布局和渲染,同样一段 Mermaid 源码,渲染出来的 SVG 在配色、字体、留白上都更像"设计过的图"

它同时输出三种形态:

SVG:嵌入文档、PPT 用

ASCII / Unicode 字符图:直接放进终端、代码注释、纯文本环境

Mermaid 源码:方便版本化管理

图类型覆盖 Mermaid 主流六类(Flowchart 流程图、Sequence 时序图、State 状态图、Class 类图、ER 实体关系图、XY Chart 数值图表),主题 13 种,常用的有 tokyo-night(深色科技风)、dracula(编辑器经典配色)、default(浅底中性风)。

典型调用(在 Claude Code / Codex 里直接说):

用 beautiful-mermaid 渲染一张 Flowchart,先生成 Mermaid 代码,再渲染为 SVG 和 Unicode。
图中包含 User、Frontend、API Gateway、Auth Service、Order Service、Database,
重点展示用户下单请求链路。主题使用 tokyo-night,背景透明,字体使用 Inter。

适合谁:已经在用 Mermaid 但嫌弃默认样式的人;写技术文档 / Wiki / 博客需要内嵌图的人。局限:它解决不了"我想画 C4、云架构、Agent 拓扑"这类 Mermaid 不擅长的图——那是下一款工具的领域。

生成架构图效果

流程图-自上而下



流程图-自左向右



状态图



时序图



类图



ER 实体关系图



XY图表



XY图表



图中结构说明:左栏 = Mermaid 源码,中栏 = SVG 渲染图,右栏 = ASCII 字符图。

4.2 fireworks-tech-graph

关键词:14 类图、GIF 动效、5 种输出格式、14 种主题

如果说 beautiful-mermaid 是"把 Mermaid 做精",fireworks-tech-graph 就是"把工程图做全"。它在 6 类标准 Mermaid 图的基础上,扩展出 UML、C4、云架构、Agent 架构、网络拓扑、数据流等 14 类场景架构图,几乎覆盖日常技术写作和设计评审的所有图型。

更突出的是输出能力:

5 种格式:SVG、PNG、GIF、HTML、JSON,可自由组合

GIF 动效:让架构图里的数据流、调用链"动起来",是 9 款里唯二支持 GIF 的(另一款是岚叔手绘风)

HTML 交互:支持轻量交互,可以在浏览器里点选查看

主题库也很有看点,14 种风格几乎是为技术分享量身定制:Flat Icon 扁平图标(默认)、Dark Terminal 暗黑极客、Blueprint 工程蓝图、Notion 极简、Glassmorphism 玻璃态、Claude / OpenAI 官方风、Dark Luxury 暗黑奢华手绘、C4 Review Canvas 评审画布、Cloud Fabric 云织物、Event Transit 事件地铁、Ops Pulse 运维脉冲等。

典型调用

用 fireworks-tech-graph 画一张 Agentic RAG 架构图,
包含 Query、Planner、Search Tool、VectorDB、LLM、Response,
展示完整检索问答链路,使用 Dark Terminal 风格,输出 SVG、PNG。

两个快捷模板也很常用:

# 动态动效图
fireworks-tech-graph 绘制【内容】,生成 GIF 动态效果图

# 云架构专属
fireworks-tech-graph 绘制多云部署拓扑,Cloud Fabric 风格,输出 SVG、PNG、HTML

适合谁只想装一个 Skill、覆盖 80% 日常画图需求的人。综合型选手,也是我们实测下来团队内部装机率最高的一款。

生成架构图效果

Flat Icon 扁平图标风(默认)



Dark Terminal 暗黑极客风



Blueprint 工程蓝图风



Notion 极简风



Glassmorphism 玻璃态卡片风



Claude 官方风格



OpenAI 官方风格



Dark Luxury 暗黑奢华手绘风



C4 Review Canvas C4 评审画布



Cloud Fabric 云织物风



Event Transit 事件地铁传输风



Ops Pulse 运维脉冲风



4.3 archify

关键词:HTML 优先、强交互、支持代码库分析

archify 的定位和前两款都不一样——它是 "HTML 优先" 的。静态 SVG/PNG 只是附带产物,核心价值在于生成一个可交互、可钻取的 HTML 技术地图:你可以在浏览器里缩放、点击节点看详情、追踪调用链路。

它还有一个差异化能力:可以直接读当前代码库,自动分析模块结构后生成运行时架构图,而不是只依赖你用文字描述。这对"老系统补文档"场景尤其有用。

支持 5 类图(架构图、工作流图、时序图、数据流图、生命周期/状态机图),主题 4 种(Classic、Signal Flow、Blueprint、Editorial)+ 3 种色彩模式(Dark / Light / System Auto),输出格式含 HTML、PNG、SVG、WebM、Share Card PNG、JSON IR。

典型调用

用 archify 生成一张支付系统运行时架构图,基于当前代码库,
聚焦下单到支付完成链路,包含 Web、API Gateway、Order Service、
Payment Service、Redis、MySQL、第三方支付网关,
展示服务调用关系、缓存路径和外部依赖,使用 Blueprint 风格,输出 HTML、PNG、SVG。

适合谁:需要做架构评审、向他人演示系统结构、或想给老仓库快速补一份"活文档"的团队。和 fireworks-tech-graph 的取舍逻辑是:要图片优先选 fireworks,要交互演示优先选 archify

生成架构图效果

架构图

样式连接:Production Deployment Ownership Diagram

时序图

样式连接:Cache Miss Request Sequence Diagram

数据流图

样式连接:https://tt-a1i.github.io/archify/gallery/artifacts/event-stream.dataflow.html

工作流图

样式连接:Agent Tool Call Workflow Diagram

状态图

样式连接:Deployment Release Lifecycle Diagram



4.4 architecture-diagram-generator

关键词:5 类图、单一深色主题、单 HTML 交付

Cocoon-AI 出品的这款 Skill 走极简路线:内置一套固定的深色科技风 HTML/SVG 模板,把自然语言描述快速转成风格统一的架构草图。它不做深度定制,但胜在出图快、风格统一、单 HTML 文件就能分享

支持 5 类图(系统架构图、云架构图(含 Serverless)、基础设施架构图、安全架构图、网络拓扑图);主题只有 Dark 深色科技风一种;输出格式 HTML(默认),浏览器打开后可通过工具栏导出 PNG / PDF。

典型调用

用 architecture-diagram 生成一张支付系统架构图,基于当前代码库的模块结构,
聚焦下单到支付完成链路,包含 Web 前端、API Gateway、Order Service、
Payment Service、Redis、MySQL、第三方支付网关,展示服务调用关系、缓存路径和安全边界。

适合谁:临时需要一张能看的草图、不想折腾风格和主题的人。局限:不能深度定制主题,不适合正式对外发布。实测体验上 archify 在交互性和图类型上都比它强,两者只选一个的话更推荐 archify。

生成架构图效果

System 系统架构图



Cloud 云架构图



nfrastructure 基础设施架构图



4.5 drawio-skill

关键词:可编辑源文件、draw.io 生态、长期维护

前面几款 Skill 输出的大多是"成品图"(SVG/PNG/HTML),生成之后改起来不方便。drawio-skill 走了另一条路:直接生成 .drawio 结构化源文件,后续可以在 draw.io Desktop 或 diagrams.net 里继续编辑、维护、复用。这对需要长期演进的架构图非常关键——图不是画完就扔的,是要跟着系统一起迭代的。

它支持的输入来源也比其他 Skill 更广:

•自然语言描述

•当前代码库

SQL DDL(直接生成 ER 图)

Terraform / Kubernetes / docker-compose(直接生成部署架构图)

OpenAPI / Swagger(直接生成 API 架构图)

图类型覆盖系统架构、云资源、基础设施、代码结构、数据架构、流程、时序、业务流程、网络拓扑、AI/ML 架构共 10 类;主题含 defaultcorporatedarkhanddrawncolorblind-safe 及自定义主题;输出 .drawio.drawio.png.png.svg.pdf.jpg

推荐姿势:输出 .drawio + .drawio.png,前者用于维护,后者用于嵌入文档。

典型调用

用 drawio-skill 生成一张支付系统架构图,基于当前代码库,
聚焦下单到支付完成链路,包含 Web、API Gateway、Order Service、
Payment Service、Redis、MySQL、第三方支付网关,
展示服务调用关系、缓存路径和外部依赖,使用 corporate 主题,输出 .drawio 和 .drawio.png

适合谁:图需要长期演进、多人协作维护的场景,比如团队的核心系统架构图、部署拓扑图。

生成架构图效果

系统架构图



流程图



时序图



组件结构图



4.6 lanshu-animated-architecture-diagram

关键词:手绘风、GIF 动效、Excalidraw 源文件

岚叔(DailyDoseOfDS)风格的黑底手绘图,在技术圈里有极高的辨识度。这款 Skill 把这种风格做成了可批量生成的能力:输出动态 GIF + 静态 PNG + 可编辑 .excalidraw 源文件三件套。.excalidraw 源文件可以在 Excalidraw 里二次修改,GIF 特别适合放到技术文章开头、视频片头、对外分享 PPT 里抓眼球。

支持的图类型以架构图、流程图、原理图为主,风格固定为黑底手绘。

典型调用

使用 lanshu-animated-architecture-diagram,将以下内容整理成动态架构图。
主题:{图表主题}
目标:{希望图表表达的核心信息}
核心流程:{步骤1} → {步骤2} → {步骤3}
关键判断:{是否需要检查、分支或质量门禁}
要求:
- 输出动态 GIF、静态 PNG 和可编辑 Excalidraw 文件
- 使用中文标签
- 适合技术文章或方案说明使用

适合谁:写技术博客、做视频分享、需要在 3 秒内抓住读者注意力的内容创作者。它的 Stars 只有 809,远低于其他几款,但视觉差异化非常强——在"图都长得差不多"的今天,这反而是稀缺资源。

生成架构图效果

示例一:Memory Pack 架构图



示例二:Claude Loops 架构图





5. AI 辅助应用类:next-ai-draw-io

GitHub Stars:33.9k(9 款里最高)

如果说 Skill 类是"给 AI Agent 用的工具",next-ai-draw-io 就是"给人用的 AI 画板"。它是一个桌面应用(也有在线版),把 draw.io 的经典画布和 AI 对话能力拼在一起:你一边用自然语言让 AI 生成/修改图,一边可以手动拖拽微调,人机协同的体验拉得很满。

上手三步

1.安装桌面应用,或打开在线版(next-ai-drawio.jiang.jp

2.在设置里配置自己的模型(OpenAI / Claude / Gemini 等都支持)

3.在画布上选中元素或直接对话,让 AI 生成、扩展、重构图

适合谁:习惯 draw.io 工作流、又想让 AI 帮忙起草和修改的人。由于产出的是原生 draw.io 文件,后续长期维护成本几乎为零。它也是 9 款里唯一"既适合 AI 起草、又适合人手精修"的工具。

生成架构图效果





6. GPT-Image2 模型生图:从"结构图"到"视觉作品"

前面所有工具都有一个共同特点——生成的是"结构化的图"(节点、连线、标签)。而 GPT-Image2 这类文生图大模型走的是完全不同的路线:它生成的是像素级的视觉作品,更像海报、信息图、白皮书插画,适合做汇报封面、官网方案页、对外白皮书配图。

先要泼一盆冷水:GPT-Image2 直接画"结构准确的架构图"翻车率很高。它对系统关系、技术细节的语义理解远不如 DSL 类工具,画面很酷但模块关系可能是编的。正确姿势是先用 Mermaid / PlantUML 把结构写准,再让 GPT-Image2 做风格化渲染;或者输入已有的架构图作为参考图做图生图优化,出图稳定性远高于纯文本生图。

下面两款工具是互补关系,建议搭配使用。

6.1 awesome-gpt-image-2

关键词:Prompt as Code、500+ 案例、20+ 工业模板

传统的文生图写法是"凭经验、靠运气",每次出的图风格飘忽。awesome-gpt-image-2 把海量生图案例逆向拆解、标准化,沉淀成可复用、可组合的 Prompt 工程资产,让 AI 生图从"玄学"变成"工程"。项目已积累 500+ 逆向案例、20+ 工业级模板,覆盖 Infographic(信息图)、Poster(海报)、UI、Brand、Photo、Illustration 等十余个类别。

它提供一个 gpt-image-2-style-library 技能,会根据你的需求自动识别图型 → 匹配模板 → 匹配视觉风格 → 引用相似案例 → 输出可直接复用的完整 Prompt(含主体任务、构图版式、视觉风格、文字要求、比例格式、负面约束六段式结构)。

典型调用

使用 gpt-image-2-style-library 技能。请把下面的技术方案编译成一段
可直接用于 GPT-Image2 的生产级技术架构图提示词。
默认首选模板:Infographic Engine / 信息图引擎。
图主题:AI Agent Workflow
图用途:技术文章封面
图类型:分层架构图
核心模块:用户需求输入、上下文解析、任务规划、工具调用、代码执行、结果验证
关键关系:从左到右的工作流主线
必须出现的文字:主标题「AI Agent Workflow」和模块短标签

适合谁:想稳定复现高质量视觉风格、做正式对外输出(白皮书/官网/封面)的人。

生成架构图效果













6.2 GPT-Image2-Skill

关键词:Prompt 模板 + CLI 工具、执行层能力

GPT-Image2-Skill 和 awesome-gpt-image-2 是互补关系

•awesome-gpt-image-2 是 Prompt 资产库(知道"怎么写")

•GPT-Image2-Skill 是 Agent 执行工具层(能"按标准流程跑完")

它把提示词图库、图像生成案例、参考图编辑流程和命令行工具整合在一起,让 AI Agent 能直接调用 GPT Image 2 模型完成文生图、图生图、参考图编辑等任务。

典型调用

请使用 GPT-Image2-Skill 生成一张技术架构图。
图的类型:Agent 工作流图
图的主题:AI Agent 在研发流程中的自动化协作
读者对象:开发者、架构师
核心模块:需求解析、任务规划、工具调用、代码生成、结果验证
模块关系:从需求到交付的串行工作流
视觉风格:深色科技风
输出比例:16:9
文字语言:中文

适合谁:已经在本地跑 AI Agent、想让 Agent 直接出图而不是只给 Prompt 的人。如果不便本地跑 Agent,也可以用公司内部已接入 GPT-Image 类模型的平台替代,思路相同。

生成架构图效果







7. 综合对比与选型清单

7.1 九款工具核心能力矩阵

工具 核心定位 图类型覆盖 交互 HTML GIF 动效 可编辑源文件 视觉完成度
beautiful-mermaid Mermaid 渲染美化 6 类 Mermaid 图 ★★★★
fireworks-tech-graph 全能工程图 Skill 14 类工程图 ★★★★★
archify 交互式 HTML 技术地图 5 类系统图 ✓(强交互) ★★★★
architecture-diagram-generator 固定模板快速出图 5 类系统图 ★★★
drawio-skill 生成 .drawio 源文件 10 类专业图 ✓(draw.io) ★★★
next-ai-draw-io AI + draw.io 画板 覆盖 draw.io 全部图型 ★★★★
lanshu-animated-architecture 黑底手绘风 GIF 固定动效模板 ✓(excalidraw) ★★★★
awesome-gpt-image-2 Prompt 模板库 不限(图像) ★★★★★
GPT-Image2-Skill 模型调用执行层 不限(图像) ★★★★★

7.2 决策树:30 秒锁定你要的工具





图源:本文决策树用 beautiful-mermaid 渲染(default 主题),Mermaid 源码如下,修改后可重新渲染;同目录另有 SVG 矢量版。

7.3 场景速查清单

你的需求 直接选这个
把 Mermaid 图渲染得更美 beautiful-mermaid
综合能力最佳、一个 Skill 解决 80% 需求 fireworks-tech-graph
架构评审要交互演示、钻取细节 archify
临时出张深色科技风草图 architecture-diagram-generator
需要长期维护、可编辑的架构图 drawio-skill
习惯 draw.io 但要 AI 辅助 next-ai-draw-io
想要 GIF 动效图 fireworks-tech-graphlanshu-animated
想要黑底手绘讲故事 lanshu-animated-architecture
要做汇报级视觉大片(封面/白皮书) awesome-gpt-image-2 + GPT-Image2-Skill

8. 实测下来的几点真实体感

8.1 没有"银弹工具",只有"组合工具"

实测下来一个有意思的规律:几乎没有任何一个工具能独立打满所有场景。日常高频组合是:

技术文档写作:beautiful-mermaid(嵌文档图)+ fireworks-tech-graph(C4/云架构)

架构评审:archify(交互演示)+ drawio-skill(会后归档为可编辑源文件)

对外分享/汇报:fireworks-tech-graph GIF(开场抓眼球)+ GPT-Image2 系列(封面/尾页视觉大片)

8.2 踩过的几个坑

1.GPT-Image2 直接画"结构准确的架构图"翻车率高。它对系统关系、技术细节的语义理解远不如 DSL 类工具。正确姿势是先用 Mermaid/PlantUML 描述结构,再让 GPT-Image2 做风格化渲染。

2.Skill 生成的图别直接交付。无论哪款 Skill,生成后都要人工核对一遍——节点命名是否准确、连线方向是否正确、关键链路是否完整。AI 起草省的是"从 0 到 1"的时间,不能省掉"从 1 到交付"的评审。

3.GIF 别滥用。GIF 适合抓眼球,但放在正式评审文档里反而分散注意力。经验是:对外分享 GIF 优先,对内评审 SVG/PNG 优先。

8.3 值得关注的两个方向

"代码库 → 架构图"的自动化:archify 和 drawio-skill 都在做"读代码库生成架构图",这个方向再往前走一步就是"代码变了,架构图自动跟着变"——彻底解决"文档永远落后于代码"的老大难。

DSL 与文生图的融合:Mermaid/PlantUML 提供结构骨架,GPT-Image2 这类模型提供视觉表现力,两者拼接起来的体验会远超任何单一工具。awesome-gpt-image-2 的 Prompt 工程化已经开了个好头。

附:工具地址汇总

•beautiful-mermaid:GitHub - lukilabs/beautiful-mermaid · GitHub

•fireworks-tech-graph:GitHub - yizhiyanhua-ai/fireworks-tech-graph: Generate production-quality SVG+PNG technical diagrams from natural language. 7 styles, UML support, and AI/Agent workflow patterns. · GitHub

•archify:GitHub - tt-a1i/archify: Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export. · GitHub

•architecture-diagram-generator:GitHub - Cocoon-AI/architecture-diagram-generator: Generate beautiful dark-themed system architecture diagrams as standalone HTML/SVG files. Works as a Claude AI skill. · GitHub

•drawio-skill:GitHub - Agents365-ai/drawio-skill: Generate draw.io diagrams from natural language — 11 presets (UML, SysML/MBSE, BPMN, network, C4…), 36 tools: codebase/CI/infra-to-diagram, image→editable diagram, mind maps, build-up animation, exec-view compression, click-through runbooks, PR diff bot. Vision self-check, 10,000+ shapes. Exports PNG/SVG/PDF/JPG. · GitHub

•lanshu-animated-architecture-diagram:GitHub - cclank/lanshu-animated-architecture-diagram: Premium hand-drawn animated architecture diagram Codex skill · GitHub

•next-ai-draw-io:GitHub - DayuanJiang/next-ai-draw-io: A next.js web application that integrates AI capabilities with draw.io diagrams. This app allows you to create, modify, and enhance diagrams through natural language commands and AI-assisted visualization. · GitHub

•awesome-gpt-image-2:GitHub - freestylefly/awesome-gpt-image-2: Prompt as Code | GPT-Image2 工业级提示词引擎与模板库,470+ 个案例逆向工程,20+ 套工业级模板,并提炼出Skills,持续更新中 · GitHub

•GPT-Image2-Skill:GitHub - wuyoscar/GPT-Image2-Skill: GPT Image 2 prompt gallery, image prompt library, agentic skill, and CLI for OpenAI image generation/editing · GitHub

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐