plantuml-manipulator

PlantUML Manipulator 是一套自动化工程工具，专为需要管理大量 PlantUML 序列图的开发人员设计。该工具提供强大的命令行界面，可在整个代码库中执行一致的批处理修改，确保架构文档能与不断演进的业务逻辑保持准确同步。通过自动化重复性工作，能大幅降低处理复杂图表时的人为错误风险。

• 执行批处理操作，例如在特定组后插入代码片段，或同时在多个文件中新增参与者 (participants)。

• 提供结构验证功能，检查项目中是否存在必要的组或参与者，确保文档编写标准的一致性。

• 生成完整的结构报表，包含参与者与组列表，并支持表格、JSON 或 CSV 等多种格式。

• 支持高级筛选条件，例如文件匹配模式、特定参与者检测或现有组名称检查，以实现精准操作。

• 提供安全的执行机制，包含变更预览的 dry-run 模式、强制备份创建以及跳过已存在项目的逻辑，防止重复插入。

• 适合软件架构师与工程师在进行大规模重构，或是为众多流程图新增标准化验证/整合步骤时使用。

• 当变更具有重复性 (超过 5 个文件) 或需要确保整个代码库的结构一致性时，请使用此工具。

• 使用方式为准备包含目标区块的代码片段文件，并通过命令行 (如 insert-after、add-participant 或 validate) 执行指令。

• 请注意，本工具不适用于单文件的临时修改 (建议使用一般文本编辑器)，也不适用于需要高阶语境理解的语义修正。

• 务必优先执行 dry-run 标志来检查变更，并在进行重大重构时利用 --backup 选项以维护项目完整性。