fireworks-tech-graph

一句话生成可上生产的架构图与流程图

fireworks-tech-graph 是一个用自然语言生成技术图表的开源工具，输入一句描述就能产出可直接用于生产环境的 SVG 与 PNG 图。它主要解决工程师画架构图、流程图、UML 图时手工拖拽耗时、风格不统一、导出分辨率差的问题。核心能力包括：支持 7 种视觉风格，覆盖 UML 类图/时序图等常见建模需求，并内置 AI/Agent 工作流图模式，适合表达多智能体协作与工具调用链路。生成结果为矢量 SVG，可无损缩放，同时导出 PNG 便于文档与分享。项目用 Python 实现，可脚本化、可集成到 CI 或文档流水线，让图表随代码一起版本化更新，减少手动维护成本。

开源 unknown 设计创意

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 11504

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类设计创意

开发团队yizhiyanhua-ai

所属国家

官网地址https://yizhiyanhua-ai.github.io/fireworks-tech-graph

GitHubhttps://github.com/yizhiyanhua-ai/fireworks-tech-graph

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-workflows,ai,claude-code,developer-tools,diagrams,svg

GitHub 星标★ 11504

30天Star增速

HF 下载量

上线时间2026-04-10 00:00:00

最近更新2026-09-21 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

Node.js 与 npx 可用，用于运行 skills CLI
Python 3，用于运行 fireworks.py 脚本
已安装 Codex 或 Claude Code 之一
可选：PNG/GIF 导出依赖，可用 doctor 检查

安装与启动步骤

1确认运行环境

确保本机已安装 Codex 或 Claude Code，并且 Node.js、npx、python3 命令可用。
2安装完整技能

用官方推荐的 skills CLI 安装到 Codex 和 Claude Code 全局技能目录，必须带末尾路径段。
```
npx -y skills@1.5.17 add yizhiyanhua-ai/fireworks-tech-graph/skills/fireworks-tech-graph --agent codex claude-code -g -y --copy
```
3设置技能根目录

把 SKILL_ROOT 指向安装后的技能目录，例如 Codex 的全局路径，然后运行 version 验证。
```
export SKILL_ROOT=~/.agents/skills/fireworks-tech-graph
python3 "$SKILL_ROOT/scripts/fireworks.py" version
```
4检查可选依赖

运行 doctor 区分 SVG/HTML 基础支持与可选 PNG/GIF 依赖，便于判断能否导出位图。
```
python3 "$SKILL_ROOT/scripts/fireworks.py" doctor
```
5在 Agent 中出图

在 Codex 或 Claude Code 对话中输入自然语言描述，例如生成 RAG 流程图或 Agentic Search 架构图。
6导出 PNG

把已生成的 SVG 导出为指定宽度的 PNG，便于文档分享与版本化。
```
python3 "$SKILL_ROOT/scripts/fireworks.py" export-png diagram.svg diagram.png --width 1920
```

关键配置

配置项	必填	说明	示例
`SKILL_ROOT`	是	指向安装后的技能根目录，用于运行 fireworks.py 脚本	`~/.agents/skills/fireworks-tech-graph`
`text_policy`	否	设为 strict 可在输出写入前拒绝可见文本截断	`strict`
`--agent`	是	安装时指定目标 Agent 运行时，可同时装 Codex 和 Claude Code	`codex claude-code`
`--width`	否	export-png 导出的 PNG 宽度像素值	`1920`

如何确认成功

运行 version 能报告包、Skill root 与 Git 状态；检查 ~/.agents/skills 和 ~/.claude/skills 下技能目录存在。

常见问题

Q：安装后 Agent 找不到技能怎么办？

A：确认安装路径包含 /skills/fireworks-tech-graph 末段，并检查 ~/.agents/skills 与 ~/.claude/skills 目录。

Q：PNG 导出失败怎么办？

A：运行 doctor 检查可选 PNG/GIF 依赖；也可用浏览器 PNG 导出器保证 Chromium 保真。

Q：支持中文描述吗？

A：支持，中文描述会使用可用第二行；可加 "text_policy": "strict" 拒绝可见截断。

Q：如何导出 PNG 图？

A：使用 export-png 命令，指定输入 SVG、输出 PNG 和 --width 宽度值。

Q：为什么必须写完整的嵌套技能路径？

A：裸仓库安装可能只选中根 SKILL.md，带 /skills/fireworks-tech-graph 才能装完整技能。

注意事项

安装命令末段 /skills/fireworks-tech-graph 不能省略，否则可能只装根 SKILL.md。
同时为 Codex 和 Claude Code 安装会创建两份完整副本，包含脚本、模板、测试等。
PNG/GIF 属于可选依赖，doctor 可区分基础 SVG/HTML 支持与位图导出能力。
中文描述使用可用第二行；设 text_policy 为 strict 可在输出前拒绝截断。

核心亮点

自然语言直接出图，省去手工拖拽排版
输出矢量 SVG 加 PNG，缩放不糊、便于嵌入文档
内置 7 种风格与 AI/Agent 工作流、UML 模板，覆盖面广

不足之处

复杂或高度定制的图形仍需人工调整
生成质量依赖描述清晰度，模糊需求易返工

适用场景

写技术方案或 RFC 时快速配架构图
梳理多智能体/工具调用链路并出流程图
把图表生成接入文档或 CI 流水线自动更新

替代项目

Mermaid、PlantUML

项目介绍

fireworks-tech-graph 是设计创意领域的开源项目，由 yizhiyanhua-ai 开发，是 2026 年新上线的项目。

在全站 12,909 个收录项目中，它的 GitHub 星标数（11,504）位列前 5%，在设计创意分类的 161 个项目里位列前 4%。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-21。

它主要面向的使用场景是：写技术方案或RFC时快速配架构图。同类可对比的替代方案包括 Mermaid、PlantUML。

上一篇：Libraries.dev

下一篇：没有了！