用途:把 Mermaid 语法文件(.mmd 或 .mermaid)转换为 PNG 二进制图片,并支持按需提升分辨率。\n\n主要能力:提供转换脚本与校验脚本两个工具。转换时可设置分辨率倍数,例如用户要求高分辨率、retina 或 HQ 时,将 -s 设为 3 或 4。转换完成后执行独立校验脚本,确认输出为有效 PNG 二进制。\n\n使用方式:先运行转换脚本,参数为 -i 输入文件、-o 输出文件、-s 分辨率倍数,例如:python3 ./scripts/convert.py -i architecture.mmd -o architecture.png -s 3。随后必须运行校验:python3 ./scripts/verify_png.py "architecture.png"。若返回 status 为 success,表示图片为有效 PNG;若为 errors_found,需查看 JSON 日志(如 MissingMagicBytes、EmptyFile),并按 references/fallback-tree.md 排查。\n\n限制与约束:不要尝试在上下文窗口中直接生成 PNG 二进制数据;不要用 cat 或读取方式把生成的 PNG 读回上下文来验证,因为它是原始二进制,会破坏上下文,必须通过 verify_png.py 进行数学化校验。若转换脚本或校验循环失败,应停止并参考 fallback-tree.md 进行排查。具体依赖、安装步骤与平台支持暂未提供。
convert-mermaid
通用与其它
更新于 10-16 08:00