[17.x] 批量写按行语义实现:hook 按行触发 + record-change trigger 按行绑定 previous/record(#4800/#4862 拍板 A)

[claude]

维护者 2026-08-04 拍板(见 #4800 / #4862 裁定评论):批量写上 after 型 hook 与 record-change flow trigger 按行求值、按行触发是平台契约。本单是 17.x 的实现单,一次设计覆盖两面:

• hook:一次批量写触发 N 次(需定 ctx.result 形状:整批 vs 单行)、匹配行集一次性读取(复用 validation 侧 Validation rules, requiredWhen and option visibleWhen are silently skipped on multi-row updates (options.multi) #3106 的逐行取数形状);
• flow trigger(record-change flow trigger 在 predicate 批量写上:previous 不绑定、record 只是裸 payload —— 官方文档与 showcase 正在教的 transition 起始条件在批量写上不成立 #4862 的全部事实照单):previous 按行绑定、record 为该行实际状态而非裸 payload;
• showcase 受影响的 10 条 transition flow 作端到端验证面;
• 性能护栏:行集读取一次完成,求值批内复用;
• 文档与 formula skill 的 transition 写法口径随之收口。

Blocked-by: #5037(rc 止血单)
Blocked-by: #4800(ADR 补遗随止血单落地)

关联:#4862(trigger 侧事实与影响面)、#3106(validation 先例)、#4775/#4861(fail-loud 先例)。

---

Generated by Claude Code