plantuml-manipulator

PlantUML Manipulator 是一套自動化工程工具，專為需要管理大量 PlantUML 序列圖的開發人員設計。該工具提供強大的命令行介面，可在整個程式庫中執行一致的批次修改，確保架構文件能與不斷演進的業務邏輯保持準確同步。透過自動化重複性工作，能大幅降低處理複雜圖表時的人為錯誤風險。

• 執行批次操作，例如在特定群組後插入程式碼片段，或同時在多個檔案中新增參與者 (participants)。

• 提供結構驗證功能，檢查專案中是否存在必要的群組或參與者，確保文件編寫標準的一致性。

• 產生完整的結構報表，包含參與者與群組列表，並支援表格、JSON 或 CSV 等多種格式。

• 支援進階篩選條件，例如檔案匹配模式、特定參與者偵測或現有群組名稱檢查，以實現精確操作。

• 提供安全的執行機制，包含變更預覽的 dry-run 模式、強制備份建立以及跳過已存在項目的邏輯，防止重複插入。

• 適合軟體架構師與工程師在進行大規模重構，或是為眾多流程圖新增標準化驗證/整合步驟時使用。

• 當變更具有重複性 (超過 5 個檔案) 或需要確保整個程式碼庫的結構一致性時，請使用此工具。

• 使用方式為準備包含目標區塊的程式碼片段檔案，並透過命令行 (如 insert-after、add-participant 或 validate) 執行指令。

• 請注意，本工具不適用於單一檔案的一次性修改 (建議使用一般文字編輯器)，也不適用於需要高階語境理解的語意修正。

• 務必優先執行 dry-run 旗標來檢查變更，並在進行重大重構時利用 --backup 選項以維護專案完整性。