找回密码
立即注册
搜索
热搜: Java Python Linux Go
发回帖 发新帖

5422

积分

0

好友

754

主题
发表于 3 小时前 | 查看: 2| 回复: 0

技术文档写到最后一步——画架构图,然后情绪断崖。

Mermaid:学语法,写 DSL,调半天对不齐。
draw.io:拖半小时,想换个配色方案,全部推倒重来。
截图粘贴:文档一放大,全是锯齿。最后硬着头皮交出去的图,连自己回头看都觉得丢人。

问题不在工具本身,在于画图这件事的交互方式就是错的——脑子里已经有了清晰的架构,为什么还得手动一个一个拖节点?

画图这件事到底有多烦

写一篇技术博客,正文 30 分钟搞定,配一张架构图 40 分钟起步。画完还不满意,调颜色、对齐、改字号、导出、再调……时间全耗在跟工具较劲上。

更痛的是 风格一致性——公司技术文档十个人十种配色,PPT 一页一个画风。有没有一种方式,我只说“画一个 RAG 流程图,暗色风格”,图就直接出来?

有。今天介绍的开源项目,就是干这件事的。

fireworks-tech-graph:说句话,图就出来了

这是一个 Claude Code Skill ,装好后在 Claude Code 里用自然语言描述你要画的东西,它自动生成:

  • SVG :矢量图,放大不糊,可以用 Figma / Illustrator 继续编辑
  • PNG :1920px 宽,直接扔文档和 PPT

定位很明确:用说话代替拖拽,用 AI 理解意图代替 DSL 语法。

7 种视觉风格一句话切换,14 种 UML 图类型全覆盖,还有一批 AI / Agent 领域的架构模板开箱即用。

7 种视觉风格,不只是换个颜色

每种风格有独立的色板、字体、排版规则和边距系统。不是简单的滤镜切换,而是在设计系统层面做了差异化。

Style 1 — Flat Icon

白底彩色图标,博客文章和幻灯片首选。耐看,不抢文字的风头。

Style 1 Flat Icon — Mem0 内存架构图,白色背景,分层泳道布局,语义箭头清晰可见

Style 2 — Dark Terminal

黑底霓虹色,等宽字体。放 GitHub README 里有种“这系统真在跑”的压迫感。写技术文章配图选这个,逼格直接上一档。

Style 2 Dark Terminal — Tool Call 调用流程图,黑色背景配霓虹色标注,monospace 字体,视觉冲击力强

Style 3 — Blueprint

深蓝底 + 网格线 + 青色描边,工程蓝图感。画微服务部署图、基础设施拓扑特别对味。右下角还有标题栏,像正经出图。

Style 3 Blueprint — 微服务架构图,深蓝底色带网格线,青色边框,右下角带工程标题栏

Style 4 — Notion Clean

极简白底,只有一种强调色。贴进 Notion、Confluence、飞书文档零违和感。内部文档首选。

Style 4 Notion Clean — Agent 记忆类型图,纯白背景,简洁线条,配色克制,适合内部文档

Style 5 — Glassmorphism

暗色渐变底 + 毛玻璃卡片。画多 Agent 协作这类“很多模块并列”的图最合适——每个模块是独立的磨砂卡片,边界清晰还好看。拿去做产品发布会 PPT 不违和。

Style 5 Glassmorphism — 多 Agent 协作图,深色渐变背景,毛玻璃卡片,适合产品展示和演讲 PPT

Style 6 — Claude Official

米白底(#f8f6f3),Anthropic 品牌色系。画 Claude 相关系统架构时风格统一,不会看着像“别人家的图”。

Style 6 Claude Official — 系统架构图,暖米白背景,Anthropic 品牌色,左侧层级标注,风格克制专业

Style 7 — OpenAI Official

纯白底 + 绿色强调箭头。画 GPT API 集成、模型调用链路时用这个,视觉上跟 OpenAI 官方文档保持一致。

Style 7 OpenAI Official — API 集成流程图,纯白背景,绿色箭头,OpenAI 品牌配色,现代简洁

AI 架构图内置模板 + 14 种 UML

AI / Agent 领域:不用从零描述

这是这个项目最有价值的部分。你说“画一个 RAG 流程图”,它不是瞎猜节点——项目里已经把每种 AI 架构的标准结构、节点关系、数据流向都写死了:

内置模板 标准节点结构
RAG Pipeline 查询 → 嵌入 → 向量检索 → 召回 → LLM → 返回
Agentic RAG RAG + Agent 循环 + 工具调用
Agentic Search 规划器 → 并行检索 / 计算 / 代码 → 合成器
Mem0 内存层 输入 → 内存管理器 → 向量库 + 图数据库 → 上下文
Multi-Agent 协调者 → N 个子 Agent → 聚合 → 输出
Tool Call LLM → 工具选择 → 执行 → 解析 → 回 LLM(循环)

UML:14 种图类型全覆盖

类图、组件图、部署图、时序图、活动图、状态机图……标准 UML 该有的都有。

图形语义:不只好看,还能自解释

每种形状有固定含义——圆角双边框代表 LLM,六边形代表 Agent,圆柱体是向量库,菱形是决策节点。实线是主数据流,虚线是写入,弯曲箭头是反馈。图本身就在传递架构信息,不需要旁边再写一段解释文字。

装上就能用

装依赖(SVG 转 PNG):

# macOS
brew install librsvg

# Ubuntu/Debian
sudo apt install librsvg2-bin

安装 Skill:

npx skills add yizhiyanhua-ai/fireworks-tech-graph

然后在 Claude Code 里说:

画一张 Agentic RAG 架构图,Agent 核心层包含 Planner 和 Tool Selector,Memory 层有 VectorDB 和 GraphDB,用 Dark Terminal 风格

Agentic RAG 架构图,用户查询经嵌入后进入 Agent 核心层(Planner、LLM),通过 Tool Selector 调用 Vector Search 和 Web Search,最终输出增强回答

输出两个文件:SVG(继续编辑用)和 1920px PNG(直接放文档)。更新用 --force

npx skills add yizhiyanhua-ai/fireworks-tech-graph --force -g -y

值不值得装

三类人闭眼装

  1. 经常写技术博客的人——以前画图比写文章还久,现在一句话搞定
  2. 做 AI 应用开发的人——RAG、Agent、记忆架构这些图直接出,不用手搭结构
  3. 对图表风格有追求的人——7 种设计系统级风格比自己配色好看十倍

两种情况不需要

  • Markdown 里偶尔插个简单流程图 → Mermaid 够了
  • 需要像素级精确控制每个元素位置 → draw.io 更合适

这不是“替代 draw.io”的工具,是“让 90% 的画图需求不再需要打开 draw.io”的工具。

MIT 协议开源:https://github.com/yizhiyanhua-ai/fireworks-tech-graph




上一篇:AI算力扩张被电力、水和金属卡脖子?美银揭秘67家公司
下一篇:云原生AI需求工程:寿险核心系统可解释决策实战
您需要登录后才可以回帖 登录 | 立即注册

手机版|小黑屋|网站地图|云栈社区 ( 苏ICP备2022046150号-2 )

GMT+8, 2026-4-26 05:26 , Processed in 0.625341 second(s), 41 queries , Gzip On.

Powered by Discuz! X3.5

© 2025-2026 云栈社区.

快速回复 返回顶部 返回列表