SuperAPI AI 工具集

mermaid-tools

写作与研究

查看项目

更新于 10-15 20:35

技能介绍

用途:从 Markdown 文件中提取所有 Mermaid 图表代码块,并生成高质量 PNG 图片,适合为文档、演示或打印材料配图。

主要能力:内置 extract-and-generate.sh、extract_diagrams.py 和 puppeteer-config.json,可自动提取图表、按出现顺序编号(01、02…)、生成 .mmd 源文件与高分辨率 PNG,并校验输出。脚本会根据文件名中的图表类型智能调整尺寸,如时间线/甘特图用 2400×400,架构/系统/缓存用 2400×1600,监控/工作流/序列/API 用 2400×800,默认 1200×800。

使用方式:先进入脚本目录再运行,避免依赖缺失: cd "${CLAUDE_SKILL_DIR}/scripts" ./extract-and-generate.sh "<markdown_file>" "<output_directory>" 输出目录可选,默认是 Markdown 所在目录下的 diagrams。可用环境变量覆盖尺寸:MERMAID_WIDTH(默认 1200)、MERMAID_HEIGHT(默认 800)、MERMAID_SCALE(默认 2)。例如演示用 MERMAID_WIDTH=2400 MERMAID_HEIGHT=1800 MERMAID_SCALE=4,打印质量用 MERMAID_SCALE=5。

运行前需确认依赖:mmdc --version、google-chrome-stable --version、python3 --version。若权限不足可执行 chmod +x "${CLAUDE_SKILL_DIR}/scripts/extract-and-generate.sh"。

适用场景:需要把 Markdown 中的 Mermaid 图批量转为图片的文档工作流。

限制:依赖 mermaid-cli、Google Chrome 和 Python 3;未安装时需参考 references/setup_and_troubleshooting.md。脚本必须从 scripts/ 目录运行,否则可能找不到依赖。资料未提供收费、平台支持范围等更多信息。