152 lines
4.6 KiB
Markdown
Executable File
152 lines
4.6 KiB
Markdown
Executable File
# fireworks-tech-graph 技术图生成工具
|
||
|
||
> **Stop drawing diagrams by hand.** 描述你的系统 → 获取出版级 SVG + PNG 技术图
|
||
|
||
- **⭐ GitHub**: yizhiyanhua-ai/fireworks-tech-graph (3987 stars)
|
||
- **语言**: Python
|
||
- **许可证**: MIT
|
||
|
||
---
|
||
|
||
## 核心能力
|
||
|
||
将自然语言描述转化为精美 SVG 图表，再导出高分辨率 PNG（1920px）。
|
||
|
||
```bash
|
||
npx skills add yizhiyanhua-ai/fireworks-tech-graph
|
||
```
|
||
|
||
### 使用示例
|
||
|
||
```
|
||
用户: "Generate a Mem0 memory architecture diagram, dark style"
|
||
→ Skill 分类: Memory Architecture Diagram, Style 2
|
||
→ 生成带泳道、圆柱体、语义箭头的 SVG
|
||
→ 导出 1920px PNG
|
||
→ 输出: mem0-architecture.svg / mem0-architecture.png
|
||
```
|
||
|
||
---
|
||
|
||
## 7 种视觉风格
|
||
|
||
| 风格 | 描述 | 适用场景 |
|
||
|------|------|----------|
|
||
| **Style 1** — Flat Icon | 白色背景，语义箭头 | 产品文档 |
|
||
| **Style 2** — Dark Terminal | 黑色背景，霓虹强调色 | 技术博客 |
|
||
| **Style 3** — Blueprint | 深蓝背景，网格线，青色描边 | 工程架构图 |
|
||
| **Style 4** — Notion Clean | 极简白色，单一强调色 | Notion 风格 |
|
||
| **Style 5** — Glassmorphism | 深色渐变背景，毛玻璃卡片 | 现代 UI |
|
||
| **Style 6** — Claude Official | 暖米色背景 (#f8f6f3) | Anthropic 风格 |
|
||
| **Style 7** — OpenAI Official | 纯白背景，OpenAI 品牌色 | OpenAI 风格 |
|
||
|
||
---
|
||
|
||
## 14 种图表类型
|
||
|
||
### UML 图表（完整支持）
|
||
- Class Diagram（类图）
|
||
- Component Diagram（组件图）
|
||
- Deployment Diagram（部署图）
|
||
- Package Diagram（包图）
|
||
- Composite Structure Diagram（组合结构图）
|
||
- Object Diagram（对象图）
|
||
- Use Case Diagram（用例图）
|
||
- Activity Diagram（活动图）
|
||
- State Machine Diagram（状态机图）
|
||
- Sequence Diagram（时序图）
|
||
- Communication Diagram（通信图）
|
||
- Timing Diagram（时序图）
|
||
- Interaction Overview Diagram（交互概述图）
|
||
- ER Diagram（ER 图）
|
||
|
||
### AI/Agent 领域图表
|
||
- RAG 流程图
|
||
- Agentic Search 架构图
|
||
- Mem0 记忆架构图
|
||
- Multi-Agent 协作图
|
||
- Tool Call 流程图
|
||
|
||
---
|
||
|
||
## 语义图形词汇
|
||
|
||
| 元素 | 形状 |
|
||
|------|------|
|
||
| LLM | 双边框矩形 |
|
||
| Agent | 六边形 |
|
||
| Vector Store | 环形圆柱体 |
|
||
| Database | 圆柱体 |
|
||
| Service | 圆角矩形 |
|
||
| User | 人物图标 |
|
||
|
||
### 语义箭头系统
|
||
- **实线箭头** = 读操作
|
||
- **虚线箭头** = 写操作
|
||
- **异步箭头** = 后台流程
|
||
- **循环箭头** = 循环调用
|
||
|
||
---
|
||
|
||
## 安装与使用
|
||
|
||
```bash
|
||
# 安装
|
||
npx skills add yizhiyanhua-ai/fireworks-tech-graph
|
||
|
||
# 更新
|
||
npx skills update fireworks-tech-graph
|
||
```
|
||
|
||
---
|
||
|
||
## 提示词模板
|
||
|
||
### Style 1 — Flat Icon
|
||
```
|
||
Draw a Mem0 memory architecture diagram in style 1 (Flat Icon).
|
||
Use four horizontal sections: Input Layer, Memory Manager, Storage Layer, Output / Retrieval.
|
||
Include User, AI App / Agent, LLM, mem0 Client, Memory Manager, Vector Store, Graph DB, Key-Value Store, History Store, Context Builder, Ranked Results, Personalized Response.
|
||
Use semantic arrows for read, write, control, and data flow. Keep the layout clean and product-doc friendly.
|
||
```
|
||
|
||
### Style 2 — Dark Terminal
|
||
```
|
||
Draw a tool call flow diagram in style 2 (Dark Terminal).
|
||
Show User query, Retrieve chunks, Generate answer, Knowledge base, Agent, Terminal, Source documents, and Grounded answer.
|
||
Use terminal chrome, neon accents, monospace typography, and semantic arrows for retrieval, synthesis, and embedding update.
|
||
```
|
||
|
||
### Style 3 — Blueprint
|
||
```
|
||
Draw a microservices architecture diagram in style 3 (Blueprint).
|
||
Create numbered engineering sections like 01 // EDGE, 02 // APPLICATION SERVICES, 03 // DATA + EVENT INFRA, 04 // OBSERVABILITY.
|
||
Include Client Apps, API Gateway, Auth / Policy, three services, Event Router, Postgres, Redis Cache, Warehouse, and Metrics / Traces.
|
||
Use blueprint grid, cyan strokes, and a bottom-right title block.
|
||
```
|
||
|
||
---
|
||
|
||
## 特点
|
||
|
||
- **7 种视觉风格** — 从简洁白底到霓虹黑到毛玻璃
|
||
- **可执行风格系统** — 风格编码到生成器中，不仅在文档中
|
||
- **完整 UML 支持** — 14 种图表类型
|
||
- **AI/Agent 领域模式** — RAG、Mem0、Multi-Agent 等内置
|
||
- **语义图形词汇** — LLM = 双边框矩形，Agent = 六边形
|
||
- **语义箭头系统** — 颜色 + 线型编码含义
|
||
- **产品图标** — 40+ 产品的品牌色：OpenAI、Anthropic、Pinecone、Weaviate、Kafka、PostgreSQL…
|
||
- **SVG + PNG 输出** — SVG 可编辑，1920px PNG 可嵌入
|
||
- **rsvg-convert 兼容** — 无外部字体获取，纯内联 SVG
|
||
|
||
---
|
||
|
||
## 适用场景
|
||
|
||
- 系统架构文档
|
||
- 技术博客配图
|
||
- API 文档说明
|
||
- AI/Agent 流程图
|
||
- UML 建模
|
||
- 产品演示材料
|