用途:把纯英文描述的网络或家庭实验室拓扑转成文本优先的架构图,先产出 Mermaid 源码,再考虑导入 Excalidraw 做美化。
主要能力:支持四种视图——context(用户、云、边缘、主机)、deployment(主机、容器/应用、数据存储)、flow(请求/数据/事件路径)、delta(变更前后对比)。节点归一为少量类别:用户、互联网/云、边缘/隧道/代理、主机、容器/应用、数据存储、外部系统。大需求拆成两张图,每张约不超过 15 个节点,按主机或信任区划分子图。
使用方式:从 AGENTS.md、compose 文件、仓库文档及 MCP/运行时清单收集拓扑事实;用自然语言给出范围、受众、粒度、是否区分公网与局域网边缘、是否需要前后对比。输出始终包含 Mermaid 代码块、推断项的简短假设/省略清单、可选建议文件名(如 docs/diagrams/docker-host-topology.mmd),并提示可导入 Excalidraw 清理。写文件时优先 docs/diagrams/<name>.mmd,必要时加 .md 图例。创建 Mermaid 文件后运行 python scripts/validate_mermaid_excalidraw.py <file.mmd> 校验;若报不支持语法,应简化图而非强行使用 Mermaid 特性。
限制:仅用 Mermaid flowchart/graph 语法,避免 sequenceDiagram、classDiagram、stateDiagram、erDiagram、journey、gantt、mindmap、timeline、pie、gitGraph、block-beta、packet-beta、sankey-beta、quadrantChart、zenuml,以及 @{...}、classDef、class、style、linkStyle、click 和 HTML 标签。优先稳定主机名而非局域网 IP,边标签保持简短。
适用场景:家庭实验室、容器主机、网络分段与变更评审的文档化。其他细节暂未提供。