mermaid-flow-image（Mermaid flow 图像）

Mermaid Flow Image Skill

适用场景

• 用户要求：

- “生成 mermaid 流程图” - “简化流程图” - “详细中文版本” - “导出图片并发送”

输出策略

1. 先结构化：把流程拆成阶段（输入 / 路由 / 处理 / 状态 / 异常）。
2. 再选粒度：

- 简化版：≤ 12 个节点，突出主路径。 - 详细版：按子图（subgraph）分层，覆盖关键分支与状态回写。

1. 中文优先：节点文案用中文，技术关键词可中英混排。
2. 可渲染优先：

- 节点文字尽量加引号，避免 Mermaid 保留字符导致解析失败。 - 避免在节点内直接使用未转义的 < > / 组合。

图片导出规范

• 默认输出路径：./media/images/<name>.png
• Mermaid 源文件：./media/images/<name>.mmd
• 使用脚本：./scripts/python/render_mermaid_kroki.py
• 高分辨率：将 scale 设为 2 或 3

示例命令（Python 方式）：

python3 ./scripts/python/render_mermaid_kroki.py \
  ./media/images/rpc-flow.mmd \
  ./media/images/rpc-flow.png \
  3

Mermaid 模板（详细中文）

flowchart TD
  A["输入消息"] --> B["会话路由"]
  B --> C{是否命中复用进程}
  C -->|是| D["复用并继续处理"]
  C -->|否| E["新建进程并初始化"]
  D --> F["流式事件"]
  E --> F
  F --> G["状态持久化"]

交付检查清单

• Mermaid 语法可渲染
• 中文标签清晰无歧义
• 主分支与异常分支都可见
• 产出 PNG 并成功发送