DrawIO 图表技能

技能版本：v1.0 训练日期：2026-08-26 依赖：Python 3.8+（脚本零第三方依赖）；导出图片可选 draw.io 桌面版 CLI 参考：https://github.com/Agents365-ai/drawio-skill（MIT License）

功能概述

本技能基于开源工程 Agents365-ai/drawio-skill 微调，核心能力：

• 生成 .drawio 图表：架构图、流程图、ER 图、UML/时序图、网络拓扑、ML/DL 模型图、思维导图等
• 个人风格预设：从老板自己画过的 .drawio 源文件确定性提取配色/形状/字体/排版习惯，固化为 styles/linlan.json，生成时一键套用
• 风格学习：extract_style.py 可对新源文件重新学习风格（含压缩格式解码）
• 导出：.drawio 可经 draw.io 桌面版 CLI 导出 PNG/SVG/PDF/JPG

个人风格预设（linlan）

从 15 张老板源图（架构图 + 流程图两类）提取并人工复核的个人绘制风格：

风格速查表

两类笔触

1. 架构图类（互联网大厂/微服务/钓鱼防护/政务外网）：Tahoma、字号 10-12、黑描边 + 红绿蓝分组色、填充多留白、AWS 图标 + stencil
2. 流程图/技术架构类（BERT/大模型训练/MCP/RAG/人才* 系列）：Helvetica、字号 14、流程图标准形状、浅色填充 + 彩色描边

preset 文件

• styles/linlan.json — 个人风格预设（浅色语义填充 + 黑描边签名 + Tahoma + 直角 + 笔宽1）
• styles/schema.json — preset 结构定义（7 色槽 + 角色映射 + 形状词表 + 字体 + 边 + extras）

为什么 preset 用浅色填充而非留白：preset schema 要求 fillColor 为 #RRGGBB（无法表达"透明"）。故将老板的"黑描边+留白"签名近似为"黑描边+浅色语义填充"，既保留黑描边辨识度，又保留语义颜色可读性。真正的"透明填充+分组彩描边"用法见下方「分组描边色」约定，需按需手写 XML。

分组描边色（架构图分层约定）

preset schema 无法表达"多组彩色描边"，这部分按需手写。老板架构图的分层习惯：

核心脚本

1. extract_style.py — 风格提取（确定性）

# 从目录批量提取（生成 styles/linlan.json）
python scripts/extract_style.py <源文件目录> --name linlan

# 指定输出路径
python scripts/extract_style.py <目录或单文件> --name my-style --out styles/my-style.json

算法（参照参考工程 XML 提取路径，本地化微调）：

• 自动解码压缩格式 drawio（URL解码 → base64 → raw deflate → URL解码 → XML）
• 统计 (fillColor, strokeColor) 对 → 取 top 7 填 7 色槽
• 形状类判定：cylinder3 > ellipse > rhombus > swimlane > rounded=1 > rounded=0
• 角色推断：形状类优先，再 dashed+灰底=external，再标签词表（已补中文词表：队列/网关/认证/错误/数据库 等）
• 字体/字号取众数，加粗大字号子集识别为标题
• 边样式取众数（剥离坐标键），虚线标签 ≥2 共享词入 dashedFor

注意：确定性算法对"每个角色固定 fill+stroke 对"的预设模型有效，但老板的"黑描边+留白"风格会令角色→色槽映射失真（如把 diff 图的 #C925D1 误判为数据库色）。故最终 preset 以人工复核为准，脚本用于快速得到数据底稿 + 后续新文件再学习。

2. analyze_style.py — 逐文件风格统计（复核用）

# 逐文件打印填充色/描边色/字体/字号/形状 TOP5 + 全局汇总，并落盘 style_report.json
python scripts/analyze_style.py <源文件目录>

风格 preset 机制

preset 是命名 JSON，palette 含 7 个语义色槽：

生成时：角色 → roles[role] 得色槽 → palette[slot] 得 (fillColor, strokeColor)；形状用 shapes[role] 前缀；字体统一 font.fontFamily + font.fontSize；边用 edges.style + edges.arrow。

使用工作流（生成图表）

1. 确认需求：图类型（架构/流程/ER/UML/拓扑）、输出格式、组件范围
2. 套用个人风格：默认按 styles/linlan.json（黑描边 + 浅色填充 + Tahoma + 直角 + 笔宽1）
3. 生成 .drawio：手写 XML（自定义样式/图标/泳道/精确几何）或 Mermaid 转 .drawio（标准无样式需求）
4. 自检：结构 lint（悬空边/重复 id/重叠），视觉自检
5. 导出：draw.io CLI 导出 PNG/SVG/PDF/JPG

参考图生成工作流（参考某张图 → 生成新图）

当用户说"参考 X.drawio 生成 Y 架构图"时，按此流程：

1. 分析参考图：跑 ref_analyze.py 产出「参考报告」（风格 + 结构双模板）

   python scripts/ref_analyze.py <参考图.drawio> -o ref_report.md
   

   报告含：配色/字体/形状、页面尺寸、分组泳道层级、节点类型分布、边方向、布局模式（纵向分层/横向分层/网格）

2. 读报告：理解参考图的风格 + 结构骨架（分层、节点类型、边组织方式）

3. 生成新图：按新需求手写 XML，复用参考图的：配色/字体/形状（风格一致）、分组泳道骨架（层级命名按新需求替换）、布局模式（纵向/横向分层，节点数按需增减）、边样式（正交箭头，层间单向流）

4. 自检 + 导出：结构 lint + 视觉自检，draw.io CLI 导出

风格默认套 linlan.json：单图重提取 palette 会失真（"黑描边+留白"风格使角色→色槽映射不稳），故 ref_analyze.py 默认用人工复核的 linlan.json 作为风格；--style <preset> 指定其他预设，--self 才从参考图单图重提取。

目录结构

drawio-skills/
├── SKILL.md                  # 技能说明（本文件）
├── README.md                 # 用户文档
├── scripts/
│   ├── extract_style.py      # 风格提取（确定性，生成 preset）
│   ├── analyze_style.py      # 逐文件风格统计（复核）
│   └── ref_analyze.py        # 参考图分析（风格+结构，供 AI 参考生成新图）
├── styles/
│   ├── schema.json           # preset 结构定义
│   └── linlan.json           # 个人风格预设
└── style_report.json         # 风格分析报告（analyze_style.py 落盘）

参考来源

• 开源工程：https://github.com/Agents365-ai/drawio-skill（MIT，36 脚本/11 预设/万+形状/自检导出）
• 本技能做了四处微调：(1) 增补中文角色词表适配中文标签；(2) 增补压缩格式解码（老板源图为压缩 drawio）；(3) 将老板个人风格固化为 linlan preset，并文档化"黑描边+分组彩描边"签名；(4) 新增 ref_analyze.py 参考图结构分析（页面/分组泳道/节点类型/边方向/布局模式）

已知限制