作為技術(shù)人，你一定有過這樣的經(jīng)歷：項(xiàng)目文檔需要一張專業(yè)的架構(gòu)圖，你打開draw.io或Visio，從一個(gè)空白畫布開始，拖拽組件、調(diào)整布局、設(shè)置樣式...一張像樣的架構(gòu)圖往往需要耗費(fèi)數(shù)小時(shí)。

畫架構(gòu)圖一直是我最頭疼的事情，不僅公司項(xiàng)目，我做的一些開源項(xiàng)目也需要畫架構(gòu)圖，畫的崩潰時(shí)我就想到，現(xiàn)在代碼都可以通過AI從零生成，為什么還要手動(dòng)繪制架構(gòu)圖？

通過我的實(shí)踐發(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ù)小時(shí)的工作壓縮至幾分鐘內(nèi)完成。

今天，我將分享一個(gè)基于Claude和draw.io的自動(dòng)化文檔生成系統(tǒng)，它不僅能生成精美的架構(gòu)圖，還能將圖表與說明文本自動(dòng)整合為專業(yè)Markdown文檔。這套工具將徹底改變技術(shù)文檔的創(chuàng)建方式，從繁瑣的繪圖工作中解放出來。

下面就是我為我的本地知識(shí)庫(kù)開源項(xiàng)目EasyRAG畫的對(duì)接外部文檔生成的架構(gòu)圖。想了解這塊細(xì)節(jié)可以回看我的文章：我開源了一個(gè)輕量級(jí)知識(shí)庫(kù)工具：EasyRAG使用分享

drawio命令行下載

一般畫圖我喜歡用drawio來畫，drawio是一個(gè)開源的畫圖工具，他不僅有網(wǎng)頁(yè)版的開源代碼，還有命令行版本的開源工具，這就為我們實(shí)現(xiàn)自動(dòng)化畫圖提供了可能性。

訪問官方GitHub倉(cāng)庫(kù): https://github.com/jgraph/drawio-desktop/releases下載對(duì)應(yīng)的機(jī)器版本。

我這里下載的是windows版本的，可以直接下載exe的安裝包，直接安裝后便可使用。

通過下面的命令行就可以看到draw.io支持的命令行能力了。

'C:\Program Files\draw.io\draw.io.exe' --h

如何實(shí)現(xiàn)AI畫圖

drawio有個(gè)命令行，可以通過xml生成圖片，具體的命令行如下：

command = [
        drawio_path,
        "--export",         # 執(zhí)行導(dǎo)出操作
        "--format", "png",  # 指定輸出格式為PNG
        "--output", output_path,  # 指定輸出文件
        xml_path            # 輸入的XML文件
    ]

也就是說，我們讓模型根據(jù)我們寫的readme或者其他項(xiàng)目素材，生成對(duì)應(yīng)的架構(gòu)圖xml文件，再將這個(gè)文件導(dǎo)入到drawio命令行中，即可生成出來相應(yīng)的架構(gòu)圖。

這里面也可以生成可以編輯的drawio格式的文件，如果生成的有問題還可以修改下。

因?yàn)殡m然大部分情況下claude3.7生成的效果都還行，但是偶爾也會(huì)出現(xiàn)線重合等問題，需要手動(dòng)來調(diào)整下。

整合項(xiàng)目

claude可以生成，那么deepseek可以嗎，因?yàn)樽龀梢粋€(gè)公開的項(xiàng)目，可能中國(guó)本土模型會(huì)更受歡迎，我也做了個(gè)測(cè)試，其實(shí)倒也能生成，只是效果上會(huì)差一點(diǎn)。但是畢竟比從零去畫方便很多了。

我的整體思路就和上面這個(gè)智能文檔架構(gòu)圖差不多，基于readme等項(xiàng)目描述文章，首先生成xml，基于drawio的命令行工具導(dǎo)出圖片，然后再生成markdown格式的文章，并把架構(gòu)圖放入進(jìn)去，一篇優(yōu)美的技術(shù)文檔就生成了。

寫在最后

2025年的今天，AI創(chuàng)新已經(jīng)噴井，幾乎每天都有新的技術(shù)出現(xiàn)。作為親歷三次AI浪潮的技術(shù)人，我堅(jiān)信AI不是替代人類，而是讓我們從重復(fù)工作中解放出來，專注于更有創(chuàng)造性的事情，關(guān)注我們公眾號(hào)口袋大數(shù)據(jù)，一起探索大模型落地的無限可能！