用途：在编写或编辑 Markdown 中的 fenced mermaid 代码块时使用，确保图表源码可读，并在交付前完成语法校验。
主要能力与语法规则：含标点、括号、尖括号、逗号、emoji 或 HTML 的节点标签需加引号，如 A["Config (optional)"]；含标点或特殊词周围有空格的边标签需加引号，如 A -->|"uses (runtime)"| B；标签换行用 <br/> 而非 \n；避免用小写 end 作节点标签，改用 End 或加引号；优先使用内置主题而非硬编码填充色，硬编码颜色常会破坏深色模式；若节点 id 在边之后以 o 或 x 开头，需加空格，避免被解析为圆形或交叉边，如 A--- oNode。
验证方式：用随附脚本校验改动过的 Markdown 或 .mmd 文件：uv run scripts/check_mermaid.py path/to/file.md。若无 uv 但有 Python，可运行 python3 scripts/check_mermaid.py path/to/file.md。若只有 Node/npm，可将 Mermaid 块提取为临时 .mmd 文件并用 npx 直接校验：npx --yes @mermaid-js/mermaid-cli -q -i diagram.mmd -o diagram.svg。独立 .mmd 文件或复制的代码块可直接用 npx；Markdown 文件仍推荐 Python 助手，因为它能提取 fenced mermaid 块并报告源码行号。
限制与说明：该助手使用 Mermaid CLI 并返回真实的通过/失败退出码。若没有 Node.js/npm，它会打印首次运行提示并在用户缓存目录下安装私有 Node 运行时，优先用 uv 为 nodeenv 创建 venv，回退到 python -m venv 加 pip，不会修改仓库或系统 Node 安装；设置 MERMAID_VALIDATOR_NO_BOOTSTRAP=1 可禁用自动安装。若机器没有可用的 Python、uv、mise 或 Node/npm，不要静默自行安装，应告知用户校验需要其中一种工具并询问是否安装；环境中有 uv 或 mise 时优先使用，否则可用 Python 或 Node 的官方安装器。