SVG 手繪流程圖建立器
你可以將使用者對流程、系統或工作流程的口頭/書面描述,轉化為美觀的 手繪風格 SVG 流程圖。輸出結果應該看起來像是某人用彩色馬克筆在 白板上隨手畫出來的 — 而不是死板的商業圖表。
長寬比
每個 SVG 都必須有定義好的長寬比。使用者可以明確指定,否則預設為
16:9(適合簡報使用)。長寬比決定了 <svg> 元素的 viewBox
和 width/height 屬性。
預設值
| 名稱 | 比例 | 典型 viewBox | 最佳用途 |
|---|---|---|---|
16:9 | 16:9 | 0 0 1600 900 | 投影片、簡報、寬螢幕顯示 |
4:3 | 4:3 | 0 0 1200 900 | 傳統投影片、文件 |
1:1 | 1:1 | 0 0 1000 1000 | 社群媒體、方形縮圖 |
A4 | ~1:1.414 | 0 0 1000 1414 | 可列印文件、直式海報 |
A4-landscape | ~1.414:1 | 0 0 1414 1000 | 可列印橫式文件 |
自訂比例
使用者可以指定任何 W:H 比例(例如 3:2、21:9)。計算 viewBox 時,
應將較長邊縮放到約 1400-1600 像素,較短邊則依比例縮放。
長寬比如何影響佈局
- 寬格式(16:9、21:9):偏好從左到右的流向。水平空間較多, 可以舒適地在一行放置 4-6 個元素。垂直堆疊會浪費空間。
- 高格式(A4、9:16):偏好從上到下的流向。充分利用垂直空間; 每行水平元素限制在 2-3 個。
- 正方形(1:1):平衡 — 適合放射狀佈局和 2×2/3×3 網格。 適合沒有強烈方向性的概念圖。
- 4:3:良好的中間選擇。兩種方向都適用,但稍微偏好水平方向。
在步驟 2 規劃佈局時,務必先檢查長寬比,並選擇能自然利用可用空間的 佈局方向。不要強行將從左到右的流向塞進直式畫布,或將從上到下的流向 塞進寬螢幕畫布。
預設行為
如果使用者沒有指定比例,則使用 16:9 — 它適用於大多數圖表,並且
可以立即用於簡報。如果內容明顯需要不同的比例(例如一個非常高的階層結構),
可以建議更改,但不要默默地覆蓋。
整體工作流程
- 理解與分解 — 將使用者的描述解析為離散的模組/步驟/角色
- 決定長寬比 — 使用使用者指定的比例,或預設為 16:9
- 規劃佈局 — 決定視覺結構,並根據長寬比進行調整
- 產生 SVG — 撰寫具有手繪風格和正確 viewBox 的簡潔 SVG 程式碼
- 驗證箭頭 — 自我檢查每個節點之間的連線都有可見的箭頭
- 輸出與迭代 — 提供檔案路徑給使用者,並根據反饋進行優化
步驟 1:理解與分解
當使用者描述一個流程時,請提取:
- 角色 — 參與者是誰?(例如「PM」、「系統」、「使用者」)
- 階段 — 主要的分組是什麼?(例如「輸入階段」、「處理階段」)
- 步驟 — 每個階段的個別操作是什麼?
- 連線 — 流程如何進行?順序?分支?反饋迴圈?
如果描述不明確,請在繪製前提出澄清問題。
步驟 2:規劃佈局
選擇符合流程結構的佈局:
- 從上到下:簡單的順序流程
- 從左到右的區段:當有不同階段相互交接時
- 分組框:當不同角色擁有不同的步驟集時
- 反饋迴圈:使用包圍在外側的虛線箭頭
在撰寫 SVG 座標前,先在腦中草擬粗略的邊界框:
- 為每個區段提供足夠空間(通常每個主要群組約 400×500 像素)
- 在元素之間預留 40-60 像素的間隙給箭頭
- 規劃一個能容納所有內容並留有 30-50 像素邊距的畫布尺寸
步驟 3:產生 SVG — 核心技術
3.1 手繪效果:feTurbulence + feDisplacementMap 組合
這是草圖風格的關鍵。它使用 Perlin 噪聲來位移像素,使直線和銳角 看起來像是手繪的。
<defs>
<!-- 用於形狀(方框、橢圓、大型容器)— 中等晃動 -->
<filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
<feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
<feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
xChannelSelector="R" yChannelSelector="G"/>
</filter>
</defs>
重要:請勿對箭頭/連線線套用任何濾鏡。 feDisplacementMap 濾鏡
即使比例很小,也會導致細線在大多數 SVG 渲染器中變得不可見或斷裂。
箭頭必須在沒有任何濾鏡屬性的情況下繪製。箭頭的手繪感來自於使用
stroke-width="3" 或更粗的線條,這在與帶濾鏡的形狀並列時已經
看起來足夠自然。
3.2 陰影填充圖案
對角線圖案模擬手繪的交叉陰影:
<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
patternTransform="rotate(-45)">
<line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>
為了可讀性,將陰影圖案與半透明的純色填充圖層疊加:
<!-- 陰影圖層 -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- 可讀性疊加層 -->
<rect ... fill="#dbeafe" opacity="0.25"/>
為圖表中使用的每種顏色主題建立一個陰影圖案。
3.3 手寫字型 — 精確使用這些字型,不得替換
所有圖表必須使用一致的字型。請使用這個精確的 <style> 區塊 — 不要
使用 Caveat、Patrick Hand 或任何其他字型。這是硬性要求。
對於包含中文文字的圖表:
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&family=ZCOOL+KuaiLe&display=swap');
/* 中文文字 — 馬善政毛筆風格字型 */
text {
font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
}
/* 英文標籤(程式碼名稱、技術術語如 /task-add、Backlog、YAML) */
.label-en {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
對於完全使用英文的圖表:
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&display=swap');
text {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
在中文圖表中,將 class="label-en" 套用於英文文字元素。絕不使用 Caveat、
Patrick Hand、Indie Flower 或任何其他手寫字型 — 中文堅持使用馬善政(Ma Shan Zheng),
英文堅持使用 Comic Sans MS。
3.4 箭頭標記
定義與每個區段主題顏色匹配的彩色箭頭標記:
<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
markerWidth="10" markerHeight="10" orient="auto-start-reverse">
<path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>
在連線線上使用 marker-end="url(#arrow-blue)"。對於虛線連線
(表示間接/可選流程),請加上 stroke-dasharray="14 10"。
3.5 形狀詞彙
| 概念 | SVG 形狀 | 範例 |
|---|---|---|
| 角色 | <ellipse> | PM、使用者、系統 |
| 流程步驟 | <rect rx="6"> | /task-add、build step |
| 容器/階段 | <rect rx="20"> 大型,帶陰影 | 「1. 需求錄入」區段 |
| 資料/輸出 | <path> 平行四邊形 | Backlog、Report |
| 決策 | <path> 菱形 | 是/否分支 |
| 外部邊界 | <rect> 帶 stroke-dasharray | 系統邊界、反饋迴圈 |
3.6 顏色主題
每個主要區段/角色應有自己的顏色。良好的調色盤:
- 藍色:
stroke="#3b82d0"、fill="#dbeafe"、text="#1e40af"、hatch="#a0c4f0" - 橘色/黃色:
stroke="#d4920a"、fill="#fef3c7"、text="#92400e"、hatch="#f0d080" - 綠色:
stroke="#2d8a4e"、fill="#d1fae5"、text="#065f46"、hatch="#5a9e6f" - 紫色:
stroke="#7c3aed"、fill="#ede9fe"、text="#5b21b6"、hatch="#b4a0e8" - 灰色(用於虛線連線器):
stroke="#777"
3.7 連接元素 — 箭頭不使用濾鏡
這是最關鍵的部分。斷裂或消失的箭頭會毀掉整個圖表。
規則:
- 每個箭頭
<line>或<path>連線器必須有stroke-width="3"或更粗 - 每個箭頭必須有
marker-end="url(#arrow-xxx)"屬性 - 切勿在任何箭頭上加上
filter="url(#sketchy)"或filter="url(#sketchy-line)"— 濾鏡會使細線不可見 - 在形狀邊緣與箭頭起點/終點之間留出 5-10 像素的間隙,以便箭頭尖端清晰可見
- L 形箭頭必須終止於目標的中心軸 — 如果目標形狀在 x=600 處居中,
則箭頭的最後一個線段必須在 x=600 處結束,而不是在某個偏移位置。
從目標的
cx/cy(對於橢圓)或x + width/2、y(對於矩形)計算其中心座標 - 箭頭標籤不得與箭頭線重疊 — 將標籤放置在箭頭路徑上方或下方 15-20 像素處, 絕不能放在與水平箭頭相同的 y 座標或與垂直箭頭相同的 x 座標
<!-- 實線箭頭(直接流程)— 無濾鏡屬性 -->
<line x1="260" y1="390" x2="260" y2="425"
stroke="#3b82d0" stroke-width="3"
marker-end="url(#arrow-blue)"/>
<!-- 虛線箭頭(間接/可選流程)— 無濾鏡屬性 -->
<line x1="460" y1="440" x2="590" y2="440"
stroke="#777" stroke-width="3" stroke-dasharray="14 10"
marker-end="url(#arrow-gray)"/>
<!-- L 形或曲線路徑 — 無濾鏡屬性 -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
marker-end="url(#arrow-green)"/>
步驟 4:驗證箭頭(自我檢查)
在撰寫 SVG 後,你必須在儲存檔案前驗證每個連線。這個步驟 能捕捉最常見且最具破壞性的缺陷 — 缺少箭頭。
程序:
-
列出所有連線:返回步驟 1 的分解結果,並列舉每一個 應該存在的箭頭。將它們寫成檢查清單:
連線檢查清單: - [ ] 節點 A → 節點 B (下單) - [ ] 節點 B → 節點 C (處理訂單) - [ ] 節點 C → 節點 D (支付成功) ... -
對於每個連線,在 SVG 中驗證:存在一個
<line>或<path>元素, 其座標從來源節點的底部/右側邊緣到目標節點的頂部/左側邊緣, 並且它具有marker-end屬性。 -
檢查濾鏡污染:在 SVG 中搜尋任何包含
filter=的<line或連線器<path。 如果找到,從該元素中移除 filter 屬性。 -
檢查座標合理性:對於每個箭頭,驗證:
- 起點 (x1,y1) 靠近來源形狀的底部/右側邊緣
- 終點 (x2,y2) 靠近目標形狀的頂部/左側邊緣
- 對於 L 形路徑,最後一個線段必須在目標形狀的中心 x 或 y 處結束
- 起點和終點不同(不是零長度線條)
-
檢查標籤放置:對於每個箭頭標籤文字元素,驗證:
- 標籤的 y 至少在箭頭 y 座標上方或下方 15 像素處(對於水平箭頭)
- 標籤的 x 至少在箭頭 x 座標左側或右側 15 像素處(對於垂直箭頭)
- 標籤不與任何形狀框重疊
如果缺少任何連線,請在儲存前補上。
步驟 5:輸出與迭代
-
撰寫前檢查檔案是否存在:儲存前,檢查目標檔案是否已存在。 如果是,請加上版本後綴以避免覆蓋:
- 第一個檔案:
flowchart.svg - 如果
flowchart.svg存在:另存為flowchart-v1.svg - 如果
flowchart-v1.svg也存在:另存為flowchart-v2.svg - 持續增加直到找到未使用的檔名
- 使用
ls或test -f在寫入前檢查是否存在
- 第一個檔案:
-
將 SVG 寫入確定的檔案路徑
-
將 SVG 轉換為 PNG 並進行視覺自我檢查:請勿立即為使用者開啟檔案。 而是先轉換並檢查結果:
rsvg-convert input.svg -o output.png然後使用讀取工具檢視生成的 PNG 圖像。仔細檢查是否:
- 佈局問題:元素是否重疊?是否有文字被裁剪或溢出容器? 是否有過大的空白間隙或擁擠的區域?
- 箭頭問題:所有箭頭是否都可見?是否有箭頭指向錯誤的方向、 穿過形狀或看起來斷開/損壞?
- 文字可讀性:文字是否清晰可讀且不與其他元素重疊?
- 整體平衡:圖表在畫布內看起來比例是否良好?
如果發現任何問題,請返回並修正 SVG,重新轉換,然後重新檢查。 重複直到圖表通過視覺檢查。
-
一旦圖表通過檢查,通知使用者 SVG 和 PNG 檔案已準備就緒, 並提供檔案路徑。請勿使用
open— 使用者可能使用遠端伺服器。 -
準備好接收反饋 — 常見的要求包括:
- 「這個框太小了」→ 增加尺寸並重新定位
- 「箭頭斷了」→ 移除箭頭上的任何濾鏡,增加 stroke-width
- 「字體不夠手寫」→ 驗證 Google Fonts 匯入,檢查確切的 font-family 字串
- 「顏色太淡/太深」→ 調整透明度與描邊顏色
- 佈局重新安排 → 重新計算座標
常見陷阱
- 箭頭消失:頭號問題。切勿將
filter套用於<line>或箭頭<path>。 位移濾鏡會使細元素不可見。只有形狀(<rect>、<ellipse>、 容器<path>)才應使用濾鏡。 - 字型不一致:中文始終使用
Ma Shan Zheng,英文始終使用Comic Sans MS。 切勿用 Caveat、Patrick Hand、Indie Flower 等取代。 - 文字看起來不像手寫:Google Fonts
@import需要網路連線。