drawio-generator

如何使用（标准流程）

Step 1：接收用户的流程描述（文字或文件上传）

Step 2：根据描述生成结构化 JSON（nodes + edges），将 JSON 展示给用户确认

Step 3：用户确认后，调用生成脚本：

python3 skills/drawio-generator/scripts/gen.py "图表标题" '{"title":"...","nodes":[...],"edges":[...]}' [类型]

Step 4：交付 .drawio 文件到输出目录，并告知用户：

用 draw.io 打开此文件（网页版 https://app.diagrams.net 或桌面版 App），如需微调请手动调整节点位置后保存。

⚠️ 生成结果非完美，可能存在线条重叠或间距不理想，需要在 draw.io 中手动微调。

输出目录：

• 默认：/Users/owen/Desktop/drawio-generator/
• 可通过环境变量 DRAWIO_OUTPUT_DIR 或命令行 --output-dir 自定义

JSON 结构

{
  "title": "流程名称",
  "type": "flowchart",
  "nodes": [
    {"id": "0", "type": "start", "label": "开始"},
    {"id": "1", "type": "process", "label": "处理步骤"},
    {"id": "2", "type": "decision", "label": "判断条件？"},
    {"id": "3", "type": "end", "label": "结束"}
  ],
  "edges": [
    {"source": "0", "target": "1"},
    {"source": "1", "target": "2"},
    {"source": "2", "target": "3", "label": "是"},
    {"source": "2", "target": "1", "label": "否"}
  ]
}

节点 type 值

edges.label 值

支持的图表类型

flowchart | sequence | network | architecture | hierarchy | function | deployment

文件说明

依赖说明：

• 解析 .docx 需要：pip install python-docx
• 解析 .pdf 需要：pip install pdfplumber

布局参数