画过技术图的人都知道一个隐藏的痛:AI 画图,画完不算完。
你让模型"帮我画个 RAG 架构图",它劈里啪啦吐出一段 SVG。你满怀期待地打开——节点叠在一起、两根线交叉成麻花、文字挤出了框外。你让它改,它改完又给你一个新的乱法。来回三轮,你放弃了,决定还是手画。
问题不在模型笨,在于没有一道"验收"的闸门。
最近 GitHub 上一个叫 fireworks-tech-graph 的 skill 火了,1.1 万 Star、900 Fork,MIT 协议。它干的正是这件事:让 AI 画完图,先过一道几何监理,验收不合格不许交付。

它把"画图"拆成了流水线,而不是一次生成
大多数画图工具的逻辑是:prompt → 图,一步到位。
fireworks-tech-graph 不是。它走的是 Prompt → 语义中间层(IR) → 正交布线 → SVG 结构校验 → PNG 视觉回读 → 定向修正 → 交付 这条链路。
关键在中段那两道"闸":
- SVG 结构校验:检查 XML 合法性、元素是否闭合、ID 是否唯一、属性是否合法。这是"语法层"的验收。
- PNG 视觉回读:把 SVG 渲染成 PNG,逐像素回读,检查布局是否一致、文字是否可读、有没有截断溢出、颜色对比度够不够。这是"视觉层"的验收。
模型说"我画好了"不算数。校验器说"过"才算数。 默认最多两轮视觉修正,validation 和 visual_review 的状态都会写进交付报告。
这跟"画完就交"的差别,就像施工队"砌完墙"和"监理验收过"的差别。
几何预算:不是"好看",是可量化的硬指标
很多 AI 画图工具说"我会保证布局美观"——但"美观"是主观的,模型没法自检。
fireworks-tech-graph 把美观翻译成了可执行的硬约束:
- 零交叉:连线不允许互相穿过
- 零桥接:线不跨线
- 每条边最多两个折点:整体最多八个弯折
- 节点间距至少 40px:容器留白至少 20px
这些是"预算"——不达标就不算交付。所以它产出的图天然适合进 Figma、幻灯片、技术文档,因为几何是干净的,不是"看起来还行但一放大就乱"。

12 种风格 + 14 种 UML,中文一句话就能触发
它内置了 12 种视觉风格,11 种走生成器,第 8 种 Dark Luxury 是 AI 手绘风。Flat Icon、Dark Terminal、Blueprint、Notion Clean、Glassmorphism、Claude Official、OpenAI Official 全覆盖。
更实用的是第 9 到第 12 种风格——它们绑定了四套工程语义契约:C4 评审、云部署、事件流、可靠性排查。做 ADR 或 SRE 复盘,可以直接套场景,不用从零描述形状规范。
图类型方面,14 种标准 UML 全支持:类图、组件图、部署图、序列图、状态机、ER 图……另外内置了 RAG、Agentic Search、Mem0、Multi-Agent、Tool Call 这些 AI/Agent 场景模板。
对中文用户友好的是:说"画架构图""生成时序图""帮我出图"这类中英文短语都会触发。

不止 SVG:还能出 GIF 和离线 HTML
SVG 之外,它还能做两件加分的事:
- SVG 转 GIF:默认 960px 宽、5.75 秒、20fps、115 帧。连接线按语义顺序绘制,结构画完还会留两秒"数据流动效"——适合放进演示稿里展示数据流向。
- 离线 HTML 导出:带平移缩放、明暗主题,能复制 SVG 源码,最高 4 倍分辨率下载 PNG 或 WebP。不开浏览器也能交互查看。
代价清醒:它不是万能的
说点不好听的。
第一,它是"skill",不是独立软件。 它跑在 Codex 或 Claude Code 里,你得先装好 Agent 环境。对只想"在线画张图"的人来说,这门槛不低——它服务的是已经在用 AI 编程工具的那批人。
第二,GIF 导出有额外依赖。 电脑上要装 FFmpeg、Chrome 和 puppeteer-core,还得 pip install cairosvg。装齐了才能触发动画路径。
第三,它跟 diagram-design 是两条路线。 如果你要的是"可编辑的 HTML、39 种图形、draw.io 重绘",diagram-design 更合适;如果你要"SVG 可编辑、几何门禁、UML 全支持、动图导出",那 fireworks-tech-graph 是唯一选择。两个都留着也不冲突——按场景选。
第四,别神化"几何校验"。 它保证的是"几何干净",不是"逻辑正确"。图里画的架构合不合理、依赖方向对不对,还是得你自己把关。校验器是施工监理,不是设计总监。
一句话判断
如果你已经在用 Codex / Claude Code,且经常要画架构图、时序图、做工程评审——这个 skill 值得装。它把"AI 画图"从"碰运气"变成了"有验收的交付"。
安装走嵌套路径(否则 Agent 可能只装到根目录的 SKILL.md):
npx -y skills@1.5.17 add yizhiyanhua-ai/fireworks-tech-graph/skills/fireworks-tech-graph --agent codex claude-code -g -y --copy
装完重启一下 Agent 工具。之后一句"帮我画一个 RAG 流水线,Dark 风格",剩下的交给它和那道几何监理。
相关链接:
暂无评论。