sparklabx/drawio-ai-kit

  

一个编排与验证框架，使AI代理能够生成结构精确且美观标准化的 draw.io 图，针对AWS、Azure和GCP架构进行优化。

它通过三个关键组成部分缓解常见的人工智能智能体幻觉（例如生成不存在的模板ID导致空形状）：

1. 声明式目录——单一的 draw.io 真实来源，将模板ID（mxgraph.aws4.*）映射到各自的分类法和规范色彩调色板。
2. 设计原则 — 规范化的建筑和布局规则（skills/drawio/references/principles.md）。
3. 结构验证器 — 一个静态分析引擎，用于审计图表 XML 以确保模板引用的有效性且设计原则在序列化前得到满足。

通过自包含的drawio-aiCLI（一个捆绑文件，无需额外安装）暴露给AI。

展示

每个平台一张图——全部由套件端到端生成：无手工坐标，真实模板，经过验证，经过视觉检查。完整套装在examples/。

快速开始

要求： Node.js ≥20.6 或者 面包1.4+。

  

An orchestration and validation framework enabling AI agents to generate structurally precise and aesthetically standardized draw.io diagrams, optimized for AWS, Azure & GCP architectures.

It mitigates common AI agent hallucinations (such as generating non-existent stencil IDs that result in empty shapes) using three key components:

1. Declarative Catalog — A single source of truth mapping draw.io stencil IDs (mxgraph.aws4.*) to their respective taxonomies and canonical color palettes.
2. Design Principles — Codified architectural and layout rules (skills/drawio/references/principles.md).
3. Structural Validator — A static analysis engine that audits diagram XML to guarantee stencil references are valid and design principles are satisfied prior to serialization.

Exposed to the AI via the self-contained drawio-ai CLI (one bundled file, nothing extra to install).

Showcase

One diagram per platform — all generated end-to-end by the kit: no hand-placed coordinates, real stencils, validated, vision-checked. Full set in examples/.

Quick start

Requirements: Node.js ≥20.6 or Bun 1.4+. Nothing else to install.

Bun-only machine (no node)? The CLI’s shebang is #!/usr/bin/env node (the Windows-safe standard), so install.sh writes ~/.local/bin/drawio-ai as a wrapper that runs bun /dist/cli.mjs. Re-run install.sh after bun update -g. With a manual bun add -g, run bun $(bun pm bin -g)/../install/global/node_modules/drawio-ai-kit/dist/cli.mjs or install Node.

1. One-liner (CLI + skill)

curl -fsSL https://raw.githubusercontent.com/sparklabx/drawio-ai-kit/refs/heads/main/install.sh | sh