SuperAPI AI 工具集

plantuml-ascii

写作与研究

查看项目

更新于 10-15 21:52

技能介绍

用途:使用 PlantUML 的文本模式把图表渲染为纯文本 ASCII 艺术,适合终端工作流、不支持图片的 Git 提交或 PR、需要版本控制的文档,以及没有图形工具的环境。

主要能力:支持时序图、类图、活动图、状态图、组件图、用例图和部署图。输出格式有两种:-txt 生成纯 ASCII 字符,-utxt 生成带制表符的 Unicode 增强版。

安装:macOS 用 brew install plantuml;Ubuntu/Debian 用 sudo apt-get install plantuml;RHEL/CentOS 用 sudo yum install plantuml;也可直接下载 JAR:wget https://github.com/plantuml/plantuml/releases/download/v1.2024.0/plantuml-1.2024.0.jar。

使用方式:先写 .puml 文件,例如 @startuml 开头、@enduml 结尾;再运行 plantuml -txt diagram.puml 或 plantuml -utxt diagram.puml,也可用 java -jar plantuml.jar -txt diagram.puml。输出保存为 diagram.atxt 或 diagram.utxt。常用选项包括 -o 指定输出目录、-charset UTF-8 指定字符集、-v 详细输出、-includeDot 包含隐藏文件,以及处理整个目录。还提供 Ant 任务集成,format 可设为 txt 或 utxt。

限制与建议:复杂图表在 ASCII 下渲染效果差,标签应简短,否则会破坏对齐;建议使用等宽字体并在分享前于终端验证;复杂图表可考虑 Mermaid.js 或 graphviz。若出现 Unicode 乱码,需确保终端支持 UTF-8;若命令未找到,需安装 PlantUML 或直接使用 JAR。