用途:把用户的流程需求先结构化,再生成可渲染的 Mermaid 图,并导出为可直接发送的高分辨率 PNG 图片。适用于“生成 mermaid 流程图”“简化流程图”“详细中文版本”“导出图片并发送”等请求。
主要能力:先按阶段拆分流程(输入、路由、处理、状态、异常),再选择粒度。简化版不超过 12 个节点,突出主路径;详细版按 subgraph 分层,覆盖关键分支与状态回写。节点文案以中文优先,技术关键词可中英混排。为保证可渲染,节点文字尽量加引号,避免 Mermaid 保留字符导致解析失败,避免在节点内直接使用未转义的 < > / 组合。
使用方式:默认输出路径为 ./media/images/<name>.png,Mermaid 源文件为 ./media/images/<name>.mmd,使用脚本 ./scripts/python/render_mermaid_kroki.py。高分辨率可将 scale 设为 2 或 3。示例命令:
python3 ./scripts/python/render_mermaid_kroki.py
./media/images/rpc-flow.mmd
./media/images/rpc-flow.png
3
交付前检查:Mermaid 语法可渲染、中文标签清晰无歧义、主分支与异常分支都可见、产出 PNG 并成功发送。
限制:资料未提供 Kroki 服务配置、网络要求、依赖安装方式及失败处理细节,暂未提供。