DeepDiagram 零基础上手实战:如何用一句话生成专业思维导图、业务流程图和系统架构图
DeepDiagram 零基础上手实战:如何用一句话生成专业思维导图、业务流程图和系统架构图
DeepDiagram 是一款开源的 AI 可视化工具(AI 画图工具),它能把一句自然语言自动变成专业思维导图、业务流程图、系统架构图和 ECharts 图表。这篇文章面向零基础用户,带你从部署到实操,用最短时间体验"一句话出图"的完整流程。
一、DeepDiagram 是什么?为什么推荐?
一句话概括:你打字,它画图。
DeepDiagram 采用"多智能体"架构(LangGraph 编排),内置 6 个专职画图智能体,你说出需求后,系统会自动判断该派谁上场:
| 智能体 | 适合画什么 | 底层技术 |
|---|---|---|
| 🧠 MindMap | 思维导图、知识梳理、头脑风暴 | Mind-elixir |
| 🔀 Flowchart | 业务流程图、审批流、逻辑判断 | React Flow |
| ✏️ Draw.io | 系统架构图、云基础设施、网络拓扑 | Draw.io |
| 🧜 Mermaid | 时序图、甘特图、时间线、ER 图 | Mermaid.js |
| 📊 Charts | 柱状图、折线图、饼图等数据图表 | ECharts 6.0 |
| 🎨 Infographic | 信息图、数据海报、视觉摘要 | AntV Infographic |
智能体的自动选择逻辑就在 dispatcher.py 中实现:既支持 @mindmap 这类显式指定,也支持由大模型自动识别意图,新手完全不用记命令。
下面是它的实际效果预览,可以看到 AI 从接收指令到实时渲染出完整图表的全过程:
二、快速部署:一条命令启动 DeepDiagram
1. 前置条件
- 已安装 Docker 和 Docker Compose(推荐方式,最省心)
- 一个 LLM API Key(OpenAI、DeepSeek 或其他兼容 OpenAI 格式的服务商均可)
2. 克隆项目
git clone https://gitcode.com/gh_mirrors/de/DeepDiagram
cd DeepDiagram
3. 配置 API Key
在项目根目录创建 .env 文件,填入模型配置:
# 方式 1:OpenAI
OPENAI_API_KEY=sk-你的密钥
OPENAI_BASE_URL=https://api.openai.com
MODEL_ID=gpt-4o
# 方式 2:DeepSeek(性价比高,推荐)
# DEEPSEEK_API_KEY=sk-你的密钥
# DEEPSEEK_BASE_URL=https://api.deepseek.com
# MODEL_ID=deepseek-chat
4. 启动并访问
docker compose up -d
一条命令会同时拉起三个服务:
| 服务 | 端口 | 说明 |
|---|---|---|
| frontend | 80 | React 前端界面 |
| backend | 8000 | FastAPI 后端 API |
| db | 5432 | PostgreSQL 数据库 |
打开浏览器访问 http://localhost,看到聊天界面就部署成功了。若界面右上角"设置"里还没选模型,点击设置图标填写 Base URL、Model ID、API Key 即可(支持随时切换模型)。
💡 完整部署细节可参考官方文档:getting-started.mdx
三、实战一:一句话生成专业思维导图
在输入框直接输入:
@mindmap 秦国的历史,做一个思维导图
几秒后,左侧画布就会渲染出一棵 4~5 层深度的结构化思维导图,覆盖"重要历史事件"等 8 个主要板块,每个节点还标注了时间和关键人物。右侧的 Process Trace(执行追踪面板)会展示 AI 的设计思路和调用过程,生成结果还可以直接追问修改,比如"补充工业革命分支"。
新手提示:思维导图适合知识梳理、读书笔记、课程大纲整理,是入门 DeepDiagram 最容易出效果的场景。
四、实战二:画出业务流程图
输入一句带业务描述的话即可,例如:
@flow 画一个登录流程
DeepDiagram 会自动完成节点拆分、判断分支和自动排版,生成包含"验证 → 判断 → 成功/失败分支 → 结束"完整逻辑的流程图。每个节点都可以在画布上拖拽调整位置,还能继续对话追加功能,比如"加一个验证码节点"。
适用场景:审批流程、用户注册/下单流程、系统交互逻辑、SOP 标准作业程序。
五、实战三:生成系统架构图
架构图是新手最容易画不好的类型,而 DeepDiagram 的 Draw.io 智能体专门擅长这件事。输入:
@drawio 画一个电商系统架构图
它会自动按分层输出专业蓝图:客户渠道层(Web/App/小程序)、网关层(负载均衡、认证鉴权、限流熔断)、微服务业务层(订单、支付、物流等 14 个核心服务)、数据层(MySQL、Redis、ES)以及支撑系统(Prometheus、ELK 等),颜色分区清晰,达到可直接放进技术方案文档的水准。
适用场景:云基础设施规划、微服务架构设计、网络拓扑、技术评审材料。
六、进阶玩法:时间线、数据图表与文档上传
用 Mermaid 画时间线和时序图
@mermaid 用 timeline 复盘宁德时代 2015-2022 的关键事件
用 ECharts 生成数据图表
@charts 帮我画一个柱状图,数据:Q1: 120, Q2: 200, Q3: 150, Q4: 300
也可以直接上传一张图表截图,让 AI 按原样复现,数据可视化、趋势分析、季度报表都能胜任。
上传文档,自动变图表
DeepDiagram 支持上传 PDF、DOCX、XLSX、PPTX、TXT、MD 文件,AI 会自动解析内容并提取关键实体、时间线和关系。比如上传一份年报 Excel,直接说"把它做成趋势图",省去手动整理数据的环节。文档解析逻辑位于 file_service.py。
不满意的图?一键重试
每条 AI 回复旁有重试图标,点击即可生成另一个版本,并通过左右箭头在不同版本间切换(类似 Git 分支)。会话历史也会自动保存,随时可以恢复上次的画布状态。
七、实用路径速查
| 内容 | 路径 |
|---|---|
| 快速开始文档 | getting-started.mdx |
| 部署文档 | deployment.mdx |
| 智能体路由源码 | dispatcher.py |
| 各智能体提示词 | backend/app/agents/ |
| 前端画布渲染 | CanvasPanel.tsx |
| Docker 编排配置 | docker-compose.yml |
结语
回顾一下完整路径:装好 Docker → 配置 API Key → docker compose up -d → 输入一句话 → 得到专业图表。全程不需要会写代码,也不需要懂任何画图软件。DeepDiagram 把"表达想法"和"产出专业图表"之间的距离,压缩到了一次击键。建议先从一个思维导图开始试起,感受最直观,之后逐步解锁流程图、架构图和数据图表。





