描述系统里有哪些组件、彼此怎么连,拿一张分层的架构图。
画一个部署在 AWS 上的 Web 应用架构图:CloudFront CDN 在最前面,转发到 Application Load Balancer,再路由到跑在 ECS Fargate 上的 API 服务,API 读写 RDS Postgres 数据库,热点数据缓存在 ElastiCache Redis。静态资源从 S3 提供。
Try it →微服务架构图:API 网关前置,后面是订单服务、支付服务、库存服务。订单服务把事件发布到 Kafka,由库存服务和通知服务消费。每个服务各自拥有独立的 Postgres 数据库。
Try it →无服务器数据管道架构:上传到 S3 触发一个 Lambda 校验文件并把原始数据写入 S3 数据湖,同时向 EventBridge 发一个事件。第二个 Lambda 消费该事件、转换数据、加载进 Redshift 数据仓库供分析使用。
Try it →移动应用后端架构:iOS 和 Android 客户端都调用 API 网关,网关转发到基于 Cognito 的鉴权服务,以及基于 DynamoDB 的核心 API 服务。推送通知走 SNS。静态内容通过 CloudFront 和 S3 提供。
Try it →先给评审的人一张全貌,再展开细节。方案开头放一张架构图,能省掉十条「这个到底怎么调那个」的追问。
真正开始建资源之前,先把打算怎么搭画出来。评审的人在图上比在 terraform plan 里更容易发现少了一层缓存,或者多了一跳。
新人第一天就会问请求在这个系统里怎么流转。README 里挂一张架构图,不用打开代码就能回答。
审计和安全评审要看的是信任边界 —— 哪些对外暴露、哪些只在内网、数据在哪里跨过边界。想说清楚攻击面,一张标注清楚的架构图最快。
从单体拆成微服务,或者从自建换成托管服务?迁移前后各一张图,方案就变得具体、能评审了。
架构图最要紧的两件事 —— 哪个框直接连哪个框、托管边界画在哪儿 —— 恰恰是一句话 prompt 里最容易漏掉的部分,漏了模型就只能替你猜。对话模式只问边界这一件,因为它决定整张图长什么样;剩下的直接画,画完再告诉你哪些是它假设的。下面这张短链服务的图,起点只有三个组件名。


四句话画出了一张带托管边界、缓存与数据库并排、还有一个外部回调入口的架构图 —— 开头那句话里一样都没有。也注意它一直没长大:四个框、平铺、没有分层,这正是 architecture-beta 画得清楚的形状;等系统前面再压一个网关、后面挂三个服务,对话模式会自动改用带 subgraph 的流程图来画。
架构图回答一个问题:这个系统由哪些部分组成,它们之间怎么连。写设计文档要先给个全貌、新人想在十秒内搞清楚一个请求从哪走到哪、给不看长文档的领导讲一套方案,都用它。
跟流程图的区别在于:流程图画的是一件事随时间怎么走完,架构图画的是系统静止时的样子 —— 这个服务调那个服务,这个队列夹在两个服务中间。你把组件说出来 —— 网关、服务、数据库、队列、缓存、CDN —— 它按边缘层、计算层、数据层分组排布,用不同形状区分类型,跟在白板上手画的架构草图一个路子。
一个要说明白的局限:图上用的是带文字标注的通用形状,不是 AWS、GCP、Azure 的官方图标 —— Mermaid 本身不带云厂商图标库,所以 RDS 或者 S3 会画成标注清楚的圆柱和方框,不是品牌 logo。内部设计文档和技术方案够用了;要给客户做正式的云架构 PPT,可以拿这张图当布局初稿,再到 Lucidchart 之类的工具里换成官方图标。
对话模式里 AI 会先问你两三个问题 —— 谁参与、发生什么、异常分支怎么走 —— 弄清楚了再动笔。
教程里讲了常用符号、几种基本结构、九条画法规范,还有可以直接拿去用的 prompt 模板和真实业务例子。