用途
space-mermaid-diagram 用于将任意文本、描述、工作流或逻辑转换为清晰简约的 Mermaid 图表。它适合需要可视化工作流程、将文档或对话转为流程图、创建系统架构图、生成时序图或类图等场景。
主要能力
- 智能识别结构：从文本中提取逻辑关系和流程步骤，识别内容类型、核心实体、逻辑关系与复杂度。
- 多图表类型：支持 flowchart、sequence、class diagram。
- 清晰简约：使用 emoji 和图标增强可读性。
- 批量生成：复杂逻辑可拆分为多个关联图表。
- 自动分类保存：按 MMDD-主题 分文件夹保存到 Obsidian 画板目录。
支持的图表类型
| 类型 | 适用场景 | 触发词 |
|---|---|---|
| Flowchart | 工作流程、决策树、系统流程 | 流程图、工作流 |
| Sequence | 时序交互、API 调用、用户旅程 | 时序图、交互流程 |
| Class | 系统架构、数据模型、类关系 | 架构图、类图 |
使用方式
工作流程
- 分析输入内容：识别内容类型、核心实体、逻辑关系与复杂度，判断是否需要拆分为多个图表。
- 选择图表类型：根据规则自动选择，顺序流程加分支决策用 Flowchart，多方交互加时间顺序用 Sequence，模块关系加继承组合用 Class；用户也可指定。
- 设计图表结构：Flowchart 使用 flowchart LR/TB 方向、简洁节点命名、subgraph 分组、菱形决策点、粗箭头关键路径；Sequence 参与者命名清晰、每步一句话、Note 补充关键信息、异步操作用虚线；Class 类名用大驼峰、简化展示核心属性方法、关系清晰、note 说明设计意图。
- 增强可读性：使用 emoji 标注应用层、工具类、数据层、安全模块、成功状态、失败状态、配置、启动等；在 subgraph 中使用颜色提示。
- 保存文件：目录结构为 00 收件箱/画板/mermaid流程图/MMDD-主题名/，包含 01-主流程图.md、02-子流程图.md、README.md 等；单个图表命名为 MMDD-主题名.md，多个图表按序号-子主题.md 命名。文件内容模板包含主题名、图表类型、生成时间、来源、图表说明、Mermaid 代码和要点说明。
触发方式
用户说“生成流程图”“转为 mermaid”“画个图表”“可视化这个流程”“用时序图展示”“创建架构图”等均可触发。
适用场景
- 需要可视化工作流程。
- 将文档或对话转为流程图。
- 创建系统架构图。
- 生成时序图或类图。
限制
- 详细语法参考位于 references/mermaid-syntax.md。
- 生成后需自检图表质量，包括流程方向、决策点、开始结束、分支出口、参与者命名、时间顺序、异步操作、Note、类名规范、关系类型、核心属性方法展示等。
- 最佳实践建议一图一主题，每个 subgraph 3-7 个节点，节点名称 3-5 个字，适度使用 emoji；节点数超过 15、有明显子流程、涉及多个系统或角色、需要展示不同层次时应拆分。
- 其他功能、收费、价格、平台、效果或使用步骤暂未提供。