fireworks-tech-graph 是一个面向 Codex 和 Claude Code 的 MIT 开源 Agent Skill 与 Python CLI，把中英文系统描述转换成经过几何检查的 SVG、PNG、离线交互 HTML 和特定语义动画 GIF。它内置 12 种样式、14 类 UML 图和用于架构、云、事件流与可观测性图的结构契约。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph 查看 GitHub 仓库 → 📘 使用教程 →它把自然语言画图从单次生成升级为结构化 IR、确定性布局、几何校验、导出和报告链，并在 v1.2.0 为 12 种样式加入可验证的 SVG 到 GIF 动画契约。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph/releases/tag/v1.2.0生成器先校验节点、边、端口和领域字段，再进入布局；重复 ID、悬空引用、非法 waypoint 与非有限坐标会提前失败。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph检查画布、标签、保留区域、边交叉、端口扇出和特定工程样式契约，失败时不继续合成。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graphCLI 可生成 SVG、PNG 和单文件交互 HTML；HTML 在本地提供缩放、主题、复制及多种位图下载。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graphv1.2.0 为 12 个场景定义时间线、方向、阶段、几何和像素探针，输出 motion.json 验证报告。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph/releases/tag/v1.2.0Skill 先把描述映射到样式与领域结构，再由 schemas 和 IR 校验器规范化输入。Python 生成器执行布局、正交路由、端口与标签检查，输出语义 SVG 和 layout report；PNG 由 CairoSVG、rsvg-convert 或浏览器路径渲染。交互导出对 SVG 做清理后打包成单一 HTML。可选动画路径使用 Chromium/Puppeteer 逐帧渲染，FFmpeg 合成，再用 FFprobe、DOM/签名/像素探针和 motion report 验收。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph (1) · github.com/yizhiyanhua-ai/fireworks-tech-graph/blob/v1.2.0/CHANGELOG.md (2)Python 3.9+CairoSVG 或 rsvg-convert 用于 PNGGIF 可选路径需要 FFmpeg/FFprobe、Chrome/Chr…skills CLI 安装路径需要 Node.js适合生成架构评审图、云部署图、事件流、可靠性排查图、UML 和技术文档插图，并用检查报告做版本回归。简单 Markdown 内联关系图用 Mermaid 更轻；需要自由拖拽和人工排版时，draw.io 更合适。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graphv1.2.0 是当前最新稳定 Release，版本日期 2026-07-17。它为 12 种样式加入 115 帧默认语义动画、motion report、DOM 不变性保护、运行探针、FFprobe 检查和 852 次 Chromium 兼容比较；静态工作流不需要动画依赖。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph/releases/tag/v1.2.0status: official_source_checked_not_installed_or_rendered | checked_at: 2026-09-23 | environment: 核对官方 README、package.json、v1.2.0 Release/changelog，并浅克隆 main 检查目录；未运行 skills installer，未安装 CairoSVG/Puppeteer/FFmpeg，未生成图片 | limitations: 未验证安装、依赖解析、任一布局、SVG/PNG/HTML/GIF 输出、几何检查、852 项兼容比较、像素阈值或视觉质量 | observed_output: 最新稳定 Release 为 v1.2.0，版本日期 2026-07-17；package.json 仍为 1.2.0；npm channel 由官方说明停在 1.0.4。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph/releases/tag/v1.2.0 (1) · github.com/yizhiyanhua-ai/fireworks-tech-graph/blob/main/package.json (2)相比 Mermaid，fireworks-tech-graph 从自然语言和结构化 JSON 生成带固定风格、几何检查、导出报告和动画契约的成品图；Mermaid 使用简洁 DSL，原生适合 Markdown、文档站和常见流程/UML 图。要可读 diff、轻量嵌入时选 Mermaid；要 1920px 技术插图、离线交互文件或受检动画时再用 fireworks-tech-graph。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph (1) · github.com/mermaid-js/mermaid (2)需要可重复的高分辨率技术插图和严格导出检查时，这个 Skill 有明确价值。先固定 v1.2.0、从静态 SVG 跑通 fixture，再按需求增加 PNG 或 GIF 依赖；把自动校验当作审图辅助，最终内容和可读性仍由人确认。
来源：github.com/yizhiyanhua-ai/fireworks-tech-graph当前稳定 Release 是 v1.2.0。官方说明 npm registry 仍停在 1.0.4，因此应使用 v1.2.0 Release 归档或固定 tag 下的 nested Skill 路径，并核对 SHA256SUMS。
不需要。静态 SVG 和离线 HTML 使用 Python 工具链；PNG 需要 CairoSVG 或 rsvg-convert。Chromium、Puppeteer、FFmpeg/FFprobe 只用于可选的 GIF 动画路径。
不等于。结构和几何校验能发现悬空引用、越界、交叉等问题，但视觉判断仍需要读图。没有图像读取能力时，工具会报告 visual_review: skipped，不能把它写成已完成视觉复核。
不是。赞助商推广与本地 Skill、Python CLI、CairoSVG、Puppeteer 或 FFmpeg 安装没有技术依赖。