Mermaid
不需額外設定
Mermaid圖解（含 ZenUML 序列圖）可在目前文件流程中顯示。
平台支援
macOS / Windows / Linux
全面支援macOS (Intel/M系列)、Windows x86_64及Linux x86_64。
macOS
macOS + Homebrew
macOS使用者最快、最推薦的安裝方式。
- 倉庫README官方推薦的路徑。
- 安裝後即可立即開始工作。
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopmacOS手動下載
- 在GitHub Releases下載最新的 `KatanA-Desktop-x.y.z.dmg`。
- 將 `KatanA Desktop.app` 拖入「應用程式」資料夾。
- 首次執行若遇到Gatekeeper權限限制，請在系統設定中允許，或參考以下指令。
xattr -cr /Applications/KatanA\ Desktop.appWindows x86_64
Windows使用者首選Winget，亦透過GitHub提供MSI安裝包。
- 透過Winget一鍵安裝，或下載 `KatanA-windows-x86_64.msi`。
- 雙擊MSI即可完成快速部署。
- 自動建立開始功能表與桌面捷徑。
winget install HiroyukiFuruno.katana-desktopLinux x86_64
推薦透過Homebrew安裝，或使用tar.gz壓縮包。
- 支援Homebrew鏡像安裝，或直接下載 `KatanA-linux-x86_64.tar.gz`。
- 解壓後即可直接執行原生二進位程式。
brew tap HiroyukiFuruno/KatanA && brew install katana-desktop保持最新
- KatanA內建智慧自動更新機制。
- macOS使用者可點擊應用程式內的 「Update & Restart」 按鈕進行升級。
- Windows與Linux使用者會收到更新彈窗並引導至最新版本。
- macOS上透過Homebrew安裝的使用者，在應用程式內完成首次升級後會自動接管版本管理，以避免套件衝突。
可選圖解配置
Mermaid（含 ZenUML）可直接顯示；PlantUML按需配置相關工具。
PlantUML
Java執行環境
安裝Java後，在應用程式內開啟相關檔案時根據提示下載 `plantuml.jar`。
Draw.io
無配置模式
Draw.io圖解已透過內建模組支援，無需任何操作。
安裝後
安裝後3項確認
- 開啟工作區: 確認樹狀清單中有 README 與規格檔。
- 確認圖表: 開啟 Mermaid 文件（含 ZenUML 序列圖）或 PlantUML 文件並確認渲染。
- 檢查更新: 在應用內執行一次更新檢查並確認行為。
支援
FAQ
PlantUML 無法顯示
先安裝 Java runtime，再允許下載 plantuml.jar。
macOS 無法開啟應用
可在 Privacy & Security 使用 Open Anyway，或執行一次 xattr 命令。