fireworks-tech-graph

fireworks-tech-graph 是一个 Agent Skill，可在 Codex 和 Claude Code 中无需修改直接运行。它将自然语言描述（英语或中文）转换为几何校验的 SVG 图表、高分辨率 PNG 导出、经过验证的 SVG 转 GIF 语义动画，以及单个离线交互式 HTML 文件。 核心能力 - 12 种视觉风格：11 种基于生成器的配置文件加 1 种 AI 创作风格（Dark Luxury）。四种工程优先风格为 C4 审查、云部署、事件流和可靠性调查添加了可执行契约。 - 14 种图表类型，全面支持 UML：类图、组件图、部署图、包图、复合结构图、对象图、用例图、活动图、状态机图、序列图、通信图、时序图、交互概览图和 ER 图，以及 AI/Agent 领域模式，如 RAG、Agentic Search、Mem0、Multi-Agent 和 Tool Call。 - 语义词汇表：形状编码角色（LLM 为双边框矩形，Agent 为六边形，Vector Store 为环形圆柱体），箭头颜色/虚线模式编码含义（写入、读取、异步、循环）。 - 路由和布局：确定性正交路由，精确路径点，不同端口，自动图例重定位，标签保持在画布内，以及针对不可避免交叉的验证桥接跳转。 - 验证：版本化图表 IR 将旧版 JSON 规范化为 schema v1，并在重复 ID、悬空引用、格式错误的路径点或非有限几何体时失败；结构化 SVG 检查涵盖 XML 和标记完整性，以及节点、保留区域、标签、画布、边重叠和边交叉条件。 - 输出：SVG 用于编辑，1920px PNG 用于嵌入；纯内联 SVG，无外部字体获取，旨在在 cairosvg、rsvg-convert 和 headless Chrome 中渲染。统一 CLI 支持 render、validate、check、export-html 和 animate，HTML 导出添加了平移/缩放、明暗主题、源代码复制以及 1x-4x 的 SVG/PNG/JPEG/WebP 下载。 - 动画：animate 命令接受携带十二种批准运动契约之一的生成语义 SVG，并输出 GIF 以及 motion.json 验证报告。文档默认值为 960px、5.75 秒、20fps、115 帧采样，连接器按语义顺序绘制；也支持较短的 75 帧和 55 帧时间线。 - 视觉审查门：导出的 PNG 被检查裁剪、重叠、标签放置和路由回归，默认最多进行两次聚焦修正；如果运行时无法读取图像，该技能报告 visual_review 为跳过，而不是声称验证。 - 产品图标：40 多个带品牌色的产品，以及复杂架构的自动泳道分组。 安装和要求 通过 skills CLI 使用嵌套路径 skills/fireworks-tech-graph 安装，或将仓库克隆到 ~/.agents/skills（Codex）或 ~/.claude/skills（Claude Code）；也记录了带符号链接的共享检出。需要 Python 3.9+。SVG/PNG 脚本需要 cairosvg（推荐）或 rsvg-convert；可选的 GIF 导出需要 FFmpeg/FFprobe、Chrome/Chromium 和 puppeteer 或 puppeteer-core，Puppeteer 路径需要 Node.js 22.12+。 README 将该项目定位为 Mermaid 和 draw.io 的替代品，指出它接受自然语言输入，包含 AI/Agent 领域模式，内置样式，自动导出高分辨率 PNG，且无需在线工具。它根据 MIT 许可证发布。