yizhiyanhua-ai/fireworks-tech-graph

解决的问题

fireworks-tech-graph 是一个旨在消除手动绘图需求的 Agent 技能。用户可以用自然语言（英文或中文）描述技术系统，该工具会自动生成精美的、经过几何验证的技术图（SVG、PNG 和交互式 HTML 格式），以及语义动画 GIF。

工作原理

该工具采用代理驱动的验证循环，确保输出高质量。它不依赖单次生成，而是遵循多步骤流程：

1. 语义中间表示生成：将自然语言描述转换为带版本的中间表示（IR）。
2. 结构验证：检查 XML 完整性、路径几何、箭头碰撞。
3. 渲染：生成 SVG 和高分辨率 PNG。
4. 视觉回读：检查导出的 PNG 是否存在裁剪、标签重叠和路由质量。
5. 定向修正：根据验证结果进行针对性修正，再交付最终验证过的资产。

适用人群

主要面向使用 AI 代理（特别是 Codex 和 Claude Code）来记录系统架构、云部署、事件流和 UML 图的开发者、架构师和技术写作者。

特色亮点

• 12 种视觉风格：包含 11 种生成器驱动的配置文件和一种 AI 创作的「暗奢」风格。
• 全面的图类型支持：完整支持 14 种 UML 图类型，以及 AI/代理领域专用模式（如 RAG、多代理、Mem0）。
• 几何安全路由：确保确定性的正交路径，零交叉、最少弯折、经验证的间距。
• 语义动画：生成经过验证的 SVG 到 GIF 动画，连接线按特定语义顺序绘制。
• 工程契约：在 C4 评审、多区域部署、可靠性脉冲等特定场景中强制执行严格规则。
• 统一导出：支持 SVG、1920px PNG，以及支持平移/缩放和主题切换的离线交互式 HTML。