作为技术人,你一定有过这样的经历:项目文档需要一张专业的架构图,你打开draw.io或Visio,从一个空白画布开始,拖拽组件、调整布局、设置样式...一张像样的架构图往往需要耗费数小时。
画架构图一直是我最头疼的事情,不仅公司项目,我做的一些开源项目也需要画架构图,画的崩溃时我就想到,现在代码都可以通过AI从零生成,为什么还要手动绘制架构图?
通过我的实践发现,Claude在生成draw.io格式的XML架构图方面表现尤为出色——只需描述你的系统,它就能生成格式规范、结构合理的draw.io架构图,导入后即可直接使用或微调,将数小时的工作压缩至几分钟内完成。
今天,我将分享一个基于Claude和draw.io的自动化文档生成系统,它不仅能生成精美的架构图,还能将图表与说明文本自动整合为专业Markdown文档。这套工具将彻底改变技术文档的创建方式,从繁琐的绘图工作中解放出来。
下面就是我为我的本地知识库开源项目EasyRAG画的对接外部文档生成的架构图。想了解这块细节可以回看我的文章:我开源了一个轻量级知识库工具:EasyRAG使用分享
drawio命令行下载
一般画图我喜欢用drawio来画,drawio是一个开源的画图工具,他不仅有网页版的开源代码,还有命令行版本的开源工具,这就为我们实现自动化画图提供了可能性。
访问官方GitHub仓库: https://github.com/jgraph/drawio-desktop/releases下载对应的机器版本。
我这里下载的是windows版本的,可以直接下载exe的安装包,直接安装后便可使用。
通过下面的命令行就可以看到draw.io支持的命令行能力了。
复制'C:\Program Files\draw.io\draw.io.exe' --h
如何实现AI画图
drawio有个命令行,可以通过xml生成图片,具体的命令行如下:
复制command = [ drawio_path, "--export", # 执行导出操作 "--format", "png", # 指定输出格式为PNG "--output", output_path, # 指定输出文件 xml_path # 输入的XML文件 ]
也就是说,我们让模型根据我们写的readme或者其他项目素材,生成对应的架构图xml文件,再将这个文件导入到drawio命令行中,即可生成出来相应的架构图。
这里面也可以生成可以编辑的drawio格式的文件,如果生成的有问题还可以修改下。
因为虽然大部分情况下claude3.7生成的效果都还行,但是偶尔也会出现线重合等问题,需要手动来调整下。
整合项目
claude可以生成,那么deepseek可以吗,因为做成一个公开的项目,可能中国本土模型会更受欢迎,我也做了个测试,其实倒也能生成,只是效果上会差一点。但是毕竟比从零去画方便很多了。
我的整体思路就和上面这个智能文档架构图差不多,基于readme等项目描述文章,首先生成xml,基于drawio的命令行工具导出图片,然后再生成markdown格式的文章,并把架构图放入进去,一篇优美的技术文档就生成了。
写在最后
2025年的今天,AI创新已经喷井,几乎每天都有新的技术出现。作为亲历三次AI浪潮的技术人,我坚信AI不是替代人类,而是让我们从重复工作中解放出来,专注于更有创造性的事情,关注我们公众号口袋大数据,一起探索大模型落地的无限可能!