sparklabx/drawio-ai-kit

解决的问题

AI代理在创建准确的 draw.io 图表时常常遇到困难，经常幻觉出不存在的模板ID，或未能遵循架构布局标准。此工具包提供了一个框架，确保AI生成的图表在结构上精确、视觉上标准化，并使用有效的云架构模板。

工作原理

该项目采用三管齐下的方法来指导AI代理：

1. 声明式目录：一个可信的源头，将 draw.io 模板ID映射到正确的分类和颜色，防止AI虚构形状。
2. 设计原则：AI必须遵循的一组形式化的架构和布局规则。
3. 结构验证器：一个静态分析引擎，审计图表XML，确保模板引用有效且设计原则得到满足，然后才最终确定文件。

代理通过零依赖CLI（drawio-ai）与这些工具交互。系统还支持一个布局引擎，该引擎基于定义的拓扑（例如网络、流水线或网格）以编程方式计算空间坐标，而不是要求AI猜测原始像素坐标。

适用人群

使用AI代理（如Claude Code或Gemini CLI）自动化创建AWS、Azure、GCP和Databricks架构图，以及BPMN流程图的云架构师和开发者。

主要亮点

• 多云支持：针对AWS、Azure、GCP和Databricks的专用领域技能。
• 零依赖CLI：一个自包含工具，用于搜索模板、验证XML和渲染图表。
• 自动布局：基于逻辑拓扑自动处理尺寸和间距的布局引擎。
• 基于视觉的修正：支持渲染-分析-修正循环，AI可将图表渲染为PNG，并利用视觉能力进行自我修正。