Mermaid AI 如何从提示词生成图表并通过对话继续修改？

Mermaid AI 可以先根据提示词生成一张可工作的图表，再在同一对话中理解当前图表并执行局部修改。稳定的操作方式是：第一条提示明确图表类型、主题和关键关系，生成后用短指令逐次增删元素、调整结构或改变样式，最后切换到文本编辑器完成精确修改。

从哪里开始生成

根据当前官方使用文档，生成入口位于 Mermaid Chart 的新建图表流程中：

1. 进入仪表盘并选择新建图表。
2. 在左侧面板选择 Mermaid AI。
3. 在输入框描述需要的图表。
4. 点击生成，等待第一版结果。

Mermaid AI 当前可用于不同账号方案，但 AI 点数数量会随方案变化。开始较长的编辑任务前，可以先在设置中查看剩余点数，避免在关键修改阶段中断。

第一条提示词要包含三个部分

官方文档建议把图表类型、主题、关键元素或关系写清楚。这三个部分决定了 AI 是在画什么、描述什么，以及节点之间如何连接。

图表类型：时序图
主题：用户通过邮箱重置密码
关键元素：用户、Web 应用、认证服务、邮件服务
关键关系：
1. 用户提交邮箱。
2. Web 应用请求认证服务生成一次性令牌。
3. 邮件服务发送重置链接。
4. 用户提交新密码。
5. 认证服务校验令牌并更新密码。
6. 令牌无效或过期时返回失败，不更新密码。

如果只写“画一个密码重置图”，AI 需要自行判断图表类型和参与者，结果可能是流程图，也可能漏掉令牌过期分支。明确图表类型可以显著减少这种歧义。

不同图表类型如何写提示词

图表类型	必须说明的内容	适合表达的问题
流程图	步骤、判断、循环和结束状态	业务流程与操作路径
时序图	参与者、消息顺序、成功与失败响应	接口调用和跨系统协作
实体关系图	实体、字段、主外键和基数	数据库模型
状态图	状态、触发事件、守卫条件和终态	订单或任务生命周期
甘特图	阶段、日期、依赖和里程碑	项目计划
思维导图	中心主题和分支层级	概念整理与头脑风暴

不要只在提示词里堆名词。对于关系型图表，连接方式比元素清单更重要。

生成第一版时如何控制复杂度

第一轮只要求形成完整骨架，不必同时处理品牌色、图标和所有边缘情况。可以在提示末尾增加可验收约束：

先生成一级结构，不展开内部实现。
节点不超过 12 个。
每个节点只表达一个动作。
保留失败路径和明确终态。
不要添加输入中没有的服务。

先让结构正确，再在对话中细化，通常比一次生成一张巨大图表更容易控制。

如何在同一对话中继续修改

官方文档说明，Mermaid AI 能理解刚刚生成的图表，不需要每轮重新粘贴全部背景。后续请求应明确修改对象、动作、位置和不变项。

在“生成令牌”和“发送邮件”之间增加“保存令牌摘要”节点。
其余参与者和消息顺序保持不变。

增加令牌过期分支：认证服务返回失败，Web 应用提示用户重新申请。
不要把失败分支连接到更新密码。

把认证服务和邮件服务放入“后端服务”分组。
不修改现有消息文字。

“其余保持不变”不能保证绝对不变，因此每轮仍要检查差异，但它能清楚表达修改范围。

增删元素时应怎样提问

增加节点时写明前后位置，删除节点时说明连接如何重接。

在“审核通过”和“发布”之间增加“法务复核”。
审核通过后进入法务复核，复核通过才允许发布，复核拒绝返回草稿。

删除“通知经理”节点，并把“保存申请”直接连接到“进入审批”。
不要删除其他通知节点。

如果只说“加一个法务步骤”，AI 可能把它放到错误阶段；只说“删掉通知”则可能匹配多个相似节点。

调整结构和布局

对话可以改变图表方向、分组和复杂度，也可以在适合时转换图表类型。

把图表改为从左到右，节点关系保持不变。

将前端节点和后端节点拆成两个子图，跨系统调用保留箭头标签。

中间部分过于复杂，把三个内部校验合并为“执行规则校验”，异常出口保持不变。

把流程图转换为时序图会改变表达模型，不是单纯的样式操作。转换后要重新核对参与者、消息顺序和返回值。

通过对话修改样式

结构确认后，再要求 AI 修改颜色、主题或重点路径：

将判断节点设为黄色，成功终点设为绿色，失败终点设为红色。
其他节点使用中性色，不改变布局。

突出从“提交申请”到“审批完成”的关键路径，其他连线保持普通粗细。

颜色必须有一致语义，不要让同一种颜色同时表示角色、状态和优先级。黑白打印或色觉差异场景还应依靠文字和形状区分。

如何从文件开始对话

当前官方文档列出的上传格式包括 PDF、Word 和纯文本。进入 Mermaid AI 面板后，可使用输入框中的附件入口上传文件，再说明要从文件中提取什么结构。

根据这份需求文档生成时序图。
只展示登录、令牌刷新和退出三个用户流程。
参与者为浏览器、API 网关、认证服务和用户数据库。
未知接口不要自行命名，标记为“待确认”。

上传的文件上下文在本次对话期间可继续使用。因此第一轮生成后，可以直接追问“补充错误状态”或“加入管理员流程”，无需再次上传同一文件。

对话上下文不是永久知识库。开始新的聊天、切换项目或隔较长时间继续工作时，应确认文件是否仍在当前上下文中。

怎样避免对话越改越乱

1. 每轮只修改一种内容。
2. 给重要节点使用稳定且唯一的名称。
3. 修改前记录节点数、分支数和关键路径。
4. 修改后立即预览并走查。
5. 重要阶段保存版本或复制语法快照。
6. 出现大范围偏移时回到上一个正确版本，不在错误结果上继续叠加。

对话历史越长，早期约束越容易被后续复杂要求稀释。可以定期用一条消息重申不可改变的业务规则。

何时切换到文本编辑器

当图表整体结构接近目标，只需改一个标签、一条连线或一个节点 ID 时，文本编辑通常更精确。官方文档说明，AI 面板生成的是标准 Mermaid 语法，文本编辑器与 AI 面板保持同步。

sequenceDiagram
    actor User as 用户
    participant Web as Web 应用
    participant Auth as 认证服务
    participant Mail as 邮件服务

    User->>Web: 提交邮箱
    Web->>Auth: 申请重置令牌
    Auth->>Mail: 发送重置链接
    Mail-->>User: 邮件送达
    User->>Web: 提交令牌和新密码
    Web->>Auth: 校验并更新密码

直接编辑后再回到 AI 对话时，先确认预览正常。因为两个面板同步，语法错误也会成为后续对话面对的当前状态。

语法损坏时如何修复

如果手动编辑后图表无法渲染，可以在 Mermaid AI 面板使用 Fix with AI。当前官方流程会识别问题、提出修复并显示差异，用户可以选择应用或放弃。

查看差异时重点检查：

• 是否只修复了引号、括号、箭头或关键字。
• 是否删除了无法解析但业务必要的节点。
• 节点 ID 变化是否影响其他连线。
• 修复后图表类型和方向是否保持一致。

能重新渲染只是语法验收，不代表业务语义正确。

一套多轮对话示例

第一轮生成：

生成从上到下的内容发布流程图。
步骤包括选题、撰写、审核、修改、批准、发布。
审核拒绝时返回撰写，发布失败时进入重试。
所有分支必须有标签。

第二轮补结构：

在批准和发布之间增加“合规检查”。
不通过时返回修改，通过时进入发布。

第三轮简化：

把选题和资料收集合并为“准备选题”，其余节点保持不变。

第四轮分组：

把撰写与修改放入“作者”子图，把审核与批准放入“编辑”子图。

第五轮样式：

将拒绝和失败路径设为红色虚线，正常路径保持实线。

每一步都有单一目标，出现问题时可以准确回退到前一轮。

如何验收最终结果

1. 图表类型与任务一致，没有依赖 AI 猜测。
2. 输入要求中的关键元素全部出现。
3. 节点关系、顺序和基数正确。
4. 每个判断和异常都有明确去向。
5. 后续对话没有删除原本正确的内容。
6. 文件中未明确的信息没有被伪造成事实。
7. 文本语法可以正常渲染。
8. 图表在目标尺寸下仍然可读。

敏感文件与提示词注意事项

上传 PRD、会议记录、架构或数据库文档前，应先删除密码、令牌、个人信息、客户数据和未公开地址。是否允许使用在线 AI 功能，还要遵循组织的数据分类、合同和管理员设置。

只提供完成图表所需的最少内容。如果一份文档过大，可以先整理相关章节，再让 AI 生成指定范围的图，而不是把整个资料库一次上传。

常见问题

为什么生成了错误的图表类型？

提示词没有明确类型时，AI 会根据上下文推断。下一轮直接说明“转换为时序图”或重新以明确类型生成，并核对转换后的语义。

可以在对话中删除节点吗？

可以。写明节点的唯一名称，并说明删除后前后连线如何处理，避免留下断路或误删同名元素。

上传文件后为何还要写提示词？

文件只提供上下文，不会自动说明图表类型、范围和重点。提示词仍需告诉 AI 从文件中提取哪些对象和关系。

对话修改和直接改语法如何选择？

结构性变化适合对话，确定的局部变化适合文本编辑。两者可以交替使用，因为当前图表和语法会保持同步。

总结

Mermaid AI 的连续工作流从一条结构化提示开始：写清图表类型、主题和关键关系，生成骨架后在同一对话里逐次增删元素、调整布局、分组和样式。文件可以为本次对话提供持续上下文，接近完成时再切换到同步的文本编辑器做精确修改。每轮保持目标单一并核对差异，才能让图表在多轮修改后仍然正确、清晰和可维护。