SuperAPI AI 工具集

convert-mermaid

设计与创作

查看项目

更新于 10-16 08:00

技能介绍

用途:把 Mermaid 语法文件(.mmd 或 .mermaid)转换为高分辨率 PNG 位图,并校验输出文件是否为有效 PNG。

主要能力:提供转换引擎 scripts/convert.py 和验证引擎 scripts/verify_png.py。转换支持 -i 指定输入、-o 指定输出、-s 配置缩放倍数;用户要求“高分辨率”“retina”“HQ”时可将 -s 设为 3 或 4。转换完成后须运行验证脚本,返回 status: success 表示 PNG 二进制有效;返回 errors_found 时查看 JSON 日志(如 MissingMagicBytes、EmptyFile),并参考 references/fallback-tree.md。

使用方式: python ./scripts/convert.py -i architecture.mmd -o architecture.png -s 3 python ./scripts/verify_png.py "architecture.png" 依赖为 Python 3.8+ 且仅用标准库,无需外部包。安装可按: pip-compile ./requirements.in pip install -r ./requirements.txt requirements.txt 为依赖锁定文件,目前为空(仅标准库)。

限制:不要手动从模型上下文写出原始 PNG 位流;不要用 cat 或读取生成的 .png 回上下文中“验证”,它是二进制数据会破坏上下文,必须用 verify_png.py 数学检查。若 npx 包装脚本崩溃或验证循环失败,停止并查阅 references/fallback-tree.md 进行排查。其它平台支持、收费或效果信息暂未提供。