Excalidraw 图表生成器

您可通过自然语言描述生成 .excalidraw 文件。用户可直接在 Excalidraw 中打开这些文件（文件 → 打开），或将其拖拽至画布上。

工作流程

1. 理解描述内容 — 明确用户希望可视化的内容
2. 自动选择图表类型 — 从下方表格中选取最合适的类型
3. 生成中间 JSON 文件 — 编写结构化的 diagram_input.json
4. 运行构建脚本 — 执行 build_excalidraw.py 生成最终文件
5. 通知用户 — 告知输出文件路径及打开方式

图表类型选择

若不确定应选何种类型，优先使用 flowchart —— 它适用于最广泛的场景。

中间 JSON 格式

请在当前工作目录下生成以下任一格式，并保存为 diagram_input.json。

流程图（Flowchart）

{
  "type": "flowchart",
  "title": "简明描述性标题",
  "nodes": [
    {"id": "unique_id", "label": "显示文本", "shape": "rectangle"},
    {"id": "decision", "label": "是否有效？", "shape": "diamond"},
    {"id": "start_end", "label": "开始", "shape": "oval"}
  ],
  "edges": [
    {"from": "node_a", "to": "node_b"},
    {"from": "decision", "to": "node_c", "label": "是"},
    {"from": "decision", "to": "node_d", "label": "否"}
  ]
}

形状选项： rectangle（默认）、diamond（用于决策/条件判断）、oval（用于起始/结束节点）

架构图（Architecture）

{
  "type": "architecture",
  "title": "系统架构",
  "groups": [
    {
      "id": "frontend",
      "label": "前端",
      "nodes": [
        {"id": "web", "label": "Web 应用"},
        {"id": "mobile", "label": "移动应用"}
      ]
    },
    {
      "id": "backend",
      "label": "后端",
      "nodes": [
        {"id": "api", "label": "API 网关"},
        {"id": "auth", "label": "认证服务"}
      ]
    }
  ],
  "nodes": [],
  "edges": [
    {"from": "web", "to": "api", "label": "HTTPS"},
    {"from": "mobile", "to": "api", "label": "HTTPS"}
  ]
}

注意： groups 为可选字段。若无需分组，可在顶层直接使用 nodes 字段定义组件；也可混合使用两者。

思维导图（Mind Map）

{
  "type": "mindmap",
  "title": "主题概览",
  "root": "中心主题",
  "branches": [
    {
      "label": "分支 1",
      "children": ["子主题 A", "子主题 B", "子主题 C"]
    },
    {
      "label": "分支 2",
      "children": ["子主题 D", "子主题 E"]
    }
  ]
}

序列图（Sequence Diagram）

{
  "type": "sequence",
  "title": "交互流程",
  "actors": ["User", "Frontend", "API", "Database"],
  "messages": [
    {"from": "User", "to": "Frontend", "label": "Click Login"},
    {"from": "Frontend", "to": "API", "label": "POST /login"},
    {"from": "API", "to": "Database", "label": "Query user"},
    {"from": "Database", "to": "API", "label": "Return record"},
    {"from": "API", "to": "Frontend", "label": "JWT token"},
    {"from": "Frontend", "to": "User", "label": "Redirect"}
  ]
}

执行步骤

编写完 diagram_input.json 后，运行构建脚本：

python /scripts/build_excalidraw.py 
  --input diagram_input.json 
  --output