用 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 條評論

登入 後參與評論

還沒有評論,來搶沙發~