SuperAPI AI 工具集

plantuml-skill

数据与分析

查看项目

更新于 10-15 16:42

技能介绍

用途:按用户描述或已有源码生成 PlantUML(.puml)图表,并导出为 PNG/SVG。渲染走 Kroki 云 API,只需 curl,无需本地 Java;也可用本地 Kroki Docker 或 PlantUML jar。

主要能力:覆盖时序图、组件/架构图、类图、ER 图、活动图/流程图、用例图、状态图、C4 上下文图、思维导图、甘特图等;支持从源码提取类图、时序、组件、ER 模型;支持将 Markdown 中的 plantuml/puml 代码块渲染并回写为图片链接。提供 !theme 主题与 skinparam 自定义样式。

使用方式:先确认 curl 可用,选择图类型并写出带 @startuml/@enduml 的 .puml;再用 POST 导出,如 curl -s -X POST https://kroki.io/plantuml/png -H "Content-Type: text/plain" --data-binary "@diagram.puml" -o diagram.png 离线可改用本地 Kroki:docker run -d -p 8000:8000 yuzutech/kroki,并把域名换成 http://localhost:8000。

质量与限制:导出后须检查 HTTP 状态与文件内容,Kroki 语法错误返回 400 且错误文本写入输出文件;失败应按退化顺序(简化形状、去掉 theme/skinparam、简化标签、减少边、换更简单图类型)重试最多 3 次,仍失败则展示原始错误。渲染后做视觉自检(标签截断、重叠、方向、边线混乱等),最多 2 轮;评审循环最多 5 轮。

隐私与适用:默认公共 Kroki 会把 .puml 上传到 kroki.io,敏感图应使用本地后端;C4 需用内置 !include <C4/...>,不能用远程 !includeurl。非 UML 的 Markdown 快速图宜用 mermaid,需像素级控制用 drawio,手绘风用 excalidraw/tldraw。