fireworks-tech-graph 是什么?

fireworks-tech-graph 是一个 Claude Code 技能,把自然语言描述转成生产级的 SVG 技术图,并导出高分辨率 PNG。它内置 7 种视觉风格(扁平图标/暗黑极客/工程蓝图/Notion 极简/玻璃态/Claude 官方风/OpenAI 官方风),完整支持 14 种 UML 图类型,并对 AI/Agent 领域常见图(RAG、Agentic Search、Mem0、Multi-Agent、Tool Call 流程等)有内建知识与开箱模式。它用语义化的形状词汇(LLM=双边框圆角矩形、Agent=六边形、Vector Store=带内环圆柱)和语义箭头系统让生成的图既好看又表意准确。Python 脚本 + SVG 模板,MIT。

⭐ 6,621 Stars 🍴 587 Forks Python MIT 作者: yizhiyanhua-ai
来源:README.zh.md 概述/功能特性;GitHub desc,license MIT 查看 GitHub 仓库 →

为什么值得关注

约 7k 星,热度来自一个高频痛点:写技术文章/做架构讲解时画图费时,而 mermaid 之类又不够好看、AI 直接画 SVG 又常出错乱。fireworks-tech-graph 把『自然语言→精美且表意准确的技术图』做成 Claude Code 技能,还专门内建了 AI/Agent 领域图谱(RAG/Mem0/Multi-Agent 等)和 7 套含官方品牌风的风格,正好命中 AI 内容创作者的需求。

来源:GitHub 7,000 stars / 617 forks,created 2026-04-10;README 概述

核心功能

7 种可执行视觉风格

扁平图标(默认)、暗黑极客、工程蓝图、Notion 极简、玻璃态卡片、Claude 官方风、OpenAI 官方风;风格约束不只写在文档里,也真正进入生成器逻辑(references/style-1~7 + style-diagram-matrix),并有风格选择指南。

来源:README 7 种风格/功能特性;references/style-*.md
14 种 UML + AI/Agent 领域图

完整支持 14 种 UML 图(类/组件/部署/包/复合结构/对象/用例/活动/状态机/序列/通信/时序/交互概览/ER),并内建架构图、数据流、流程图、Agent 架构(五层:输入/Agent/记忆/工具/输出)、记忆架构(Mem0/MemGPT 风)、对比矩阵、思维导图等。

来源:README 支持的图类型/UML(14 种表)
语义化形状与箭头系统

用统一的形状词汇表(LLM=双边框圆角矩形、Agent=六边形、Vector Store=带内环圆柱等)和语义箭头(颜色+虚线编码写入/读取/异步/循环),让图不仅美观还能准确表达技术语义;并自动加泳道分层标签。

来源:README 功能特性(语义形状/箭头/泳道)
AI/Agent 领域内建 Pattern

RAG Pipeline、Agentic RAG、Mem0、Multi-Agent、Tool Call 等常见模式开箱即用——直接描述场景即可生成对应结构图,省去从零摆元件。

来源:README AI/Agent 领域内建 Pattern;templates/agent-architecture.svg
SVG+PNG 双输出、渲染器友好

输出可编辑 SVG 与 1920px PNG(cairosvg 推荐,rsvg-convert/puppeteer 备选);纯内联 SVG、不依赖外部字体,在 cairosvg/rsvg/headless Chrome 下都稳定渲染;自带 40+ 产品品牌色图标(OpenAI/Anthropic/Pinecone/Kafka/PostgreSQL 等)。

来源:README 功能特性(双输出/渲染器友好/图标库)/安装依赖

技术架构

一个 Claude Code 技能包,核心是『SKILL 指令 + 参考规则 + 模板 + 脚本』。SKILL.md 是技能入口;references/ 是知识库——7 个风格定义文件(style-1~7)、style-diagram-matrix(风格×图类型矩阵)、icons(40+ 产品图标/品牌色)、svg-layout-best-practices(布局规则);templates/ 是各图类型的 SVG 模板(architecture、agent-architecture、data-flow、flowchart、sequence、state-machine、er-diagram、comparison-matrix);scripts/ 是 Python/Shell 工具(generate-from-template.py 据模板生成、generate-diagram.sh、validate-svg.sh 校验、test-all-styles.sh 测全风格)。agent 读取风格与图类型规则、套用语义形状/箭头词汇,产出纯内联 SVG,再经 cairosvg/rsvg/puppeteer 导 PNG。整体是把『怎么画准、画美一张技术图』的工程经验编码成 agent 可遵循、可校验的技能,自身不含渲染引擎、复用现成 SVG→PNG 工具。

来源:tree(SKILL.md、references/*、templates/*.svg、scripts/*);README 概述/安装依赖

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) cairosvg(SVG→PNG,推荐)cairosvg(SVG… rsvg-convert / puppeteer(备选渲染)rsvg-convert /… 纯内联 SVG(无外部字体)纯内联 SVG(无… Python 模板生成器Python 模板生成… 7 种可执行视觉风格 14 种 UML + AI/Agent 领域图14 种 UML + AI/Agen… 语义化形状与箭头系统 AI/Agent 领域内建 PatternAI/Agent 领域内建 Pa… SVG+PNG 双输出、渲染器友好SVG+PNG 双输出、渲染… fireworks-tech-graph 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Python + Shell(脚本)+ SVG/Markdown(模板与规则)框架Claude Code 技能
cairosvg(SVG→PNG,推荐)rsvg-convert / puppeteer(备选渲染)纯内联 SVG(无外部字体)Python 模板生成器
本地运行的 Claude Code 技能;需装一个 SVG→PNG 渲染器;无独立服务
来源:README 安装/安装依赖;tree(scripts/*.py/.sh)

快速上手

作为 Claude Code 技能安装(README 给出安装与更新方式)。安装一个 SVG→PNG 渲染器:推荐 cairosvg(CSS 支持最好),备选 rsvg-convert(系统包)或 puppeteer(真实 Chromium、最高保真)。用法:用触发词或自然语言让 Claude 画图,如『画一张 Mem0 的架构图,暗黑风格』,可指定风格(1-7)和输出路径,技能会识别图类型与风格、生成含泳道/语义形状/箭头的 SVG 并导出 1920px PNG。也可用 scripts/generate-from-template.py 基于模板生成、validate-svg.sh 校验。
来源:README 安装/安装依赖/使用方式

使用场景

适合:①写技术博客/文档/分享、需要快速产出好看又准确的架构图、流程图、时序图的工程师与 AI 内容创作者;②尤其是讲 AI/Agent 系统(RAG、Mem0、Multi-Agent、Tool Call)的人,可直接描述场景出图;③需要 14 种 UML 图、又想要统一品牌风格(Claude/OpenAI 风)的团队。不适合:不使用 Claude Code 的人;以及需要交互式图编辑器或对像素级排版有极高定制要求、不接受生成式产物需微调的场景。

来源:README 概述/场景示例集,结合定位推断

优势与局限

优势

  • 切口实用:把『自然语言→生产级技术图』做成技能,省去手摆元件,输出 SVG 可编辑 + PNG 可直接嵌文
  • 表意准确:语义形状词汇 + 语义箭头 + 泳道,让图不只是好看,还能正确表达技术语义
  • AI/Agent 领域知识内建:RAG/Mem0/Multi-Agent 等模式开箱即用,对 AI 内容创作者特别对口
  • 风格系统是可执行的(进生成器逻辑而非只写文档),7 种风格含官方品牌风,且有 40+ 产品图标
  • 渲染器友好、纯内联 SVG 无外部字体依赖,跨 cairosvg/rsvg/Chrome 稳定,附校验脚本

局限

  • 依赖 Claude Code 技能环境与一个 SVG→PNG 渲染器,非该生态用户用不了
  • 生成质量受模型影响,复杂或非常规图仍可能需要人工微调 SVG
  • 本质是把绘图经验编码给 agent 的技能,不含独立渲染/编辑引擎,能力上限受模型与模板覆盖度限制
  • 强结构化也意味着对模板/风格之外的高度自定义图支持有限
  • 更新偏停滞(最近 push 2026-05-13),随风格/图类型需求持续扩充才保持新鲜
来源:README 功能特性/安装依赖;tree;技能性质推断

最新版本

仓库以 Claude Code 技能形式维护,无正式 GitHub Release,最近一次更新在 2026-05-13(创建于 2026-04-10)。风格与图类型支持随需求扩充,使用前装好 cairosvg 等渲染器即可。

来源:GitHub 无 releases;pushed_at 2026-05-13;created 2026-04-10

总结评价

fireworks-tech-graph 解决的是技术写作里很烦人的一环:画一张既好看又表意准确的架构/流程/时序图。它的聪明在于把『怎么画准画美』编码成可执行的风格系统 + 语义形状/箭头词汇 + 14 种 UML 和 AI/Agent 领域模板,让 Claude 一句话出图、SVG 可编辑 PNG 可嵌文,对讲 AI/Agent 系统的内容创作者尤其对口,7k 星说明这刚需很真。它的边界也清楚:依赖 Claude Code 与渲染器、生成物复杂时需微调、高度自定义图支持有限。对在用 Claude Code、又常画技术图的人,这是目前把 agent 用于出图最专业的技能之一。

来源:综合 README 定位/功能、tree(技能结构)、依赖与更新状态的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 21:26. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件