一键流程图生成

要解决的问题

手动编写 Mermaid 流程图时，节点文本容易过长导致渲染后难以阅读，判断、处理等不同类型节点的语法规则容易混淆，渲染失败时难以区分是 Mermaid 语法错误还是 Puppeteer 浏览器依赖问题。这些细节会消耗大量调试时间，拖慢将业务流程或技术步骤转化为可视化流程的节奏。

核心能力

• 自动整理结构化内容：将用户的步骤、判断、输入输出和处理结果整理为 Mermaid 源码，优先使用中文短标签，避免节点文本过长；
• 适配链路方向的图表类型：纵向流程用 flowchart TD，横向链路用 flowchart LR；
• 按节点类型规范语法：判断节点用 {}，处理节点用 []，外部输入输出用带引号的节点文本，多角色流程用 subgraph 区分边界；
• 环境检查与异常处理：渲染前通过 command -v mmdc && mmdc --version 检查工具安装及版本，未安装时引导用户安装 Mermaid CLI（未获授权不代装），版本过旧时询问是否升级。

关键步骤

1. 首次渲染前先检查 mmdc 是否安装及版本；
2. 将源码保存为 .mmd 文件，默认存到 docs/mermaid/ 目录（不存在则创建），用户指定位置时按需求存储；
3. 用 mmdc -i 输入.mmd -o 输出.svg 渲染流程图；
4. 渲染失败时区分 Mermaid 语法错误或 Puppeteer 浏览器依赖错误；
5. 交付时提供源码、导出文件的绝对路径链接及 mmdc 版本。

适用边界

• 依赖本机 mmdc 环境，未安装需用户自行完成；
• 适合将结构化步骤转化为可视化流程，不适合需要复杂自定义样式、动态交互的流程图；
• 多角色流程的 subgraph 仅区分角色边界，角色内部复杂逻辑仍需用户自行梳理。