Gaphor

產品說明

Gaphor 是一款開源的建模工具，專為需要嚴謹架構設計的開發者與系統工程師所打造。與一般通用的繪圖軟體（如 Draw.io）不同，Gaphor 嚴格遵循 UML (Unified Modeling Language)、SysML (Systems Modeling Language) 與 C4 Model 的標準規範，確保你的設計圖不僅美觀，更具備語義上的正確性。

它完全使用 Python 與 GTK 框架編寫，這使得它在保持輕量化的同時，擁有極高的擴充性。對於開發者而言，這意味著你可以透過 Python 腳本來與模型互動，甚至開發外掛來生成程式碼或文件。Gaphor 的介面設計極簡且直觀，沒有複雜的學習曲線，讓你能專注於系統邏輯的思考。

核心特色：

• 多標準支援：完整支援 UML 2.5、SysML 1.6、RAAML (風險分析) 與 C4 Model，適合軟體架構與系統工程領域。
• 嚴謹的模型一致性：不同於單純的「畫圖」，Gaphor 建立的是真正的模型資料庫。當你更改某個類別名稱時，所有引用該類別的圖表都會自動更新。
• Python 原生打造：軟體體積小巧，啟動速度快，且完全開源（Apache 2.0），對 Python 開發者極具親和力。
• 現代化介面：支援系統深色模式（Dark Mode），並提供直觀的拖放式操作與屬性編輯器。
• 程式碼生成：雖然核心功能專注於建模，但透過社群外掛，它具備從模型生成程式碼（Code Generation）的潛力。

安裝指南

Gaphor 提供多種安裝方式，致力於在各平台上提供原生般的體驗。

Windows (安裝檔 / Winget)
你可以從官網下載 .exe 安裝檔，或使用 Winget：

winget install Gaphor.Gaphor

macOS (DMG / Homebrew)

brew install --cask gaphor

Linux (Flatpak – 官方推薦)
這是 Linux 上體驗最佳的安裝方式：

flatpak install flathub org.gaphor.Gaphor

Python (PyPI)
如果你是 Python 開發者，也可以直接安裝到你的環境中：

pip install gaphor

使用教學

啟動 Gaphor 後，你會看到一個乾淨的三欄式介面：左側是導航樹（Tree View），中間是畫布，右側是屬性編輯器。

1. 建立第一個模型

1. 選擇模型類型：開啟軟體後，選擇 "New Model"。你可以選擇 UML、SysML、C4 Model 或 RAAML 作為範本。
2. 建立圖表：在導航樹上點擊右鍵，選擇 Create Diagram。例如，選擇 Class Diagram（類別圖）。
3. 繪製元素：從下方的工具箱（Toolbox）中，拖曳 Class 或 Interface 到畫布上。
4. 編輯屬性：點擊剛建立的類別，在右側面板輸入名稱、屬性（Attributes）與方法（Operations）。

2. 關係連結

Gaphor 的強大之處在於智慧連結：

• 選擇工具箱中的 Association 或 Generalization（繼承）。
• 從一個類別拖曳到另一個類別，Gaphor 會自動吸附並建立正確的 UML 關係線。
• 若違反標準（例如嘗試繼承一個介面到類別但方向錯誤），系統會透過視覺回饋引導你。

3. C4 模型架構圖

對於現代微服務架構，C4 模型非常熱門：

1. 選擇 C4 Model 範本。
2. 你可以建立 Context, Container, Component 等不同層級的視圖。
3. 利用 Person, Software System, Container 等專屬元件，快速畫出清晰的系統邊界與資料流向。

4. 匯出與分享

完成設計後，你可以將圖表匯出為高品質圖片：

• 點擊漢堡選單（或 File） -> Export。
• 支援匯出為 SVG (向量圖，適合網頁與文件) 或 PDF / PNG。

小撇步：Gaphor 的檔案格式 (.gaphor) 其實是一個 XML 檔，這意味著它對版本控制系統（Git）非常友善，你可以輕鬆比較不同版本間的模型差異。