MermaidViewer AI 流程图生成器如何输出可编辑 Mermaid 代码？

MermaidViewer 的 AI 流程图生成器可以把自然语言需求转换为可视化流程图，同时返回可编辑的 Mermaid 源码。基本流程是选择流程图类型、输入清晰的步骤与判断、立即生成、检查预览和代码，再按账户方案下载图片或复制源码。生成结果仍需人工核对，因为语法能够渲染并不代表业务逻辑正确。

使用前需要了解什么

• AI 流程图页面用于把文本需求转换为 Mermaid。
• 编辑器可以实时预览 Mermaid 代码。
• 网站还提供时序图、类图、状态图、ER 图、甘特图、C4 图等专用入口。
• 免费方案当前每天提供有限 AI 对话次数。
• 图片质量、格式、水印和版本历史受账户方案影响。

AI 页面显示“建议 50–500 字”，但当前输入计数器又显示以 200 为上限的形式，两处信息并不完全一致。实际提交时应以输入框即时校验和按钮状态为准；长需求可先压缩，再拆成多张图。

如何生成第一张流程图

1. 打开 AI 流程图生成器。
2. 在主题或描述框中输入流程需求。
3. 明确开始事件、操作步骤、判断条件和结束状态。
4. 点击立即生成。
5. 等待标题、图表预览和 Mermaid 代码出现。
6. 检查每个节点和连接。
7. 直接修改生成的 Mermaid 源码。
8. 确认后下载或复制源码。

如果需要的不是流程图，应使用对应的专用 AI 图表入口，而不是要求流程图生成器猜测时序图或类图语法。

提示词应该包含哪些信息

高质量流程图提示包含五类信息：

• 触发条件：流程从什么事件开始。
• 执行主体：用户、系统或具体角色。
• 动作步骤：每一步实际做什么。
• 判断条件：分支依据以及各自去向。
• 结束状态：成功、失败、取消或待处理。

例如，可以这样描述退款流程：

生成一个从上到下的退款审批流程图。
客户提交退款申请后，客服检查订单是否存在。
订单不存在时拒绝申请并通知客户。
订单存在时检查是否在 30 天退款期内。
在期限内由财务退款；超过期限则交主管人工审核。
主管拒绝时结束，批准时由财务退款。
退款完成后发送通知，所有判断边标注“是”或“否”。

只写“画退款流程”会让模型自行猜测规则，生成内容难以直接使用。

如何控制图表布局

Mermaid 流程图通常使用方向声明控制整体布局：

• TD 或 TB：从上到下，适合步骤较多的纵向流程。
• LR：从左到右，适合放入宽屏演示文稿。
• RL：从右到左。
• BT：从下到上。

可以在提示词中写明方向，也可以生成后手工修改第一行：

flowchart TD
    A[提交申请] --> B{订单是否存在}
    B -- 否 --> C[拒绝并通知]
    B -- 是 --> D{是否在退款期内}
    D -- 是 --> E[财务退款]
    D -- 否 --> F[主管审核]

当图表过宽时，切换为纵向布局、缩短节点文字或拆分子流程，比单纯缩小字体更有效。

可编辑 Mermaid 代码有什么价值

AI 返回的不是只有图片，而是 Mermaid 文本。源码可以继续修改、复制到 Markdown、纳入 Git 版本控制，并在支持 Mermaid 的平台重新渲染。

与不可编辑截图相比，源码具有以下优势：

• 修改节点或连接不需要重新绘制。
• 代码审查可以显示结构变化。
• 能在不同主题和分辨率下重新导出。
• 可以与需求、源码和文档一起维护。
• 不依赖单一在线账户保存最终资产。

怎样手工修改生成代码

普通步骤多用方括号，判断节点多用花括号，箭头表示流程方向。修改时重点检查：

1. 每个节点标识是否唯一。
2. 括号、引号和连接符是否闭合。
3. 分支标签是否准确。
4. 每条边是否指向正确节点。
5. 循环是否存在退出条件。

节点标识与显示文字是不同概念。例如 A[提交申请] 中，A 是标识，方括号中的内容才是显示文字。重复使用标识会让原本不同的步骤合并。

实时预览与智能调试怎么用

MermaidViewer 主编辑器支持输入时实时预览，并宣称提供语法错误高亮和自动纠正建议。出现错误时不要同时修改多处，应先定位到最小问题：

1. 保留图表声明和少量节点。
2. 确认最小代码可以渲染。
3. 逐段恢复节点和连接。
4. 检查刚恢复的那一段。
5. 修复后再恢复样式和长标签。

常见错误包括缺少括号、箭头拼写错误、标签含有未处理的特殊字符，以及把其他图表类型的语法混入流程图。

生成结果应如何验收

建议按三层验收：

• 语法层：编辑器和目标平台均能渲染。
• 结构层：没有悬空节点、断路或缺少出口的判断。
• 业务层：角色、权限、金额、时限和状态变化符合真实规则。

AI 可能生成语法完全正确但业务错误的图。例如把失败分支连到成功通知，或漏掉支付超时。流程负责人应逐条对照原始需求。

怎样处理复杂流程

复杂需求不要一次生成一张超大图。可以先画主流程，再分别生成异常处理、权限审批和外部系统交互：

1. 确定主图的阅读目标。
2. 保留关键决策，不展开所有实现细节。
3. 把超过一屏的分支拆为子流程。
4. 为子流程设置明确入口和出口。
5. 在文档中链接或编号这些图。

拆分还能降低提示词长度，避免触发页面字符限制。

其他 AI 图表入口如何选择

页面列出了大量图表类型。应按信息关系选择：

• 调用按时间发生：时序图或 ZenUML。
• 类、属性和继承：类图。
• 生命周期迁移：状态图。
• 表与基数：实体关系图。
• 用户步骤和情绪：用户旅程图。
• 任务日期与依赖：甘特图。
• 系统边界和层级：C4 图或架构图。
• 分支和提交历史：Git 图。
• 需求追踪：需求图。
• 流量或资源流向：桑基图。

一段需求同时涉及多个维度时，分别生成多张图，避免让一张流程图承担所有表达任务。

如何导出图表

主站介绍了 SVG、PNG、Markdown 与 PDF 等格式，但不同方案的权益并不相同。当前方案页面显示：

• 免费版：低分辨率 PNG，带水印。
• 入门版：高分辨率 PNG，无水印。
• 专业版：PNG、JPG、PDF 和 SVG 等全部格式。

功能介绍页与具体账户按钮可能出现差异，导出前以当前方案和实际界面为准。

格式如何选择

• PNG：适合 Word、聊天工具和兼容性优先的场景。
• SVG：适合网页、设计工具和任意缩放。
• PDF：适合固定版式交付或打印。
• Markdown/Mermaid：适合文档仓库和持续维护。

最佳实践是同时保存 Mermaid 源码和一种交付格式。

免费与付费方案有哪些限制

当前页面显示免费版最多保存 3 个图表，每天 5 次 AI 对话，低分辨率 PNG 带水印，没有版本历史。入门版最多 30 个图表，每月 500 次 AI 对话，支持无限分享和 30 个版本历史。专业版提供无限图表、无限 AI 对话、全部导出格式和 100 个版本历史。

价格和权益会变化，购买前应确认结算页的币种、周期、续费方式和实际功能，不应把页面示例当作长期保证。

“数据保存在浏览器”应该怎样理解

首页称数据保存在浏览器中且不会上传服务器，这一描述可以适用于纯本地编辑和预览，但不能机械套用到 AI 生成、账户同步、分享或协作功能。AI 把自然语言转换为代码，必然需要把提示交给提供推理的服务；分享链接也需要某种远端状态。

当前中文隐私与条款页面几乎没有展示具体政策正文，因此无法从这些页面确认 AI 提供商、保留期限、训练用途或删除流程。敏感数据应按外部在线服务处理：

• 不要输入密码、令牌、私钥和连接字符串。
• 不要提交真实客户身份信息。
• 使用抽象服务名替代内部域名和网络地址。
• 分享前检查节点与 Mermaid 注释。
• 受监管项目应先完成组织的数据审查。

“无需注册”也不等于匿名、离线或无网络请求。浏览器仍可能发送 IP、日志或 AI 请求。

如何把图表纳入版本控制

将 Mermaid 源码保存为 .mmd 文件，并把导出图作为生成产物：

docs/
  diagrams/
    refund-flow.mmd
  images/
    refund-flow.svg

提交时审查源码变化，必要时重新生成 SVG。在线版本历史可以辅助恢复，但不能替代 Git；免费方案甚至没有版本历史。

常见故障如何排查

输入达到上限仍无法提交

页面建议字数与计数器可能不一致。以当前输入框校验为准，删除背景说明，只保留节点、条件和连接，或拆成子流程。

点击生成后结果为空

检查网络、每日 AI 次数、输入长度和浏览器控制台。不要连续重复提交，以免消耗额度或产生重复请求。

生成代码无法渲染

从最小 Mermaid 示例开始，逐段恢复代码。重点检查声明、括号、箭头和特殊字符。

流程图缺少分支

在提示中逐项列出判断的所有出口，并说明每个出口的目标节点。使用一致的“是/否”或“成功/失败”标签。

导出按钮没有 SVG 或 PDF

检查当前账户方案。部分格式只在专业版提供，功能总览不代表免费账户都可用。

目标 Markdown 平台显示错误

目标平台可能使用不同 Mermaid 版本。简化实验性语法，或导出 SVG、PNG，同时保留源码。

分享链接泄露内部信息

立即撤销链接或删除远端图表，轮换任何暴露的凭据，并检查访问日志。以后分享前先用脱敏副本。

最终验收清单

1. 提示词符合当前输入长度限制。
2. 图表类型与阅读目标一致。
3. 所有步骤和判断都与需求一致。
4. 异常、超时和取消路径已补齐。
5. Mermaid 在目标平台能够渲染。
6. 提示和图表不包含敏感数据。
7. 导出格式与账户权益匹配。
8. 源码已经保存并纳入版本控制。
9. 图表经过流程负责人审核。

总结

MermaidViewer AI 流程图生成器的核心价值是把自然语言快速转换成可继续编辑的 Mermaid 源码。要获得可用结果，提示词必须明确步骤、判断和分支，生成后还要完成语法、结构和业务三层检查。免费额度、导出格式和版本历史受方案限制；首页的本地数据表述也不能覆盖 AI、同步和分享请求。保留 Mermaid 源码、在最终平台复测并对输入脱敏，才能让生成图真正进入长期文档流程。