用途:当 Apache NiFi 流程需要长期可读时,用该技能整理画布布局,包括明确命名、有效注释、紧凑的纵向流程和不交叉区块的连线。该技能没有环境默认值,需显式传入 NiFi URL、凭据或证书以及目标进程组。
主要能力:通过 NiFi REST 读取目标进程组;修改前保存 JSON 快照;先审计与试运行再应用;统一风格为主路由自上而下、输入源在顶部、输出终点在底部、错误与日志分支走侧道;连线正交、不带名称;可为处理器、进程组、输入端口、输出端口添加注释;命名采用层级编号如 10、20、30、30.10、30.20;移动节点优先于绘制长绕行;可用 Playwright 截图与 DOM 边界框做视觉校验,把路由或标签与组件重叠视为缺陷。
使用方式:包含脚本 scripts/nifi_layout.py(REST 审计、试运行、应用、几何测试)与 scripts/nifi_visual_check.cjs(Playwright 截图与 DOM 边界框采集),以及 references/layout-rules.md。典型命令如: python3 scripts/nifi_layout.py --base-url https://nifi.example.com/nifi-api --group-id <process-group-id> --cert /path/client.crt --key /path/client.key --mode audit --recursive 支持 --dry-run、--backup-dir、--single-group、--group-order top-down、--report-dir、--screenshots-dir、--visual-gate 与 --p12 等参数。
限制与安全:默认先审计或试运行,仅在请求实施时使用 apply;不打印密钥或证书口令;不修改处理器业务属性;只更新名称、注释、位置、连线折点、labelIndex 和空连线名;应用前必须用 --backup-dir 写出备份 JSON;保留修订与当前处理器状态。视觉缺陷包括 X/T 交叉、自重叠 U 型回转、标签与组件间距不足等。若需图形级决策(如加 funnel、收集处理器、拆分汇点或独立进程组),报告会给出 topology_blockers。其余平台与收费信息暂未提供。