用途:该技能面向研究团队与架构文档场景,帮助用 Mermaid 高级功能绘制多视图架构与基础设施图,包括多层系统、数据管线、部署拓扑、实验工作流等,效果可接近 Structurizr 或 Draw.io 等专用工具。
主要能力:一是手绘渲染模式(Mermaid v11+ 的 handDrawn look),通过 config 中 look: handDrawn 与 theme: neutral 开启,产生类 Excalidraw 的草图风格,适合早期架构讨论和研究提案。二是 C4 架构图,支持 C4Context(第 1 层系统上下文,含 Person、System、System_Ext、Rel)与 C4Container(第 2 层容器视图,含 Container_Boundary、Container、ContainerDb),可在版本控制的 Markdown 中分层记录系统与数据源、模型、可视化层的交互。三是高级子图模式,支持 subgraph 嵌套与 direction 控制数据摄取层、处理管线、服务层等分层结构。四是主题定制,通过 %%{init: {...}}%% 设置 theme 与 themeVariables(如 primaryColor、lineColor、fontFamily)。此外还给出带决策门(如 IRB 审批、Pilot 成功判定、显著性判定)的流程图,以及用 stateDiagram-v2 描述研究流程(立项、提案、评审、资助、执行、结题)的状态图示例。
使用方式:图形以 Markdown 代码块形式嵌入文档。GitHub Markdown、GitLab、Obsidian 原生渲染;Notion 需通过 mermaid.ink URL 编码嵌入;LaTeX 建议用 mmdc CLI 预渲染为 SVG/PDF;Jupyter 可通过 mermaid-py 或 iframe 渲染。CLI 用法:npm install -g @mermaid-js/mermaid-cli,然后 mmdc -i architecture.mmd -o architecture.svg -t neutral,手绘外观可加 --configFile mermaid-config.json。参考链接包括 https://mermaid.js.org、https://c4model.com、https://github.com/mermaid-js/mermaid-cli 与 https://mermaid.live。
适用场景与限制:适用于研究提案、非正式文档、系统分层说明与实验流程建模。限制方面,资料未提供该技能的收费、价格、安装包体积或具体效果量化信息;Notion 需转为嵌入方式,LaTeX 需预渲染,均非原生支持。