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 运行时，再允许应用下载 plantuml.jar。
macOS 阻止应用启动
可在 Privacy & Security 选择 Open Anyway，或执行一次 xattr 命令。