当前位置：首页 > news >正文

使用Typora+Nunchaku-flux-1-dev创建技术文档：自动生成示意图工作流

news 2026/9/1 19:07:55

使用Typora+Nunchaku-flux-1-dev创建技术文档：自动生成示意图工作流

1. 场景痛点：技术文档中的图形难题

写技术文档最头疼的是什么？很多人会说是画图。架构图、流程图、示意图，每张图都要耗费大量时间。用Visio画吧，太笨重；用在线工具吧，担心数据安全；手绘吧，又不专业。更麻烦的是，文档改个需求，所有图都得重画一遍。

我们团队之前就深有体会。写一份技术方案，三分之二时间花在画图上。后来发现，其实很多图形元素是重复的——同样的架构风格、同样的图标库、同样的配色方案。如果能自动生成这些图形，该多省事。

这就是今天要分享的方案：用Typora这款轻量级Markdown编辑器，配合Nunchaku-flux-1-dev模型，实现技术文档与专业示意图的无缝集成。你只需要写几个标记，图形就自动生成了。

2. 为什么选择Typora+Nunchaku组合

Typora是我用过最舒服的Markdown编辑器。它干净简洁，实时预览，写技术文档特别顺手。而Nunchaku-flux-1-dev是个多模态模型，特别擅长理解文本描述并生成对应的图形。

这两个工具搭配起来很有意思：Typora负责处理文本内容，Nunchaku负责图形生成。你不需要在两个软件间来回切换，所有工作都在一个界面里完成。

比如你要画一个微服务架构图，传统做法是：先打开画图工具→拖拽各种图标→调整位置→添加文字→导出图片→插入文档。现在只需要在Typora里写一段描述："生成一个微服务架构图，包含API网关、认证服务、用户服务、订单服务，用蓝色系配色"，图形就自动生成了。

3. 环境准备与快速配置

3.1 安装基础工具

首先确保你已经安装了Typora。如果还没装，去官网下载安装包，几分钟就能搞定。

Nunchaku-flux-1-dev的部署也很简单。如果你有GPU环境，推荐用Docker部署：

docker pull nunchaku/flux-1-dev:latest docker run -p 7860:7860 --gpus all nunchaku/flux-1-dev

没有GPU也没关系，CPU版本也能用，只是生成速度稍慢一些：

docker run -p 7860:7860 nunchaku/flux-1-dev:cpu

3.2 配置Typora自定义命令

Typora有个很好用的功能：自定义命令。我们通过这个功能来调用Nunchaku模型。

打开Typora设置，找到"高级设置"→"自定义命令"，添加一个新命令：

命令名称：生成示意图
命令脚本：根据你的系统选择相应的调用脚本

Windows用户可以用PowerShell脚本：

# save as generate_diagram.ps1 $description = $args[0] $output_path = "diagrams/$(Get-Date -Format 'yyyyMMdd_HHmmss').png" # 调用Nunchaku API $response = Invoke-RestMethod -Uri "http://localhost:7860/generate" -Method Post -Body @{ prompt = $description size = "1024x768" } -ContentType "application/json" # 保存图片 [System.IO.File]::WriteAllBytes($output_path, [System.Convert]::FromBase64String($response.image))

Mac/Linux用户可以用Bash脚本：

#!/bin/bash description=$1 output_path="diagrams/$(date +'%Y%m%d_%H%M%S').png" # 调用Nunchaku API response=$(curl -X POST "http://localhost:7860/generate" \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"$description\", \"size\": \"1024x768\"}") # 保存图片 echo $response | jq -r '.image' | base64 -d > $output_path

配置好后，在Typora里选中一段描述文字，右键选择"生成示意图"，对应的图形就会自动生成并插入到文档中。