用途:根据自然语言提示生成网络图、架构草图、拓扑图或服务关系视图,尤其适合家庭实验室场景,产出可评审、可纳入 git 或文档的文本化图表。
主要能力:以 Mermaid 流程图为主产物,保持可导入 Excalidraw;可从 AGENTS.md、compose 文件、仓库文档及 MCP/运行时清单收集拓扑信息;支持 context、deployment、flow、delta 四种视图;将节点归一为用户、互联网/云、边缘/隧道/代理、主机、容器/应用、数据存储、外部系统等小集合;大型需求拆成两张图而非一张密集画布。
使用方式:用自然语言描述范围、受众、粒度、是否区分公网与局域网边缘、是否需要前后对比。每个主机或信任区用一个 subgraph,标签简短稳定。若需文件,优先写 docs/diagrams/<name>.mmd,必要时附简短 .md 图例或假设说明。创建 Mermaid 文件后运行 python scripts/validate_mermaid_excalidraw.py <file.mmd> 校验。
限制:仅用 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 标签。每图约不超过 15 个节点,优先稳定主机名而非局域网 IP。校验器报出不支持语法时应简化图表,而非强行使用 Mermaid 专有特性。
输出契约:始终给出 Mermaid 代码块、推断内容的简短假设或省略清单、可选推荐文件名,以及可导入 Excalidraw 做后续美化的提示。