SuperAPI AI 工具集

slidev-plantuml

设计与创作

查看项目

更新于 10-15 22:34

技能介绍

用途:该技能用于在 Slidev 幻灯片中通过 PlantUML 代码块绘制 UML 与技术文档类图表,适合标准 UML 图、需要详细记号的复杂时序图、组件与部署图、用例图、带泳道的活动图以及 C4 架构图。资料称 PlantUML 在标准 UML 上比 Mermaid 控制更细、语法更冗长、UML 合规性更完整,且支持 C4 图与泳道,Mermaid 不支持。

主要能力:支持时序图(参与者类型如 actor、boundary、control、entity、database、collections、queue,以及 alt、group、loop、note 等);类图(属性方法可见性、接口、抽象类、继承实现组合聚合关联依赖等关系、package 分组);用例图(actor、rectangle、usecase、include);活动图(条件、泳道、fork 并行);组件图与部署图(package、node 嵌套、database、queue);状态图(含嵌套状态与 entry/exit);可通过 skinparam 与 !theme 定制样式(如 cerulean、materia、minty、sandstone、sketchy-outline 等);也可通过 !include 引入 C4-PlantUML 绘制上下文图与容器图。

使用方式:在 Slidev 中使用 plantuml 代码块,内容以 @startuml 开始、@enduml 结束。可在 setup/plantuml.ts 中通过 definePlantUmlSetup 配置服务器地址,默认使用公共服务器 https://www.plantuml.com/plantuml。

限制与注意:资料未说明离线渲染、缓存、错误处理与具体版本要求;PlantUML 为服务端渲染,默认依赖公共服务,需注意网络与隐私;语法比 Mermaid 更冗长,建议每图一个概念并遵循 UML 记法。