diff --git a/docs/迁移手册.md b/docs/迁移手册.md
index 512da49..f6823c4 100644
--- a/docs/迁移手册.md
+++ b/docs/迁移手册.md
@@ -450,6 +450,17 @@ com.dsasp.* com.eip4.*
- **对策**:置 jar 于 `platform-legacy-core/local-libs/`(标准 Maven repo 布局 `ft/otp/jotpverify/1.0.0/jotpverify-1.0.0.{jar,pom}`),在 **platform-legacy-core 模块 pom** 加 `file://${project.basedir}/local-libs` 私有仓库 + 依赖坐标 `ft.otp:jotpverify:1.0.0`。**父 pom 不动**,模块自包含、构建可复现(随工程进版本库)。`UserOtpServiceImpl` 代码原样保留一行未改。**注意**:offline(`-o`)首次构建会拒绝 file:// 仓库(未缓存),需联网构建一次(无网络下载,仅解析本地 file 仓库)。
- **影响范围**:凡移植带私有 lib jar 的 framework 模块同此法(模块 local-libs 私有仓库),勿往父 pom 加 system-scope 或全局坐标。
+### 5.39 P4 脚本迁移线三坑:spring-boot 离线打包不刷新上游 jar / FULL_AUTO 不等于零外部依赖 / bindField 须随 facade 动词表注入 [NEW 2026-06-11]
+
+- **现象一(打包陷阱)**:改了 platform-metadata 后单独 `mvn -o -pl platform-app package`,boot jar 的 `BOOT-INF/lib/platform-metadata-*.jar` 时间戳仍停在改前,新增 facade 动词运行时执行报 `No signature of method: ...bindField()`。
+ - **根因**:spring-boot-maven-plugin 离线 repackage 解析上游模块用了 reactor/缓存的旧产物,单模块 package 不连带重建上游。
+ - **对策**:改上游模块后用反应堆 `mvn -o -pl platform-app -am package` 连带重建上游再起服务;或起服务前 `unzip -l` 核验 `BOOT-INF/lib` 内上游 jar 字节码已含新方法(`javap -p` grep)。
+- **现象二(FULL_AUTO 语义边界)**:S3 改写器的 FULL_AUTO(497 条)仅指「无残留 S3 UI 动词」,但脚本可能并存 `GetServicesFunction`/`GetDefaultValueFunction`/`Console`/`CustomSearchConditional` 等平台 S2 函数库/领域类调用——这些需 WS3 回迁的 Java 函数库桩(第三章),**不在 31 动词 facade 覆盖内**。
+ - **对策**:facade 集成挑样须按「仅 facade 动词」筛选(本批 612 条 S3 中 296 条 facade-only);端到端全量跑通须先补齐函数库桩(GetServicesFunction 等,迁移手册 §111「WS3 回迁」)。
+- **现象三(基础 facade 漏注)**:改写器不改 `bindField`(它本就是 S2 形态),但运行时若只注入 31 个「改写目标动词」会漏掉 `bindField`,含 bindField 的 FULL_AUTO 脚本报未定义方法。
+ - **对策**:facade 动词表须把 `bindField`/`getFieldValue`/`setFieldReadOnly`/`showConfirmDialog` 四个**基础辅助函数**(§161)与 31 改写目标动词一并注入,合计 ≥32 个动词闭包。
+- **影响范围**:P4 脚本批量转换/运行时脚本加载;凡用 facade 闭包注入机制执行存量脚本的环节;改上游模块后的 boot 打包流程。
+
## 六、Flowable 升级三坑
> 来源:eip4-poc WS4 实测,flowable-poc / flowable5-poc 工程(2026-06-10)
@@ -666,13 +677,20 @@ com.dsasp.* com.eip4.*
| 对拍框架设计(C1)评审 | CTO + 老员工 | 待定 | 待定 |
| Flowable 升级三坑与 Runbook 对应 | P3 责任人 | 待定 | 待定 |
-### 9.3 WS3 facade 动词表扩展(待补 P1)
+### 9.3 WS3 facade 动词表扩展(已交付 P4-2 2026-06-11)
当前已确认的 4 个基础辅助函数(`getFieldValue` / `bindField` / `setFieldReadOnly` / `showConfirmDialog`)之外,盘点报告 Top S3 API 调用显示需扩展至 ~20 个:
已知待补:`addButton`×100、`getValue`×68、`getContainerDataSource`×61、`setFilter`×56、`removeAllItems`×29、`group.setReadOnly`×27、`getDisplay`×27、`setVisible`×21、`setCaption`×16……
-P1/P4 阶段由老员工与后端架构逐条补全,补全后回填本节。
+**[已交付 2026-06-11 / P4-2]** 动词表已扩展并在引擎侧落地,详见 `tools/s3_rewriter/P4脚本迁移执行报告.md`:
+
+- **改写器目标动词 31 个**(C4 报告 §2.2),运行时实现 `com.eip4.platform.metadata.script.ScriptFacade`,经 PoC 已建的 facade 闭包注入机制(`ScriptingEnginesManager.evaluateGroovy` 的 `Bindings`)注入,**com.dsasp 源码零改、无替换类登记**(ArchUnit「保真层禁止依赖现代层」复跑通过)。
+- **动词分两类**:①服务端语义(`getFieldValue`/`getFieldDisplay`/`getFieldDataSource`,服务端求值返回);②UI 语义(其余 29 个,捕获为 amis 事件动作指令 JSON `{actionType, componentId, args}`,actionType 取 amis 标准动作名 show/hidden/enabled/disabled/static/setValue/setFilter/setOptions/addOption/toast/…)。连同 4 个基础辅助函数中的 `bindField`,合计 32 个动词闭包注入。
+- **执行端点**:`POST /api/script/execute`(改写后脚本直接执行)、`POST /api/script/execute-template`(按模板名取客户库真实脚本执行)。
+- **验证**:单测 17 方法逐动词覆盖(均经真实 Groovy 过保真层引擎,BUILD SUCCESS);集成 6 条真实 FULL_AUTO 改写脚本经 8086 执行产出 amis 指令、协议合规;回归 PoC script-test 通过。
+
+剩余 `showConfirmDialog`(同步确认框)的异步回调链改造仍属 HARD 人工范畴(85 条),不在 facade 自动覆盖内。
---
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/script/ScriptFacade.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/script/ScriptFacade.java
new file mode 100644
index 0000000..c68dad5
--- /dev/null
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/script/ScriptFacade.java
@@ -0,0 +1,361 @@
+package com.eip4.platform.metadata.script;
+
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import javax.script.Bindings;
+import javax.script.SimpleBindings;
+
+import groovy.lang.Closure;
+
+/**
+ * facade 动词表运行时(P4 脚本迁移线 任务2)。
+ *
+ *
背景:S3 正则改写器(tools/s3_rewriter)把存量 Vaadin S3 脚本改写成了 31 个目标动词
+ * (setFieldVisible/getFieldValue/showToast/addSubTableButton/setFieldFilter 等,见
+ * tools/s3_rewriter/C4实测报告.md §2.2)。本类在引擎侧落地这些动词:脚本经
+ * {@code ScriptingEnginesManager.evaluateGroovy(key, script, bindings)} 执行时,把每个动词
+ * 作为 Groovy 闭包注入 {@link Bindings},于是脚本文本零修改即可运行(PoC enableButton 模式扩展)。
+ *
+ *
架构纪律:本类位于现代层 {@code com.eip4.*},仅向保真层
+ * {@code com.dsasp...ScriptingEnginesManager} 注入闭包,不修改任何 {@code com.dsasp} 源码
+ * (ArchUnit「保真层禁止依赖现代层」恒成立)。
+ *
+ *
动词分两类:
+ *
+ * - 服务端语义动词(getFieldValue/getFieldDataSource/getFieldDisplay):直接在
+ * 服务端对行数据/数据源求值并返回 Java 值,脚本可继续用其结果做分支。
+ * - UI 语义动词(其余 28 个):捕获为 amis 事件动作指令 JSON(actionType/componentId/args,
+ * amis 事件动作协议口径,见 amis-core/src/actions),收集进 {@link #getCommands()} 返回前端,
+ * 由 amis 在浏览器侧重放——「换 facade 实现、脚本零改」。
+ *
+ *
+ * 线程模型:每次脚本执行 new 一份 ScriptFacade,闭包捕获本实例,指令收集非共享,无并发问题。
+ */
+public class ScriptFacade {
+
+ /** 行数据上下文(amis 表单当前数据),服务端语义动词从此取值。键为字段名(大写列名)。 */
+ private final Map item;
+
+ /** 捕获的 amis 事件动作指令(UI 语义动词产出,按调用顺序)。 */
+ private final List