SuperAPI AI 工具集

mermaid-diagram

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:将口头或书面描述的过程、架构、数据模型、时间线与关系翻译为正确的 Mermaid 语法,输出使用 mermaid 标识的围栏代码块,可在 Obsidian、GitHub、GitLab、Notion 及现代 Markdown 环境原生渲染。Mermaid 是文本图表语言,便于版本控制、diff 和直接嵌入 Markdown,无需上传图片。

主要能力:支持流程图(flowchart TD / graph LR)、时序图(sequenceDiagram)、类图(classDiagram)、状态图(stateDiagram-v2)、实体关系图(erDiagram)、思维导图(mindmap)、甘特图(gantt)、饼图(pie)、象限图(quadrantChart)、Git 图(gitGraph)、时间线(timeline)和 XY 图(xychart-beta)。工作流程为:识别图表类型、提取节点与关系、编写 Mermaid 语法、校验语法、给出渲染说明。

使用方式:用户要求“画图”“生成图表”,或提供流程、架构、数据模型文字描述,或上传已有图片要求转换,或明确提到 Mermaid 及具体图表类型时调用。输出格式为:```mermaid 代码块。简单请求只输出代码块;复杂图表可附一行说明和渲染提示。

适用场景:流程图、时序图、类图、状态机、数据库 ER 图、思维导图、项目甘特图、比例饼图、优先级象限图、Git 分支历史、时间线和柱线图。

限制:仅生成文本图表,不适用于手绘或图片式图表、需要点击交互的图表(应使用 JavaScript 库)、Excalidraw(应使用 excalidraw-diagram)或白板式画布(应使用 obsidian-canvas)。单图节点建议不超过 20 个,超过 8 个节点建议使用子图分组。节点标签含逗号、括号等特殊字符需加引号,否则可能解析失败。类图不支持 direction 关键字。若类型不明确,应先提一个澄清问题。渲染方式:Obsidian 原生支持;GitHub/GitLab 在 .md 和 wiki 中渲染;VS Code 需安装 Mermaid Preview 扩展;浏览器可用 mermaid.live 预览。