再也不用愁畫架構(gòu)圖了,AI幫你畫
作為技術(shù)人,你一定有過這樣的經(jīng)歷:項目文檔需要一張專業(yè)的架構(gòu)圖,你打開draw.io或Visio,從一個空白畫布開始,拖拽組件、調(diào)整布局、設(shè)置樣式...一張像樣的架構(gòu)圖往往需要耗費數(shù)小時。
畫架構(gòu)圖一直是我最頭疼的事情,不僅公司項目,我做的一些開源項目也需要畫架構(gòu)圖,畫的崩潰時我就想到,現(xiàn)在代碼都可以通過AI從零生成,為什么還要手動繪制架構(gòu)圖?
通過我的實踐發(fā)現(xiàn),Claude在生成draw.io格式的XML架構(gòu)圖方面表現(xiàn)尤為出色——只需描述你的系統(tǒng),它就能生成格式規(guī)范、結(jié)構(gòu)合理的draw.io架構(gòu)圖,導(dǎo)入后即可直接使用或微調(diào),將數(shù)小時的工作壓縮至幾分鐘內(nèi)完成。
今天,我將分享一個基于Claude和draw.io的自動化文檔生成系統(tǒng),它不僅能生成精美的架構(gòu)圖,還能將圖表與說明文本自動整合為專業(yè)Markdown文檔。這套工具將徹底改變技術(shù)文檔的創(chuàng)建方式,從繁瑣的繪圖工作中解放出來。
下面就是我為我的本地知識庫開源項目EasyRAG畫的對接外部文檔生成的架構(gòu)圖。想了解這塊細(xì)節(jié)可以回看我的文章:我開源了一個輕量級知識庫工具:EasyRAG使用分享
drawio命令行下載
一般畫圖我喜歡用drawio來畫,drawio是一個開源的畫圖工具,他不僅有網(wǎng)頁版的開源代碼,還有命令行版本的開源工具,這就為我們實現(xiàn)自動化畫圖提供了可能性。
訪問官方GitHub倉庫: https://github.com/jgraph/drawio-desktop/releases下載對應(yīng)的機(jī)器版本。
我這里下載的是windows版本的,可以直接下載exe的安裝包,直接安裝后便可使用。
通過下面的命令行就可以看到draw.io支持的命令行能力了。
'C:\Program Files\draw.io\draw.io.exe' --h
如何實現(xiàn)AI畫圖
drawio有個命令行,可以通過xml生成圖片,具體的命令行如下:
command = [
drawio_path,
"--export", # 執(zhí)行導(dǎo)出操作
"--format", "png", # 指定輸出格式為PNG
"--output", output_path, # 指定輸出文件
xml_path # 輸入的XML文件
]
也就是說,我們讓模型根據(jù)我們寫的readme或者其他項目素材,生成對應(yīng)的架構(gòu)圖xml文件,再將這個文件導(dǎo)入到drawio命令行中,即可生成出來相應(yīng)的架構(gòu)圖。
這里面也可以生成可以編輯的drawio格式的文件,如果生成的有問題還可以修改下。
因為雖然大部分情況下claude3.7生成的效果都還行,但是偶爾也會出現(xiàn)線重合等問題,需要手動來調(diào)整下。
整合項目
claude可以生成,那么deepseek可以嗎,因為做成一個公開的項目,可能中國本土模型會更受歡迎,我也做了個測試,其實倒也能生成,只是效果上會差一點。但是畢竟比從零去畫方便很多了。
我的整體思路就和上面這個智能文檔架構(gòu)圖差不多,基于readme等項目描述文章,首先生成xml,基于drawio的命令行工具導(dǎo)出圖片,然后再生成markdown格式的文章,并把架構(gòu)圖放入進(jìn)去,一篇優(yōu)美的技術(shù)文檔就生成了。
寫在最后
2025年的今天,AI創(chuàng)新已經(jīng)噴井,幾乎每天都有新的技術(shù)出現(xiàn)。作為親歷三次AI浪潮的技術(shù)人,我堅信AI不是替代人類,而是讓我們從重復(fù)工作中解放出來,專注于更有創(chuàng)造性的事情,關(guān)注我們公眾號口袋大數(shù)據(jù),一起探索大模型落地的無限可能!