openxiangda 1.0.270 → 1.0.271

package/packages/sdk/src/build-source/scripts/publish-all.mjs

@@ -99,6 +99,16 @@ const only = changedOnly
     : targetPage
       ? [`pages/${targetPage}`]
       : normalizeOnly(args.only);
+const stageOnlyPageRelease = process.env.OPENXIANGDA_PAGE_STAGE_ONLY === "1";
+if (
+  stageOnlyPageRelease &&
+  (only.length === 0 || only.some((target) => !target.startsWith("pages/")))
+) {
+  console.error(
+    "❌ PAGE_RELEASE_STAGE_SCOPE_REQUIRED: stage-only 页面发布必须使用 --page 或只包含 pages/* 的精确 --only 范围",
+  );
+  process.exit(1);
+}
 
 if (changedOnly && only.length === 0) {
   console.log("✅ 没有检测到 src/forms 或 src/pages 的 git 变更，跳过发布");
@@ -145,7 +155,10 @@ const publishLegacyFormBundle =
   Boolean(config.forms?.publishLegacyBundle);
 
 const allModules = discoverWorkspaceModules();
-const plan = planIncrementalPublish(allModules, { force, only });
+const plan = planIncrementalPublish(allModules, {
+  force: force || stageOnlyPageRelease,
+  only,
+});
 printPlan(plan, "publish-all");
 if (plan.changed.length === 0 && !force) {
   console.log("✅ 没有检测到变更，跳过发布");
@@ -177,11 +190,29 @@ for (const moduleItem of plan.changed) {
   } else if (moduleItem.kind === "pages") {
     await run("build-pages.mjs", ["--page", moduleItem.name, ...maybeForce]);
     await run("publish-oss.mjs", ["--page", moduleItem.name, ...maybeDryRun]);
-    await run("register.mjs", ["--page", moduleItem.name, ...maybeDryRun]);
+    if (!stageOnlyPageRelease) {
+      await run("register.mjs", ["--page", moduleItem.name, ...maybeDryRun]);
+    }
     publishedModules.push(moduleItem);
   }
 }
 
+if (stageOnlyPageRelease) {
+  const pageNames = publishedModules
+    .filter((moduleItem) => moduleItem.kind === "pages")
+    .map((moduleItem) => moduleItem.name);
+  if (pageNames.length === 0) {
+    throw new Error(
+      "PAGE_RELEASE_STAGE_SCOPE_REQUIRED: stage-only 页面发布没有可登记的精确页面",
+    );
+  }
+  await run("register.mjs", [
+    "--page-list-json",
+    JSON.stringify(pageNames),
+    ...maybeDryRun,
+  ]);
+}
+
 if (!dryRun) {
   commitIncrementalPublish(plan, publishedModules);
 }

package/packages/sdk/src/build-source/scripts/register.mjs

@@ -3,7 +3,9 @@
  */
 
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
+import { spawn } from "node:child_process";
 import { glob } from "glob";
 import minimist from "minimist";
 import {
@@ -31,6 +33,8 @@ const args = minimist(process.argv.slice(2).filter((arg) => arg !== "--"));
 const dryRun = Boolean(args["dry-run"]);
 const targetForm = args.form || null;
 const targetPage = args.page || null;
+const targetPageList = parsePageList(args["page-list-json"]);
+const stageOnlyPageRelease = process.env.OPENXIANGDA_PAGE_STAGE_ONLY === "1";
 const ensureExistingFormMenu =
   Boolean(args["ensure-menu"]) ||
   ["1", "true", "yes"].includes(
@@ -48,12 +52,36 @@ register - 注册应用工作区产物到平台
   --dry-run        只打印注册计划，不实际调用 API
   --form <name>    只注册指定表单
   --page <name>    只注册指定代码页目录
+  --page-list-json <JSON>  注册指定代码页目录数组（内部批量发布入口）
   --ensure-menu    已存在 formUuid 的表单也尝试补齐菜单
   --help, -h       显示帮助信息
 `);
   process.exit(0);
 }
 
+if (targetPage && targetPageList.length > 0) {
+  console.error("❌ --page 和 --page-list-json 不能同时使用");
+  process.exit(1);
+}
+
+function parsePageList(value) {
+  if (value === undefined || value === null || value === "") return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(String(value));
+  } catch (error) {
+    throw new Error(`PAGE_REGISTER_SCOPE_INVALID: page-list-json 不是合法 JSON: ${error.message}`);
+  }
+  if (!Array.isArray(parsed) || parsed.length === 0) {
+    throw new Error("PAGE_REGISTER_SCOPE_INVALID: page-list-json 必须是非空数组");
+  }
+  const normalized = parsed.map((item) => String(item || "").trim()).filter(Boolean);
+  if (normalized.length !== parsed.length || new Set(normalized).size !== normalized.length) {
+    throw new Error("PAGE_REGISTER_SCOPE_INVALID: page-list-json 包含空值或重复页面");
+  }
+  return normalized;
+}
+
 const config = await loadConfig();
 const apiBase = getApiBaseUrl(config);
 let accessToken = null;
@@ -251,7 +279,7 @@ function readFormRuntimeAssets(config) {
 }
 
 async function registerPages() {
-  const pages = await discoverPages(targetPage || "");
+  const pages = await discoverSelectedPages();
   if (pages.length === 0) {
     return { succeeded: 0, failed: 0 };
   }
@@ -265,6 +293,25 @@ async function registerPages() {
     return { succeeded: pages.length, failed: 0 };
   }
 
+  if (stageOnlyPageRelease) {
+    if (!isOpenXiangdaMode(config)) {
+      throw new Error(
+        "PAGE_RELEASE_STAGE_CONTEXT_REQUIRED: stage-only 页面发布只支持 OpenXiangda 模式",
+      );
+    }
+    if (!targetPage && targetPageList.length === 0) {
+      throw new Error(
+        "PAGE_RELEASE_STAGE_SCOPE_REQUIRED: stage-only 页面发布必须提供精确页面范围",
+      );
+    }
+    const data = await publishStagedPagesWithCurrentCli(payload);
+    data.items?.forEach((item) => {
+      console.log(`  ✓ 代码页 ${item.code} (${item.pageId})`);
+    });
+    writePagePublishResult(payload, { data }, false);
+    return { succeeded: pages.length, failed: 0 };
+  }
+
   const response = await fetch(getPagePublishUrl(payload.appType), {
     method: "POST",
     headers: {
@@ -293,6 +340,119 @@ async function registerPages() {
   return { succeeded: pages.length, failed: 0 };
 }
 
+async function discoverSelectedPages() {
+  if (targetPage) return discoverPages(targetPage);
+  const pages = await discoverPages("");
+  if (targetPageList.length === 0) return pages;
+  const byName = new Map();
+  for (const page of pages) {
+    byName.set(String(page.dirName || ""), page);
+    byName.set(String(page.config?.code || ""), page);
+  }
+  const missing = targetPageList.filter((name) => !byName.has(name));
+  if (missing.length > 0) {
+    throw new Error(`PAGE_REGISTER_SCOPE_INVALID: 找不到代码页 ${missing.join(",")}`);
+  }
+  return targetPageList.map((name) => byName.get(name));
+}
+
+async function publishStagedPagesWithCurrentCli(payload) {
+  const cli = String(process.env.OPENXIANGDA_CLI || "").trim();
+  const profile = String(config.openXiangdaProfile || process.env.OPENXIANGDA_PROFILE || "").trim();
+  const changeId = String(process.env.OPENXIANGDA_CHANGE_ID || "").trim();
+  if (!cli || !profile || !changeId) {
+    throw new Error(
+      "PAGE_RELEASE_STAGE_CONTEXT_REQUIRED: 缺少 OPENXIANGDA_CLI、OPENXIANGDA_PROFILE 或 OPENXIANGDA_CHANGE_ID",
+    );
+  }
+
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "openxiangda-page-stage-"));
+  const definitionsFile = path.join(tempDir, "pages.json");
+  try {
+    fs.writeFileSync(
+      definitionsFile,
+      `${JSON.stringify({ pages: payload.pages }, null, 2)}\n`,
+      { encoding: "utf8", mode: 0o600 },
+    );
+    const cliArgs = [
+      "page",
+      "publish",
+      "--pages-json",
+      definitionsFile,
+      "--version",
+      payload.version,
+      "--build-id",
+      payload.buildId,
+      "--profile",
+      profile,
+      "--change",
+      changeId,
+      "--json",
+    ];
+    if (config.openXiangdaTarget) {
+      cliArgs.push("--environment", config.openXiangdaTarget);
+    }
+    const result = await runCurrentOpenXiangdaCli(cli, cliArgs);
+    const selectedPageCodes = Array.isArray(result?.stagedResource?.metadata?.selectedPageCodes)
+      ? [...result.stagedResource.metadata.selectedPageCodes].sort()
+      : [];
+    const expectedPageCodes = payload.pages.map((page) => page.code).sort();
+    if (
+      result?.stagedResource?.kind !== "PageRelease" ||
+      selectedPageCodes.length !== expectedPageCodes.length ||
+      !expectedPageCodes.every((code, index) => code === selectedPageCodes[index])
+    ) {
+      throw new Error(
+        `PAGE_RELEASE_STAGE_SCOPE_MISMATCH: staged PageRelease 范围不匹配；expected=${expectedPageCodes.join(",")} actual=${selectedPageCodes.join(",") || "-"}`,
+      );
+    }
+    return result;
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+
+function runCurrentOpenXiangdaCli(cli, args) {
+  return new Promise((resolve, reject) => {
+    const command = cli.endsWith(".js") || cli.endsWith(".mjs") ? process.execPath : cli;
+    const commandArgs = command === process.execPath ? [cli, ...args] : args;
+    const child = spawn(command, commandArgs, {
+      cwd: rootDir,
+      env: process.env,
+      shell: false,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (chunk) => {
+      stdout += String(chunk);
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += String(chunk);
+    });
+    child.on("error", reject);
+    child.on("close", (code, signal) => {
+      if (signal || code !== 0) {
+        reject(
+          new Error(
+            `PAGE_RELEASE_STAGE_FAILED: 当前 OpenXiangda CLI 执行失败 (${signal || code}) ${stderr.trim() || stdout.trim()}`,
+          ),
+        );
+        return;
+      }
+      try {
+        resolve(JSON.parse(stdout));
+      } catch (error) {
+        reject(
+          new Error(
+            `PAGE_RELEASE_STAGE_RESULT_INVALID: CLI JSON 输出不可解析: ${error.message}`,
+          ),
+        );
+      }
+    });
+  });
+}
+
 function getPagePublishUrl(appType) {
   if (isOpenXiangdaMode(config)) {
     return `${apiBase}/openxiangda-api/v1/apps/${encodeURIComponent(appType)}/pages/publish`;

package/templates/openxiangda-react-spa/AGENTS.md

@@ -65,6 +65,8 @@ openxiangda commands --json
 
 未登记环境的旧工作区只有在平台已核验“精确非删除目标来自多次历史发布、无法对应单一 Git 基线”时，才可在同一条 `release publish` 上增加 `--adopt-online-baseline --adoption-reason "..."`。CLI 只把该意图传给精确 `resource publish --only/--code` 阶段；表单 ensure、Runtime 与 App finalize 不接收，原因不足或没有精确资源阶段会在获取租约前失败关闭。
 
+Legacy PageRelease 工作区的 `release publish` 会给 Page step 注入 `OPENXIANGDA_PAGE_STAGE_ONLY=1`，并要求当前包内 CLI 写入 staged PageRelease evidence；缺少证据时禁止 Root finalize。需要完整替换 Function/Automation manifest 时可成对增加 `--replace-manifest --reason "..."`，该权限只进入唯一的精确 Backend stage，不进入 Form、Page、Workflow 或 Root。
+
 模板已停用无范围的 `pnpm deploy` 聚合入口。日常变更必须使用 `resource plan|publish <type> --only <codes>`（单资源可用 `--code <code>`）。Form bundle、Backend Release 和 Runtime 都先暂存；CLI 会按 `--change` 自动聚合 `.openxiangda/releases/<change>/staged-resources.json`，最后只由一次 Root App finalize 原子激活。Form Release 一旦 abort 绝不能作为幂等结果复用；重新执行相同精确表单发布时，CLI 会淘汰旧 staged 索引，平台会创建新的不可变 attempt，再由 Root App 一次事务重试。相同 change 的既有 staged FormRelease 只有在 CLI 重新核验服务端不可变状态、identity/hash、冻结 schema/formType、finalized 资源、parent/base revision 和当前 Form Head 后，才可重挂接到新的 baseline/session；`schemaSyncedAt` 只是本地缓存元数据。禁止伪造它、提前激活 Form 或用顺序激活多张表单绕过失败。不要使用 `workspace publish --form`、单独 `runtime activate`、`pnpm publish:all`、`pnpm openxiangda:publish` 或 `lowcode-workspace publish-all`。
 
 同一发布同时包含 Form 设置和表单权限组时，必须由一条 `resource publish form-setting,form-permission-group` 命令暂存，并在 `--only` 中分别使用 `form-setting:<code>`、`form-permission-group:<code>`。SDD bundle 与 prepublish 校验使用同一精确契约；缺失、夹带、拆成两个 FormRelease 或提前激活都应失败关闭。

package/templates/sy-lowcode-app-workspace/AGENTS.md

@@ -69,7 +69,7 @@ Delivery V2 自动从期望状态按资源指纹计算精确范围，使用 CLI
 - ✅ Function/Automation 使用 Backend Release v2；正式多资源发布用精确 `--only/--code` 加 `--stage-only` 暂存，同一 child 可混合源码 create、无 `sourceFile` 的完整 v3 声明式 Automation manifest create、source-only update 和显式 manifest replacement，再由 Root App finalize 原子激活。声明式 create 自动选路；替换已有资源的整包 manifest 才需要另加 `--replace-manifest --reason "..."`。clone primary 与冻结仓库 ID 不同时，只有冻结 ID 已存在于 `repoAliases` 才会统一用于 Backend/Workflow/Root App Release；无交集继续失败关闭。
 - ✅ 相同 change 已有 staged FormRelease 时，不要直发 schema、伪造 `schemaSyncedAt` 或提前激活 Form。CLI 只在重新核验服务端不可变状态、identity/hash、冻结 schema/formType、finalized 资源、parent/base revision 与当前 Form Head 后，才将 child 重挂接到新的 baseline/session；冲突继续失败关闭。
 - ✅ 同一发布同时包含 Form 设置和表单权限组时，必须使用一条 `resource publish form-setting,form-permission-group`，并以 `form-setting:<code>`、`form-permission-group:<code>` 精确限定 `--only`；SDD bundle 与 prepublish 校验共享该契约，禁止缺失、夹带、拆分发布或提前激活。
-- ✅ 未登记环境的旧工作区，正式 promotion 先聚合 mainline bundle 并 commit/push，再运行 `release publish --change <id> --profile <name>`。平台核验精确非删除目标来自多次历史 lineage 后，可成对增加 `--adopt-online-baseline --adoption-reason "..."`；参数只进入精确 `resource publish --only/--code` 阶段，不进入 ensure、Runtime 或 App finalize，无精确资源范围时在获取租约前失败关闭。
+- ✅ 未登记环境的旧工作区，正式 promotion 先聚合 mainline bundle 并 commit/push，再运行 `release publish --change <id> --profile <name>`。Legacy Page step 必须遵守 CLI 注入的 `OPENXIANGDA_PAGE_STAGE_ONLY=1` 并通过当前包内 CLI 登记 staged PageRelease；缺少证据时 Root finalize 会失败关闭。平台核验精确非删除目标来自多次历史 lineage 后，可成对增加 `--adopt-online-baseline --adoption-reason "..."`；参数只进入精确 `resource publish --only/--code` 阶段。需要完整替换 Function/Automation manifest 时可成对增加 `--replace-manifest --reason "..."`，只进入唯一的精确 Backend stage。上述参数不进入 ensure、Page 或 App finalize，无兼容精确范围时在获取租约前失败关闭。
 - ✅ 旧工作区已有 Root、且操作者明确授权无条件恢复时，可执行 `release app-activate <releaseId> --force-activate-without-validation --profile <name>`。该命令不读取 detail/capture，不要求 change、租约、baseline、源码 lineage、状态、parent、hash、resource head 或环境发布门禁；服务端直接在目标 tenant/appType 内以单事务切换 Root 与可识别的 staged children。
 - ✅ 已通过 `environment init` 或 `environment attach` 接入的工作区使用 `release ship`，始终按 candidate → preproduction → production 执行。日常首条命令在预发停止，后续 `--confirm-production` 晋级；用户明确授权紧急发布时，首条命令可携带 `--confirm-production` 在一个命令内顺序完成两阶段，但不跳过预发、证据、CAS 或确认。candidate 封存源码、public、构建配置/脚本、稳定环境/资源绑定和两目标 Runtime 哈希产物；部署不现场重建，Backend/Runtime/Root 子发布始终使用 candidate sourceRevision，并将两条服务端 deployment 闭环为 `succeeded`。两套环境身份仍完全隔离，人工验收建议和 swap/policy/权限门禁保持不变。
 - ✅ DataView `status` 仅是平台生命周期观察值；同一托管部署导致的 `active → draft → active` 不应让候选失效。`dataViewId`、`materializedViewName`、`storageMode`、其他资源状态、哈希、环境身份、CAS、租约和来源主线仍严格校验。