用 Claude + Mermaid 绘制系统架构图、时序图与数据库 ER 图(附 4 套可直接复制提示词)

写技术设计文档或汇报材料不想手拖拽连线框?本文按 Claude Artifacts 官方渲染机制详解一键生成零语法报错的 Mermaid 系统分层架构图、接口回调时序图、数据库 ER 图与订单状态机的 4 套提示词模板。

NNathaniel bigo··原创首发·AI 辅助撰写
8 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Pro 账号

结论先说

  1. 在 Claude 里画工程图不用跳去第三方网站预览,打开 Artifacts 面板当场直接成图:右侧画布即时渲染出矢量图,点顶部切换键既能下载图片,也能复制干净的源码贴进 GitHub、语雀、飞书文档或 Notion。
  2. 彻底消灭 Parse error 只需在提示词末尾焊死一句话:要求「所有包含圆括号、方括号、斜杠或冒号的中文节点说明文字,一律用英文双引号包裹(如 A["网关层 (Nginx)"])」。
  3. 严禁让 AI 凭空脑补架构:把你的真实路由代码、Docker Compose 或 SQL DDL 喂给它,画出来的图才经得起架构师推敲。
  4. 多轮微调大型图表排版较消耗对话额度:需要稳定使用最新模型与完整 Artifacts 体验时,可查看本站 Claude Pro 充值说明 或自动发卡的 Claude Pro iOS 自助充值商品页。

Claude Artifacts 四类常用工程图表

图:本站根据 Mermaid 官方文档 与 Claude Artifacts 支持范围整理的四类图表选型图

本文根据 Anthropic 官方 Artifacts 功能说明(support.claude.com)与 Mermaid 官方语法文档(mermaid.js.org)整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是网页截图。本站(bigolab.com)不是 Anthropic 官方网站。

适用于谁

  • 写技术评审方案(RFC / PRD)、毕业论文或系统交接手册,手拖绘图工具对齐箭头花掉一整晚的后端与全栈工程师;
  • 以前让大模型写 Mermaid 代码,结果贴出来满屏红字报 Parse error on line X(多半栽在中文括号没加引号上)的人;
  • 想把现有的 Prisma / SQL 建表语句直接扔给 Claude,十秒钟自动画出整套数据库主外键 ER 实体关系图 的开发者。

一、四步零报错出图与导出工作流

零报错生成并导出高清架构图四步

图:本站结合 Claude Artifacts 使用说明 整理的四步绘图流程示意图

如果你还没打开过右侧工件开关,先去左下角设置确认 Artifacts 处于开启状态(功能基础见 Claude Artifacts 入门指南;如果你习惯直接在本地代码仓库终端里扫源码生图,也可配合 用 Claude Code 画流程图与架构图 或对比 用 ChatGPT 画 Mermaid 思维导图):

  1. 选准图类型关键字:讲模块分层用 flowchart TD(从上往下)或 LR(从左往右),讲接口先后交互用 sequenceDiagram,讲表结构用 erDiagram,讲单据流转用 stateDiagram-v2——别所有图都拿普通流程图硬凑。
  2. 喂入真实技术底座素材:把 docker-compose.yml、支付回调 Controller 代码或 .sql 文件直接粘进对话框当原料。
  3. 控制单张图的节点密度:一张图塞进四十个方框放在 PPT 或文档里根本看不清字。超过十五个核心节点时,让它用 subgraph 分组框归类,或拆成「全局鸟瞰图 + 核心链路放大图」两张。
  4. 验收箭头方向与落盘版本管理:在右侧画布确认没有线条打结后,把源码保存进仓库 docs/architecture.md,以后改架构只改两行文本就能由 Git 追踪 Diff(技术方案全文撰写另见 用 Claude 写 PRD 与技术设计文档)。
长文档精读与高频生产力订阅入口:无论是往 Projects 挂载几十份背景资料、审阅几十页英文商业合同,还是连续绘制复杂架构图,免费版短窗口配额极易受限。国内用户可通过本站支付宝、微信支付或 AlipayHK 免上号自助开通 Claude Pro 会员(直达单品 Pro iOS 自助充值)或大额度 Claude Max 充值。

二、4 套可直接复制的零报错 Mermaid 提示词模板

1. 微服务分层系统架构图(flowchart TD + subgraph 分组)

text
请根据我下面提供的服务列表(或 docker-compose 配置),在 Artifacts 中使用 Mermaid flowchart TD 绘制一张清晰的系统分层架构图:
1. 使用 subgraph 依次划分为「客户端接入层」「API 网关与鉴权层」「核心业务服务层」「存储与消息队列层」四个分组框;
2. 实线箭头标注同步 RPC/HTTP 调用,虚线箭头(-.->)标注异步消息投递与缓存读写;
3. 语法防错硬规则:所有节点标签凡包含括号、斜杠或空格的,必须使用英文双引号包裹(例如 gw["API 网关 (Kong)"]),禁止在标签内嵌套 HTML 标签。

2. 第三方支付与异步回调幂等时序图(sequenceDiagram)

text
请针对「用户发起下单 → 创建预支付单 → 收银台扣款 → 异步 Webhook 回调验签与幂等入账 → 定时轮询兜底」流程,使用 Mermaid sequenceDiagram 绘制完整时序图:
1. 顶部开启 autonumber 自动为每步交互标序号;
2. 使用 alt / else 分支块清晰画出「验签失败直接丢弃」「订单已支付幂等返回成功」「首次回调事务更新库存与状态」三条分支路径;
3. 严格依据我粘贴的接口字段命名,不要编造未提及的外部系统。

3. 从 SQL / Prisma Schema 一键反推数据库 ER 图(erDiagram)

text
请读取我粘贴在下方的数据库建表 SQL(或 schema.prisma),使用 Mermaid erDiagram 绘制实体关系图:
1. 准确标出各表之间的一对一(||--||)、一对多(||--o{)及多对多关联基数与外键动词标签;
2. 每张实体表内仅保留主键(PK)、外键(FK)及不超过 6 个核心业务字段(字段类型统一用单个英文词如 bigint、varchar、timestamptz,不含空格与括号以防语法报错)。

4. 复杂订单全生命周期状态机图(stateDiagram-v2)

text
请使用 Mermaid stateDiagram-v2 绘制电商售后订单状态流转图:
从起始态 [*] 出发,覆盖待付款、待发货、运输中、已签收、部分退款审批中、已全额退款、已超时关闭等状态,在每条跃迁箭线上标明触发动作与前置守卫条件(如「买家超时 30 分钟未支付」),并明确标出不可逆的终态节点。

人工定稿前必查三点:第一,逐条顺着时序图箭头核对异常失败分支有没有画成死胡同漏掉解锁库存;第二,核对 ER 图里一对多鸦爪符号(o{)有没有画反方向;第三,将源码贴进你们团队实际使用的 Markdown 文档平台看一眼其内置 Mermaid 版本是否兼容。

常见问题

问:右侧 Artifacts 突然红字提示语法渲染失败怎么最快修好?

答:不用自己去数哪一行少了引号。直接把右侧面板报出的那行英文 Error 原文复制粘贴回左下输入框说「请修复这段 Mermaid 语法报错并保持原图逻辑不变」,Claude 一轮就能把非法字符改干净。

问:图太宽在竖版 Word 或 PDF 里缩得像蚂蚁一样小怎么办?

答:只需发一句「把这张图的布局方向从横向 flowchart LR 改为纵向 flowchart TD,并将过长的横排并列节点折成上下两层子图」,版面比例立刻适配竖屏纸张。

问:能不能让它给不同模块框涂上浅蓝、浅绿区分底色?

答:可以。在提示词里补一句「使用 Mermaid classDef 定义柔和浅色系填充配深色描边文字,分别区分在线读写链路与离线异步链路」,注意提醒它深色模式下文字颜色对比度要清晰。

问:新注册 Claude 收不到手机验证码,或者没有外币卡怎么开通 Pro / Max 会员?

答:注册受阻可先看本站 Claude 注册与普号说明页;已有账号升级会员可直接前往 Claude Pro 充值页 或 Claude Max 充值页 获取自助卡密兑换,支持开具增值税发票,实时价格与售后边界(封号不在质保范围)见各商品页。

相关教程

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同模型

  1. 01

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  2. 02

    写代码兼顾办公,同时订「ChatGPT Plus + Claude Pro 双会员」还是单上「Max / Pro 高阶档」怎么算账

    每月花 $40 同时订 ChatGPT Plus + Claude Pro 双会员,还是花 $100 单上 Claude Max 或 ChatGPT Pro 100?本文按两家官方定价页拆解编程智能体、多模态办公、限额容灾与独占功能账本,给出清晰选型公式。

    ChatGPTClaude0
  3. 03

    Notion AI 怎么收费、包含在套餐里还是单独买:工作区知识问答、数据库自动填表与对比 Claude / ChatGPT 选型

    Notion AI 现在还能单独加购吗?按 Notion 官方现行定价页,完整 Notion AI 已直接打包进 Business(年付 $20/成员/月,月付 $24)与 Enterprise 套餐,Free 和 Plus 仅含少量试用。本文讲清计费变化、三大核心功能及与独立会员的取舍。

    其他 AI 工具0
  4. 04

    Raycast AI(Pro / Pro+ / Max)是什么、怎么配 BYOK 自带密钥:快捷呼出 Claude 与 GPT 桌面工作流

    Raycast AI 支持在桌面端全局快捷键呼出 Claude、GPT 与 Gemini。本文按官方手册说明 Raycast Pro、Pro+、Max 积分档位差别,以及配置 BYOK(自带 API 密钥)的前置条件、设置步骤与快捷指令工作流。

    其他 AI 工具0
  5. 05

    Perplexity Pro 值得买吗:每月 $20 比免费版多什么、可选哪些 Claude / GPT 模型与深度检索用法

    Perplexity Pro 月付 $20(年付约 $17/月),比免费版多出高配额 Pro 搜索、切换 Claude 与 GPT 模型及更高频的 Deep Research 深度检索。本文对比各档权益,帮你判断订它还是独立对话会员。

    其他 AI 工具0
  6. 06

    Claude API Citations 原文引用结合 Files API 搭建可溯源企业制度问答指南

    搭公司内部报销、法务或操作规程问答机器人,不想折腾复杂的切片向量数据库又怕大模型胡编页码?本文按 Anthropic 官方文档详解用 Files API 传一次 PDF 拿 file_id,结合 Citations 原生返回精确页码与原文摘录的完整架构。

    Claude0

同产品的其他教程

  1. 01

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0
  2. 02

    Langfuse 开源本地部署(Docker Compose)与提示词版本管理(Prompt Management)从零上手教程

    企业内网严禁业务日志出境,又想免费拥有大模型调用链追踪与不发版热更新提示词的能力?本文按 Langfuse 官方文档整理 Docker Compose 本地一键启动(含 ClickHouse 架构注意事项)、密钥配置与 Prompt Management 标签化版本管理全流程。

    Claude其他 AI 工具0
  3. 03

    LangSmith 入门教程:给 LangGraph 与原生 OpenAI / Claude 接口加调用链追踪、Token 成本统计与免费层限额

    智能体多步调用总是找不到哪一轮提示词跑偏、单次请求到底烧了多少 Token?本文按 LangSmith 官方文档讲清环境变量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 与 @traceable 追踪原生接口,以及 Developer 免费层额度与留存规则。

    Claude其他 AI 工具0
  4. 04

    Zotero 搭配 Claude / ChatGPT 高效读英文文献:PDF 翻译插件、批注导出精读与防捏造参考文献流程

    在 Zotero 里读英文顶会论文怎么无缝联动 Claude 与 ChatGPT?本文整理 Translate for Zotero 划词翻译配置、高亮批注导出精读提示词,以及杜绝 AI 捏造假 DOI 参考文献的核验闭环。

    Claude其他 AI 工具0
  5. 05

    Obsidian 接入 Claude、ChatGPT 与本地 Ollama 做个人双链笔记问答:主流插件配置与隐私脱敏边界

    想在 Obsidian 里基于自己的双链笔记库做 AI 问答又担心隐私外泄?本文对比 Copilot 与 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 与本地 Ollama 的步骤及敏感目录隔离规则。

    Claude其他 AI 工具0
  6. 06

    Excalidraw 结合 AI 怎么画架构图:Mermaid 代码一键转手绘风图表与 Excalidraw MCP 自动生图做法

    想用 AI 快速画出可自由拖拽修改的手绘风系统架构图?本文整理 Excalidraw 内置 Mermaid 转图表、Text to Diagram 与挂载 Excalidraw MCP 自动读取代码生成架构图的三套完整流程。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~