用途:对 Confluence 多个页面执行批量操作,包括同时更新多页、批量添加或移除标签、在空间之间移动页面、批量修改权限,以及带预览的批量删除。单页操作、搜索或单个标签管理应改用 confluence-page、confluence-search、confluence-label 等技能。
主要能力与风险:批量标签增删风险较低且可撤销;批量更新会修改内容,批量移动会改变层级,批量权限变更影响访问控制,风险中等;批量删除为破坏性操作,风险最高,务必先用 --dry-run 预览。
使用方式:命令形如 confluence bulk label add --cql "space = DOCS AND type = page" --labels "approved" --dry-run,确认后再去掉 --dry-run 执行。批量删除示例:confluence bulk delete --cql "space = ARCHIVE AND created < '2023-01-01'" --dry-run。批量移动可用 --target-space 或 --target-parent;权限变更可用 --add-group、--remove-group、--add-user、--remove-user。通用选项包括 --dry-run、--yes/-y、--max-pages N(默认 100)、--batch-size N(仅标签添加支持)、--output json。
规模建议:5-10 页可直接执行;50-100 页先 dry-run;500 页以上建议避开高峰,标签添加使用 --batch-size。遇到 429 限流可减小 batch-size 或错峰执行。退出码 0 表示全部成功,1 表示部分失败或校验错误,2 表示全部失败,130 表示用户取消。
限制:需先确认 CQL 查询有效;页面被锁定或权限不足会失败;并非所有命令都支持 --batch-size;具体安装方式与认证配置资料未提供。