用途：从 Markdown 文件中提取所有 Mermaid 代码块，并生成高质量 PNG 图片，便于文档配图或演示排版。
主要能力：按出现顺序为图表编号（01、02……），同时生成 .mmd 源码文件与 PNG 图片；根据图表类型（如时间线、架构、流程图）自动调整画布尺寸；支持自定义宽高与缩放倍率以获得高分辨率或印刷级输出；并对生成的 PNG 文件进行校验。
必要用法：需从技能自带的 scripts/ 目录运行脚本，以保证定位到依赖： cd ~/.claude/skills/mermaid-tools/scripts ./extract-and-generate.sh "<markdown_file>" "<output_directory>" 输出目录为可选参数，默认是 Markdown 文件所在目录下的 diagrams 子目录。可通过环境变量调整尺寸：MERMAID_WIDTH（默认 1200）、MERMAID_HEIGHT（默认 800）、MERMAID_SCALE（默认 2），例如 MERMAID_SCALE=5 提升输出质量。
依赖与限制：运行前需确认 mermaid-cli（mmdc --version）、Google Chrome（google-chrome-stable --version）和 Python 3（python3 --version）已安装；脚本打包了 extract_diagrams.py 与 puppeteer-config.json，必须在 scripts/ 目录内执行，否则可能因找不到依赖而失败。若出现权限问题可执行 chmod +x ~/.claude/skills/mermaid-tools/scripts/extract-and-generate.sh。设置、安装与常见问题（浏览器启动失败、无图表、输出质量差等）参见 references/setup_and_troubleshooting.md。