工程开发
draw-io avatar

draw-io

专门用于创建、编辑和维护 .drawio 流程图的技能。支持 XML 操作、排版优化、AWS 图标集成,以及文档自动化 PNG 转换。

简介

draw-io 技能提供了一套完整的工具箱,用于直接在代码仓库中管理架构图、系统流程图和技术文档。此技能专为开发人员和架构师设计,能够对 .drawio XML 文件进行程序化操作,确保复杂图表、时序图和基础设施模型的一致性。通过将图表视为代码 (diagrams as code),此技能简化了版本控制流程,并能自动生成高质量的视觉内容,适用于演示文稿和文档说明。

  • 精确的坐标与几何操作:通过 XML 基础结构调整 draw.io 元素,确保排版精准与视觉清晰度。

  • 自动化转换流水线:利用 pre-commit 钩子将原始 .drawio 文件转换为高分辨率、透明背景的 PNG,适用于 Quarto 演示和 README 文档。

  • 标准化样式与字体管理:包含针对 Noto Sans JP 的特定配置,以及针对 PDF 与屏幕阅读优化的自适应字体大小调整。

  • 高级排版策略:包含元素分组、通过系统到组件层级的渐进式揭露,以及标准化箭头放置,提升技术图表的易读性。

  • 完整的 AWS 图标支持:遵循专业设计原则,例如确保足够的留白边距,并优化标签位置以提高可读性。

  • 原始 workflow 主要基于 XML 编辑,需特别注意 mxGeometry 与 style 属性设置。

  • 务必通过执行转换脚本来验证输出,确保排版调整不会造成元素重叠或内容裁剪。

  • 为获得最佳效果,建议针对网页或 PDF 使用 1.5 倍字体缩放,并优先使用透明背景以确保与各种演示主题的兼容性。

  • 请遵循坐标计算规则,特别确保内部元素在父框架内保持至少 30 像素的间距。

  • 请勿直接编辑生成的 .drawio.png 文件;仅依赖自动化转换流程,以确保原始文件作为唯一真实来源 (Source of Truth) 的完整性。

仓库统计

Star 数
26,286
Fork 数
2,620
Open Issue 数
147
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年4月29日 06:51
在 GitHub 查看