yizhiyanhua-ai/fireworks-tech-graph

解决的问题

fireworks-tech-graph 免去了手动绘制技术图表的需求。它允许用户用自然语言（英文或中文）描述系统架构或流程，并自动生成经过几何检查的精美图表，支持 SVG、PNG 和交互式 HTML 格式，以及语义 GIF 动画。

工作原理

本项目作为 Codex 和 Claude Code 等 AI 助手的代理技能运行。它遵循有界验证循环以确保质量：

1. 生成：将自然语言提示转换为语义中间表示 (IR)，然后转换为 SVG。
2. 确定性验证：检查 XML 结构、标记完整性和路径几何，以防止边缘重叠或航点格式错误等问题。
3. 感知验证：将 SVG 渲染为 PNG 并执行视觉回读，以检查是否存在裁剪、标签碰撞和路由质量问题。
4. 定向修正：如果发现错误，系统会在最终交付前对特定坐标或标签执行针对性修正。

适用对象

• 软件工程师：用于创建 C4 评审、云部署图和事件驱动架构图。
• AI/代理开发者：用于可视化 RAG 管道、多代理协作和内存架构。
• 技术文档撰写者：用于生成一致且高质量的文档视觉内容，无需手动绘图工具。

亮点

• 12 种视觉风格：包含 11 种由生成器支持的风格和一种 AI 创作的“Dark Luxury”风格。
• 工程契约：对特定图表类型（例如 C4、Cloud Fabric、Event Transit）强制执行严格规则，以确保技术准确性。
• 全面支持：支持 14 种 UML 图表类型和专门的 AI/代理领域模式（例如 Mem0、Tool Call 流程）。
• 语义动画：将 SVG 转换为 GIF，其中连接器按特定的语义顺序绘制，并具有“settled-flow”时间轴。
• 几何安全路由：使用确定性的正交路由来避免线条交叉并最小化弯曲。
• 交互式导出：生成具有平移/缩放、主题切换和多种导出格式的离线 HTML 文件。