SuperAPI AI 工具集

preview-mermaid

设计与创作

查看项目

更新于 10-16 06:15

技能介绍

用途:preview-mermaid 是一个交互式 Mermaid 图表查看器,用于在浏览器中渲染和预览流程图、时序图、类图、ER 图、状态图、甘特图、饼图、Git 图、用户旅程图、需求图等多种 Mermaid 图表,适合可视化流程图与流程、绘制系统交互时序、记录软件架构、设计数据库结构、规划项目进度和共享可视化文档。

主要能力:支持全部上述图表类型;提供可点击节点的交互图、大图平移与缩放、一键导出 SVG、明暗主题及自适应布局;输出为独立 HTML 文件,位于 .preview-skills/mermaid/{filename}.html,可直接在浏览器打开、分享或存档。

使用方式:Agent 在用户要求预览 Mermaid 图时,不要手写 HTML,应通过 Bash 执行该技能的 run.sh。预览文件用 ./run.sh diagram.mmd;管道输入内容用 echo "graph TD\n A-->B" | ./run.sh。命令行用法包括 /preview-mermaid diagram.mmd、cat flowchart.mermaid | /preview-mermaid,以及加背景色 /preview-mermaid sequence.mmd --background "#ffffff"。暂存或生成内容优先用管道而非临时文件。选项有 -o, --output PATH 指定输出路径、--no-browser 跳过浏览器仅输出文件路径。脚本会自动生成 HTML 并打开浏览器,请勿再手动打开以免产生重复标签页。

限制:文件扩展名为 .mmd、.mermaid,最大 10MB(可配置),编码 UTF-8;需现代浏览器(Chrome、Firefox、Safari、Edge)并启用 JavaScript,依赖 Mermaid.js 的 CDN。图表无法渲染时需检查语法、类型支持与浏览器控制台错误;布局问题可尝试不同方向或子图;导出问题需检查浏览器 SVG 下载与弹窗拦截。技能为独立实现,依赖打包在 lib/ 与 templates/,可修改 config.sh、templates/scripts/mermaid-renderer.js、templates/styles/diagram.css 后运行 run.sh 测试。Mermaid 语法参考 https://mermaid.js.org/ 与 https://mermaid.live/。