用途:在用户请求任意 draw.io 图表时使用,覆盖云架构(AWS、Azure、GCP、Databricks、多云、混合/灾备、landing zone、VPC/网络)及 BPMN 流程等。绘制方式不是手写 draw.io XML,而是编写小型 Node 脚本调用 drawio-ai 引擎,由引擎放置方框并路由箭头,使用者只声明谁包含谁。
主要能力与用法:流程分步执行。先检查 CLI:command -v drawio-ai >/dev/null 2>&1 && drawio-ai root || echo "MISSING",若输出 MISSING 则提示用户安装 npm i -g drawio-ai-kit(不要自行运行全局安装)。随后从用户消息中确定 4 项信息:领域(AWS、Azure、GCP、Databricks、多云、BPMN)、要绘制的内容、输出路径(默认 <cwd>/<short-name>.drawio)、格式(默认 .drawio,也支持 .png),缺失时集中一次询问。然后按领域读取对应参考文件,并按 templates 用 drawio-ai scaffold 复制最接近的模板,编辑 build.mjs 中的树结构,不写 x/y 坐标;用 drawio-ai search 查询图标名,用 drawio-ai run 构建并输出校验与带问题列表的 PNG,逐次修复错误、警告与建议,最多 5 次;最后查看 PNG 并修正。交付前需确认使用布局引擎、图标名均来自 search、validate 返回 "ok":true 且错误为空、文件位于用户项目内而非套件目录,并回复 .drawio 路径、PNG 路径、一句话说明及所做假设。
限制:不得向套件目录写文件,不得编造图标名或样式字符串,不得手写 XML 或坐标,不得阅读引擎源码(dist/、src/),脚本须以 import { ... } from "drawio-ai-kit" 方式导入并用 drawio-ai run 运行。若无法运行渲染,需告知用户未生成 PNG。