diff --git a/docs/P1/F2-3脚本运行时报告.md b/docs/P1/F2-3脚本运行时报告.md
new file mode 100644
index 0000000..d092b8d
--- /dev/null
+++ b/docs/P1/F2-3脚本运行时报告.md
@@ -0,0 +1,179 @@
+# F2-3 脚本运行时报告
+
+生成时间:2026-06-11
+作者:P4 脚本迁移线
+
+---
+
+## 一、F2-1b 默认导入补全
+
+### 问题根因
+
+视图脚本执行路径(`ScriptExecuteController` → `com.dsasp.server.dataDic.binding.ScriptingEnginesManager`)使用裸 `GroovyScriptEngineFactory`,缺少服务端默认导入注入,导致:
+
+- `GetServicesFunction.loadPOJO(...)` 报「No such property: GetServicesFunction」
+- `new DateTime[2]` 报「unable to resolve class DateTime」
+
+服务流路径(`com.dsasp.server.core.service.script.ScriptingEnginesManager`)已正确使用 `SecureGroovyScriptEngineFactory`(含 DEFAULTIMPORTSLIST 8 条 + org.joda.time 星号导入)。
+
+### 修法
+
+`com.dsasp.server.dataDic.binding.ScriptingEnginesManager` 换用 `SecureGroovyScriptEngineFactory`。最小改动:删除 `GroovyScriptEngineFactory` 引入,添加 `SecureGroovyScriptEngineFactory` 引入,ArchUnit 保真层纪律不受影响。
+
+### 默认导入串对照(SecureGroovyScriptEngineFactory.DEFAULTIMPORTSLIST)
+
+| 类 | 来源 | 用途 |
+|---|---|---|
+| `com.dsasp.server.common.dataDic.bean.GeneralPOJO` | platform-legacy-core | 数据实体 |
+| `com.dsasp.server.common.dataDic.bean.CustomSearchConditional` | platform-legacy-core | 查询条件 |
+| `com.dsasp.server.common.dataDic.service.POJOCRUDService` | platform-legacy-core | CRUD 服务 |
+| `com.dsasp.server.common.util.StringUtil` | platform-legacy-core | 字符串工具 |
+| `com.dsasp.server.common.function.GetServicesFunction` | platform-legacy-core | 服务调用函数库 |
+| `com.dsasp.server.common.function.GetDefaultValueFunction` | platform-legacy-core | 默认值函数库 |
+| `com.dsasp.server.common.function.GetValueFunction` | platform-legacy-core | 字段取值函数库 |
+| `com.dsasp.client.viewframework.template.util.Console` | platform-legacy-core | 脚本调试日志 |
+
+星号导入:`org.joda.time`(DateTime/DateTimeFormatter 等,joda-time 2.12.7 已在 legacy-core pom)
+
+---
+
+## 二、F2-3 嵌套指令协议
+
+### 规格
+
+改写器(tools/s3_rewriter F2-3 规则族)产出两个新动词形态,服务端 `ScriptFacade` 急切求值闭包,收集子指令入子缓冲,输出含嵌套数组的指令 JSON。
+
+#### addFieldButton 四参形态
+
+**脚本**:
+```groovy
+addFieldButton("FIELD", "文案", {
+ // 闭包体动词
+ setFieldVisible("X", true)
+ showToast("完成")
+}, 1)
+```
+
+**服务端输出**:
+```json
+{
+ "actionType": "addButton",
+ "componentId": "FIELD",
+ "args": {
+ "label": "文案",
+ "index": 1,
+ "onClick": [
+ { "actionType": "show", "componentId": "X" },
+ { "actionType": "toast", "args": { "msgType": "info", "msg": "完成" } }
+ ]
+ }
+}
+```
+
+#### showConfirm 形态
+
+**脚本**:
+```groovy
+showConfirm("确认操作?", {
+ setFieldEnabled("BTN", false)
+})
+```
+
+**服务端输出**:
+```json
+{
+ "actionType": "confirmDialog",
+ "args": {
+ "msg": "确认操作?",
+ "onOk": [
+ { "actionType": "disabled", "componentId": "BTN" }
+ ]
+ }
+}
+```
+
+### 前端重放协议(registerReplayAction.ts)
+
+- `addButton` + `onClick` 数组:翻译子指令为 amis 动作数组,挂 `args.onClickActions`,透传给 amis `addButton` 动作;amis 侧按钮点击后 runActions 重放。
+- `confirmDialog` + `onOk` 数组:翻译子指令为 amis 动作数组,挂 `args.onOkActions`,透传给 amis `confirmDialog` 动作;用户确认后 runActions 重放。
+- 无嵌套数组的 `addButton` 走常规路径(向后兼容旧三参形态)。
+
+---
+
+## 三、staging 晋级前后分布
+
+| 标签 | 晋级前(基线) | 晋级后(staging) | 变化 |
+|------|--------------|-----------------|------|
+| FULL_AUTO | 497 | **507** | +10 |
+| PARTIAL | 30 | **32** | +2 |
+| HARD | 86 | **74** | -12 |
+| NO_S3 | 815 | 815 | 0 |
+| **自动化率** | **81.1%** | **82.7%** | **+1.6pp** |
+| 人工作业单 | 116 | **106** | -10 |
+| templates_with_scripts | 721 | 721 | 0 |
+
+**双库核数**(load_page_schema.py):
+- `eip4dev.eip3`:更新 801 条,幂等跳过 688 条
+- `eip4m0.public`:更新 801 条,幂等跳过 688 条
+
+**BatchConvertCli**:总量 1516,闸一通过 1489(98.2%),onEvent 钩子挂载 380 个模板
+
+---
+
+## 四、4 样本验证结果
+
+| 样本 | templateId | seq | 脚本标签 | 结果 | 分类 |
+|------|-----------|-----|---------|------|------|
+| getConfigValue+page绑定 | 021e3ba7-e03a-412a-9f0e-c20ef440a885 | 2 | NO_S3 | `page` MissingProperty | **预期**:page 是 Vaadin 视图对象,服务端不绑定 |
+| GetServicesFunction.loadPOJO | 0670aaf9-a045-450d-9ebc-06f3ac36ca19 | 1 | NO_S3 | `PM_BIDRELATIONSHIP_ID` MissingProperty | **预期**:类名已解析,缺行数据 item 字段(无 ID 注入) |
+| new DateTime[2] | 087739c4-3dee-4bac-b031-772497addc6b | 1 | NO_S3 | **passed: True** | F2-1b 修复验证通过 |
+| GetValueFunction | 1cc15e59-460e-4949-8a2f-41ea39bad097 | 1 | FULL_AUTO | **passed: True** | F2-1b 修复验证通过 |
+
+**补充类名解析验证**(/api/script/execute 直接测试):
+
+| 验证项 | 结果 |
+|-------|------|
+| `GetServicesFunction.class.simpleName` → `"GetServicesFunction"` | passed: True |
+| `GetValueFunction.class.simpleName` → `"GetValueFunction"` | passed: True |
+| `new DateTime[2]; arr.length` → `2` | passed: True |
+
+---
+
+## 五、单测覆盖
+
+### Java(ScriptFacadeTest,platform-metadata)
+
+新增 7 个 F2-3 测试用例(总计 24,全绿):
+
+| 用例 | 验证点 |
+|-----|-------|
+| `addFieldButton_withClosure_emitsOnClickSubCommands` | 闭包内动词产生 onClick 子指令数组(2 条) |
+| `addFieldButton_emptyClosure_emitsEmptyOnClick` | 空闭包产生空 onClick 数组(非 null) |
+| `addFieldButton_nullHandler_noOnClick` | null handler 不含 onClick 字段(向后兼容) |
+| `showConfirm_withClosure_emitsOnOkSubCommands` | 闭包内动词产生 onOk 子指令数组(2 条) |
+| `showConfirm_emptyClosure_emitsEmptyOnOk` | 空闭包产生空 onOk 数组 |
+| `showConfirm_nullHandler_noOnOk` | null handler 不含 onOk 字段 |
+| `addFieldButton_nestedClosure_closureBodyExceptionStillReturnsPartialSubCommands` | 闭包内异常前已产生的子指令仍收集(容错) |
+
+### TypeScript(vitest,eip4-web)
+
+新增 7 个单测用例(总计 23,全绿):
+
+**scriptCommands.test.ts(+4)**:
+- addButton 无 onClick 时透传 args
+- addButton 含 onClick 子指令数组时原样透传 onClick
+- confirmDialog 含 onOk 子指令数组时原样透传 onOk
+- confirmDialog 空 onOk 不含 onOk 字段
+
+**registerReplayAction.test.ts(+3)**:
+- addButton 含 onClick 时翻译并挂 onClickActions
+- confirmDialog 含 onOk 时翻译并挂 onOkActions
+- addButton 空 onClick 时不挂 onClickActions(直接派发)
+
+---
+
+## 六、e2e 验证
+
+晋级后 `npx playwright test`:**30/30 全绿**(eip4-web)
+
+8093 状态:RUNNING(PID 55015,Java 17,/tmp/eip4-8093.log)
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
index c68dad5..a5df244 100644
--- 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
@@ -175,8 +175,76 @@ public class ScriptFacade {
return emit("removeOption", field, args("value", value));
}
+ /**
+ * addFieldButton("FIELD","文案",{闭包},N) — F2-3 运行时动词:闭包子指令机制。
+ *
+ *
服务端急切求值闭包({@link Closure}),闭包内动词产生的指令收进子缓冲,
+ * 输出 {@code {actionType:"addButton",componentId:"FIELD",args:{label,index:N,onClick:[子指令数组]}}}。
+ * 非闭包参数(null 或旧版 handler 占位)按原有行为退化(onClick 不含子指令数组)。
+ */
public Object addFieldButton(String field, Object label, Object handler) {
- return emit("addButton", field, args("label", label));
+ return addFieldButton(field, label, handler, null);
+ }
+
+ /**
+ * addFieldButton("FIELD","文案",{闭包},N) 四参完整形态。
+ */
+ public Object addFieldButton(String field, Object label, Object handler, Object index) {
+ List