diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/script/RewrittenScriptStore.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/script/RewrittenScriptStore.java
index 9caacf6..f5a46fe 100644
--- a/platform-metadata/src/main/java/com/eip4/platform/metadata/script/RewrittenScriptStore.java
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/script/RewrittenScriptStore.java
@@ -33,7 +33,8 @@ public class RewrittenScriptStore {
public RewrittenScriptStore(
@Value("${eip4.script.rewritten-root:tools/s3_rewriter/output/rewritten}") String rewrittenRoot) {
- this.root = Path.of(rewrittenRoot);
+ // normalize 一次,后续 load 用 startsWith(root) 做路径包含校验防 ../ 穿越。
+ this.root = Path.of(rewrittenRoot).normalize();
}
/**
@@ -47,8 +48,16 @@ public class RewrittenScriptStore {
if (templateId == null || templateId.isBlank()) {
return null;
}
- Path dir = root.resolve(templateId);
- if (!Files.isDirectory(dir)) {
+ // P0 安全(2026-06-24 架构评审):templateId 来自请求体,resolve 后 normalize 并校验仍在
+ // root 之内,防 `../../` 穿越读取脚本库外任意 .groovy 文件并交保真层执行(路径穿越→RCE)。
+ Path dir;
+ try {
+ dir = root.resolve(templateId).normalize();
+ } catch (java.nio.file.InvalidPathException e) {
+ // 非法路径字符(如 NUL 字节)→ 当作未找到,优雅降级而非 500。
+ return null;
+ }
+ if (!dir.startsWith(root) || !Files.isDirectory(dir)) {
return null;
}
String prefix = seq + ".";
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/script/ScriptFacadeRunner.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/script/ScriptFacadeRunner.java
new file mode 100644
index 0000000..4854a27
--- /dev/null
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/script/ScriptFacadeRunner.java
@@ -0,0 +1,36 @@
+package com.eip4.platform.metadata.script;
+
+import java.util.List;
+import java.util.Map;
+
+import javax.script.Bindings;
+
+import com.dsasp.server.dataDic.binding.ScriptingEnginesManager;
+
+/**
+ * 脚本 facade 执行的共享原语:把脚本经保真层 {@link ScriptingEnginesManager} 执行,
+ * 行数据上下文 + facade 动词注入 {@link Bindings},返回捕获的 amis 事件动作指令。
+ *
+ *
P0 拆分(2026-06-24 架构评审)后,「生产改写脚本重放」({@code ScriptReplayController})与
+ * 「开发任意脚本执行」({@code ScriptExecuteController},@Profile 旁路限定)共用本原语,避免重复。
+ */
+public final class ScriptFacadeRunner {
+
+ private ScriptFacadeRunner() {
+ }
+
+ /**
+ * 用 facade 动词表执行脚本,返回捕获的 amis 指令。
+ *
+ * @param key 缓存/诊断键(模板/序号派生),允许 null
+ * @param script 脚本正文
+ * @param item 当前行数据域(facade 动词读写)
+ */
+ public static List