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 值
| type | 形状 |
|---|---|
start | 椭圆 |
end | 椭圆 |
process | 圆角矩形 |
decision | 菱形 |
document | 文档形状 |
data | 平行四边形 |
edges.label 值
| label | 含义 |
|---|---|
是 / Y | 条件为真 |
否 / N | 条件为假 |
| 空 | 普通顺序流 |
支持的图表类型
flowchart | sequence | network | architecture | hierarchy | function | deployment
文件说明
| 文件 | 说明 |
|---|---|
scripts/gen.py | 标准生成脚本（必须使用，禁止直接调用 generator.py） |
scripts/generator.py | 底层 XML 生成器（gen.py 内部调用） |
scripts/parser.py | 输入解析（txt 直接读取，docx/pdf 需额外安装库） |
references/drawio-xml-spec.md | draw.io XML 格式规范 |
依赖说明：
- 解析 .docx 需要：
pip install python-docx - 解析 .pdf 需要：
pip install pdfplumber
布局参数
| 参数 | 默认值 | 说明 |
|---|---|---|
CANVAS_WIDTH | 850 | 画布宽度 |
_LAYER_GAP_Y | 120 | 层间垂直间距 |
MAIN_X | 425 | 主轴 X 坐标 |