核心功能
PlantUML Diagram Generator 是一款专业级 UML 图表生成工具,通过自然语言描述自动生成符合 OMG UML 2.x 标准的图表。支持序列图、类图、活动图、用例图、组件图、部署图、状态图、甘特图、思维导图等 10 余种图表类型。
显著优点
标准化输出:严格遵循 uml-diagrams.org 参考样式,采用黑白 Visio UML 2.x 模板风格,线条统一 0.75pt,禁用彩色填充、渐变和阴影效果,确保专业文档一致性。
本地优先架构:默认使用 Docker 或本地 Java JAR 渲染,源代码永不离开主机;第三方 Kroki 服务器仅显式授权后才启用,适合处理含敏感架构的图表。
智能布局引擎:内置宽高比自动校正(0.7-1.4 舒适区间)和 A4 纸张适配,超限自动注入 scale 指令重渲染,避免极端比例或打印溢出。
多格式与国际化:支持 SVG/PNG/PDF/TXT 输出,CJK 字符通过 --cjk 标志自动切换文泉驿微米黑字体,解决中文乱码问题。
暗黑模式支持:可选生成 CSS @media (prefers-color-scheme: dark) 自适应 SVG,满足现代文档平台夜间阅读需求。
潜在局限性
- 学习曲线:需理解 PlantUML 语法约束(如
class <<interface>>而非interface关键字)才能微调生成结果 - 复杂布局:自动校正 3 次失败后保留原图,超大图表仍需手动拆分或缩略标签
- 字体依赖:CJK 渲染依赖主机预装字体,Windows 需额外配置 WSL/字体路径
适合人群
软件架构师、技术文档工程师、系统分析师、敏捷团队 PO/BA,以及需要将代码逻辑、业务流程、系统架构可视化的开发人员。
常规风险
- 隐私泄露:若误用
--use-public-server上传含内部主机名、API 密钥或客户数据的图表至 kroki.io - 渲染失败:Java/Docker 环境缺失时回退链条断裂,需预装依赖
- 字体缺失:CJK 环境未安装文泉驿字体导致字符渲染为 tofu 方块