流程与架构图绘制

数据 社区 v1.14.0

技能解读

当前原文的自动摘译,尚未人工审校。

概述

使用本机draw.io桌面应用程序CLI在本地生成.drawio XML文件并导出为PNG/SVG/PDF/JPG。支持的格式:PNG、SVG、PDF、JPG — 无需浏览器自动化。 PNG、SVG 和 PDF 导出支持 --embed-diagram (-e) — 导出的文件包含完整的图表 XML,因此在 draw.io 中打开它可以恢复可编辑的图表。使用双扩展 (name.drawio.png) 来表示嵌入的 XML。

何时使用/何时不使用

使用此技能可用于:精美、精确的图表(架构、网络、严格的 UML、ERD)、任何需要固体不透明填充的内容、10,000 多个库存/品牌形状、泳道或自定义几何图形,导出为可编辑的 PNG/SVG/PDF。请勿将其用于其他用途(路由到其他地方):休闲手绘/白板外观 → excalidraw 或 tldraw。图表即代码,存在于 git 中 / 在 Markdown 中渲染 → mermaid (通用) 或 plantuml (UML)。

捆绑资源

当工作流程引用其中之一时,请按需阅读——它们都不需要预先处于上下文中。文件 · 当 references/diagram-types.md · 用户命名特定图表类型(ERD、UML 类、序列、架构、ML/DL、流程图) references/shapes.md + scripts/shapesearch.py · 图表需要特定形状 — 云图标 (AWS/Azure/GCP)、Cisco/Kubernetes/网络符号、UML/BPMN/ER/electrical/P&ID 元素 — 或任何您猜测的时间时阅读style= 字符串。 shapesearch.py "<keywords>" 返回 10k+ 形状的确切官方样式

先决条件

必须安装draw.io桌面应用程序并且可以访问CLI:macOS沙箱/沙箱隔离注意事项(例如,codex.app):在某些沙箱macOS环境中,调用draw.io桌面CLI(甚至drawio --version)可能会使draw.io进程崩溃或不产生任何输出。如果发生这种情况,请将 CLI 视为在此沙箱隔离中不可用 — 不要在沙箱内继续重试。首选非沙盒主机环境(沙盒隔离之外)进行任何 CLI 导出工作,或使用浏览器后备/仅 XML 输出。

工作流程

在开始工作流程之前,评估用户的请求是否足够具体。如果缺少关键细节,请提出 1-3 个重点问题: 图表类型 — 哪种预设? (ERD、UML、序列、架构、ML/DL、流程图或一般)输出格式 — PNG(默认)、SVG、PDF 或 JPG?输出位置——默认是用户的工作目录;尊重用户给出的任何显式路径(例如“将其放入./artifacts/”)。不要问他们是否没有提到这一点。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
数据
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
98 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@Agents365-ai · v1.14.0 · MIT
上下文用量评级
较高消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows · Docker
运行环境要求
Node.js · Python · Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第五步:自检

导出 PNG 草稿后,使用代理的视觉功能(例如 Claude 的图像输入)读取图像并在向用户显示之前检查这些问题。 如果代理不支持视觉,则跳过自检,直接显示PNG。

02
第 6 步:回顾循环

自检完成后,展示导出的图像并询问用户反馈。有针对性的编辑规则 - 对于每种类型的反馈,应用最小的 XML 更改: 用户请求 · XML 编辑操作 更改 X 的颜色 · 通过匹配 X 的 `value` 查找 `mxCell`,更新 `style` 中的 `fillColor`/`strokeColor` 添加新节点 · 附加新的 `mxCell` 顶点以及下一个可用顶点`id`,靠近相关节点的位置

03
第7步:最终导出

用户批准后: 导出为所有请求的格式(PNG、SVG、PDF、JPG) - 如果未指定,则默认为 PNG 报告`.drawio`源文件和导出图像的文件路径 自动启动:提供在draw.io桌面中打开`.drawio`文件进行微调 - `open diagram.drawio` (macOS)、`xdg-open` (Linux)、 `start` (Windows) 确认文件已保存并可供使用

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。