@liujitcn/kratos-uni-app-core 0.0.18 → 0.0.20

package/dist/vite.mjs

@@ -16,15 +16,16 @@ import { dirname, isAbsolute, relative, resolve } from "node:path";
 import uniPlugin from "@dcloudio/vite-plugin-uni";
 import { defineConfig, loadEnv } from "vite";
 var sourceVersionCounter = 0;
+var PAGE_ASSEMBLY_WAIT_TIMEOUT_MS = 3e4;
+var PAGE_ASSEMBLY_POLL_INTERVAL_MS = 25;
 function createKratosUniPlugin() {
+  recoverStalePageTransaction();
   const createPlugin = typeof uniPlugin === "function" ? uniPlugin : uniPlugin.default;
   return createPlugin();
 }
 function kratosApp(options) {
   const sourceVersion = `${process.pid}-${Date.now()}-${++sourceVersionCounter}`;
   const state = {
-    generatedFiles: [],
-    generatedStaticFiles: [],
     cleaned: false,
     persistent: false,
     moduleRoots: /* @__PURE__ */ new Map()
@@ -36,20 +37,11 @@ function kratosApp(options) {
     process.removeListener("exit", cleanup);
     process.removeListener("SIGINT", handleSigint);
     process.removeListener("SIGTERM", handleSigterm);
-    for (const file of [...state.generatedFiles].reverse()) {
-      if (existsSync(file))
-        unlinkSync(file);
-      removeEmptyParents(dirname(file), state.inputDir ?? "");
-    }
-    if (state.inputDir) {
-      removeGeneratedStaticFiles(state.generatedStaticFiles, resolve(state.inputDir, "static"));
-    }
-    if (state.pagesFile && state.originalPages !== void 0) {
+    if (state.transactionFile && state.leaseFile) {
+      releasePageAssembly(state.transactionFile, state.leaseFile);
+    } else if (state.pagesFile && state.originalPages !== void 0) {
       writeFileSync(state.pagesFile, state.originalPages);
     }
-    if (state.transactionFile && existsSync(state.transactionFile)) {
-      unlinkSync(state.transactionFile);
-    }
   };
   const handleSigint = () => {
     cleanup();
@@ -129,11 +121,8 @@ function kratosApp(options) {
       const inputDir = process.env.UNI_INPUT_DIR || resolve(process.cwd(), "src");
       const pagesFile = resolve(inputDir, "pages.json");
       const transactionFile = resolve(inputDir, "../.kratos-uni-app-pages-state.json");
-      recoverBuildTransaction(transactionFile, inputDir, pagesFile);
       const hostRequire = createRequire(resolve(inputDir, "../package.json"));
       const originalPages = readFileSync(pagesFile, "utf8");
-      const manifest = JSON.parse(originalPages);
-      manifest.pages ??= [];
       const pageMap = /* @__PURE__ */ new Map();
       const moduleRoots = options.modules.map((module) => {
         const linkedRoot = resolve(inputDir, "../node_modules", ...module.name.split("/"));
@@ -154,48 +143,19 @@ function kratosApp(options) {
           });
         });
       });
-      state.inputDir = inputDir;
       state.pagesFile = pagesFile;
-      state.originalPages = originalPages;
       state.transactionFile = transactionFile;
-      state.generatedFiles = [...pageMap.values()].map((page) => resolve(inputDir, `${page.route}.vue`)).filter((target) => !existsSync(target));
-      const staticTarget = resolve(inputDir, "static");
-      const staticFiles = collectModuleStaticFiles(
-        moduleRoots.map(({ root }) => resolve(root, "src/static")),
-        staticTarget
-      );
-      state.generatedStaticFiles = staticFiles.map(({ target }) => target);
-      writeFileSync(
+      const pageAssembly = preparePageAssembly({
+        inputDir,
+        pagesFile,
         transactionFile,
-        `${JSON.stringify(
-          {
-            inputDir,
-            pagesFile,
-            originalPages,
-            generatedFiles: state.generatedFiles,
-            generatedStaticFiles: state.generatedStaticFiles,
-            ownerPid: process.pid
-          },
-          null,
-          2
-        )}
-`,
-        { flag: "wx" }
-      );
-      pageMap.forEach((page) => {
-        const target = resolve(inputDir, `${page.route}.vue`);
-        if (existsSync(target))
-          return;
-        mkdirSync(dirname(target), { recursive: true });
-        writeFileSync(target, createPageWrapper(page));
-        appendPage(manifest, page);
-      });
-      staticFiles.forEach(({ source, target }) => {
-        mkdirSync(dirname(target), { recursive: true });
-        copyFileSync(source, target);
+        originalPages,
+        moduleRoots,
+        pageMap: [...pageMap.values()],
+        sourceVersion
       });
-      writeFileSync(pagesFile, `${JSON.stringify(manifest, null, 2)}
-`);
+      state.originalPages = pageAssembly.transaction.originalPages;
+      state.leaseFile = pageAssembly.leaseFile;
       process.once("exit", cleanup);
       process.prependOnceListener("SIGINT", handleSigint);
       process.prependOnceListener("SIGTERM", handleSigterm);
@@ -233,29 +193,233 @@ function kratosApp(options) {
     closeWatcher: cleanup
   };
 }
-function recoverBuildTransaction(transactionFile, inputDir, pagesFile) {
+function preparePageAssembly(options) {
+  const lockFile = `${options.transactionFile}.lock`;
+  acquirePageAssemblyLock(lockFile);
+  try {
+    let transaction = readBuildTransaction(
+      options.transactionFile,
+      options.inputDir,
+      options.pagesFile
+    );
+    if (transaction && isPageAssemblyActive(transaction)) {
+      return {
+        transaction,
+        leaseFile: createPageAssemblyLease(options.transactionFile, options.sourceVersion)
+      };
+    }
+    let originalPages = options.originalPages;
+    if (transaction) {
+      originalPages = transaction.originalPages;
+      restoreBuildTransaction(transaction, options.transactionFile);
+    }
+    const manifest = JSON.parse(originalPages);
+    manifest.pages ??= [];
+    const generatedFiles = options.pageMap.map((page) => resolve(options.inputDir, `${page.route}.vue`)).filter((target) => !existsSync(target));
+    const staticTarget = resolve(options.inputDir, "static");
+    const staticFiles = collectModuleStaticFiles(
+      options.moduleRoots.map(({ root }) => resolve(root, "src/static")),
+      staticTarget
+    );
+    const generatedStaticFiles = staticFiles.map(({ target }) => target);
+    transaction = {
+      inputDir: options.inputDir,
+      pagesFile: options.pagesFile,
+      originalPages,
+      generatedFiles,
+      generatedStaticFiles,
+      ownerPid: process.pid,
+      ready: false
+    };
+    writeBuildTransaction(options.transactionFile, transaction, "wx");
+    const leaseFile = createPageAssemblyLease(options.transactionFile, options.sourceVersion);
+    try {
+      options.pageMap.forEach((page) => {
+        const target = resolve(options.inputDir, `${page.route}.vue`);
+        if (existsSync(target))
+          return;
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, createPageWrapper(page));
+        appendPage(manifest, page);
+      });
+      staticFiles.forEach(({ source, target }) => {
+        mkdirSync(dirname(target), { recursive: true });
+        copyFileSync(source, target);
+      });
+      writeFileSync(options.pagesFile, `${JSON.stringify(manifest, null, 2)}
+`);
+      transaction.ready = true;
+      writeBuildTransaction(options.transactionFile, transaction);
+      return { transaction, leaseFile };
+    } catch (error) {
+      releasePageAssemblyLease(leaseFile);
+      restoreBuildTransaction(transaction, options.transactionFile);
+      throw error;
+    }
+  } finally {
+    releasePageAssemblyLock(lockFile);
+  }
+}
+function readBuildTransaction(transactionFile, inputDir, pagesFile) {
   if (!existsSync(transactionFile))
     return;
   const transaction = JSON.parse(readFileSync(transactionFile, "utf8"));
   if (transaction.inputDir !== inputDir || transaction.pagesFile !== pagesFile) {
     throw new Error(`uni-app \u6784\u5EFA\u4E8B\u52A1\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A${transactionFile}`);
   }
-  if (transaction.ownerPid !== void 0 && transaction.ownerPid !== process.pid && isProcessRunning(transaction.ownerPid)) {
-    throw new Error(
-      `\u9875\u9762\u88C5\u914D\u5DF2\u7531\u8FDB\u7A0B ${transaction.ownerPid} \u4F7F\u7528\uFF0C\u8BF7\u5148\u505C\u6B62\u53E6\u4E00\u4E2A H5 \u6216\u5C0F\u7A0B\u5E8F\u5F00\u53D1\u8FDB\u7A0B`
-    );
-  }
+  return transaction;
+}
+function writeBuildTransaction(transactionFile, transaction, flag) {
+  writeFileSync(
+    transactionFile,
+    `${JSON.stringify(transaction, null, 2)}
+`,
+    flag ? { flag } : void 0
+  );
+}
+function restoreBuildTransaction(transaction, transactionFile) {
   for (const file of [...transaction.generatedFiles].reverse()) {
     if (existsSync(file))
       unlinkSync(file);
-    removeEmptyParents(dirname(file), inputDir);
+    removeEmptyParents(dirname(file), transaction.inputDir);
   }
-  removeGeneratedStaticFiles(transaction.generatedStaticFiles ?? [], resolve(inputDir, "static"));
+  removeGeneratedStaticFiles(
+    transaction.generatedStaticFiles ?? [],
+    resolve(transaction.inputDir, "static")
+  );
   if (transaction.generatedStatic && transaction.generatedStaticFiles === void 0) {
-    rmSync(resolve(inputDir, "static"), { recursive: true, force: true });
+    rmSync(resolve(transaction.inputDir, "static"), { recursive: true, force: true });
+  }
+  writeFileSync(transaction.pagesFile, transaction.originalPages);
+  if (existsSync(transactionFile))
+    unlinkSync(transactionFile);
+}
+function releasePageAssembly(transactionFile, leaseFile) {
+  releasePageAssemblyLease(leaseFile);
+  const lockFile = `${transactionFile}.lock`;
+  acquirePageAssemblyLock(lockFile);
+  try {
+    if (!existsSync(transactionFile))
+      return;
+    const transaction = JSON.parse(readFileSync(transactionFile, "utf8"));
+    const current = readBuildTransaction(
+      transactionFile,
+      transaction.inputDir,
+      transaction.pagesFile
+    );
+    if (!current || isPageAssemblyActive(current))
+      return;
+    restoreBuildTransaction(current, transactionFile);
+  } finally {
+    releasePageAssemblyLock(lockFile);
+  }
+}
+function createPageAssemblyLease(transactionFile, sourceVersion) {
+  const leaseDirectory = `${transactionFile}.leases`;
+  mkdirSync(leaseDirectory, { recursive: true });
+  const leaseFile = resolve(leaseDirectory, `${process.pid}-${sourceVersion}.lease`);
+  writeFileSync(leaseFile, `${JSON.stringify({ ownerPid: process.pid })}
+`, { flag: "wx" });
+  return leaseFile;
+}
+function releasePageAssemblyLease(leaseFile) {
+  if (existsSync(leaseFile))
+    unlinkSync(leaseFile);
+  const leaseDirectory = dirname(leaseFile);
+  if (existsSync(leaseDirectory) && !readdirSync(leaseDirectory).length) {
+    try {
+      rmdirSync(leaseDirectory);
+    } catch (error) {
+      const code = error.code;
+      if (code !== "ENOTEMPTY" && code !== "EEXIST")
+        throw error;
+    }
+  }
+}
+function isPageAssemblyActive(transaction) {
+  const leaseDirectory = resolve(
+    dirname(transaction.pagesFile),
+    "../.kratos-uni-app-pages-state.json.leases"
+  );
+  if (listActivePageLeases(leaseDirectory).length)
+    return true;
+  return transaction.ownerPid !== void 0 && transaction.ownerPid !== process.pid && isProcessRunning(transaction.ownerPid);
+}
+function listActivePageLeases(leaseDirectory) {
+  if (!existsSync(leaseDirectory))
+    return [];
+  const activePids = [];
+  for (const entry of readdirSync(leaseDirectory)) {
+    const leaseFile = resolve(leaseDirectory, entry);
+    try {
+      const lease = JSON.parse(readFileSync(leaseFile, "utf8"));
+      if (lease.ownerPid && isProcessRunning(lease.ownerPid)) {
+        activePids.push(lease.ownerPid);
+      } else {
+        unlinkSync(leaseFile);
+      }
+    } catch {
+      unlinkSync(leaseFile);
+    }
   }
-  writeFileSync(pagesFile, transaction.originalPages);
-  unlinkSync(transactionFile);
+  return activePids;
+}
+function acquirePageAssemblyLock(lockFile) {
+  const deadline = Date.now() + PAGE_ASSEMBLY_WAIT_TIMEOUT_MS;
+  while (true) {
+    try {
+      writeFileSync(lockFile, `${JSON.stringify({ ownerPid: process.pid })}
+`, { flag: "wx" });
+      return;
+    } catch (error) {
+      if (error.code !== "EEXIST")
+        throw error;
+      const ownerPid = readPageAssemblyLockOwner(lockFile);
+      if (ownerPid !== void 0 && !isProcessRunning(ownerPid)) {
+        unlinkSync(lockFile);
+        continue;
+      }
+      if (Date.now() >= deadline) {
+        throw new Error(`\u7B49\u5F85 uni-app \u9875\u9762\u88C5\u914D\u9501\u8D85\u65F6\uFF1A${lockFile}`);
+      }
+      waitForPageAssembly(PAGE_ASSEMBLY_POLL_INTERVAL_MS);
+    }
+  }
+}
+function releasePageAssemblyLock(lockFile) {
+  if (!existsSync(lockFile))
+    return;
+  if (readPageAssemblyLockOwner(lockFile) === process.pid)
+    unlinkSync(lockFile);
+}
+function readPageAssemblyLockOwner(lockFile) {
+  try {
+    return JSON.parse(readFileSync(lockFile, "utf8")).ownerPid;
+  } catch {
+    return;
+  }
+}
+function waitForPageAssembly(milliseconds) {
+  const buffer = new SharedArrayBuffer(4);
+  Atomics.wait(new Int32Array(buffer), 0, 0, milliseconds);
+}
+function recoverStalePageTransaction() {
+  const inputDir = process.env.UNI_INPUT_DIR || resolve(process.cwd(), "src");
+  const transactionFile = resolve(inputDir, "../.kratos-uni-app-pages-state.json");
+  const pagesFile = resolve(inputDir, "pages.json");
+  const lockFile = `${transactionFile}.lock`;
+  acquirePageAssemblyLock(lockFile);
+  try {
+    recoverBuildTransaction(transactionFile, inputDir, pagesFile);
+  } finally {
+    releasePageAssemblyLock(lockFile);
+  }
+}
+function recoverBuildTransaction(transactionFile, inputDir, pagesFile) {
+  const transaction = readBuildTransaction(transactionFile, inputDir, pagesFile);
+  if (!transaction || isPageAssemblyActive(transaction))
+    return;
+  restoreBuildTransaction(transaction, transactionFile);
 }
 function isProcessRunning(pid) {
   try {
@@ -337,14 +501,16 @@ function appendPage(manifest, page) {
 function createPageWrapper(page) {
   const source = page.source.replace(/\\/g, "/");
   return `<script setup lang="ts">
+import type { Component } from 'vue'
 import KratosPage from ${JSON.stringify(source)}
 import KratosTabBar from '@liujitcn/kratos-uni-app-core/components/KratosTabBar.vue'
 
 defineOptions({ inheritAttrs: false })
+const Page = KratosPage as Component
 </script>
 
 <template>
-  <KratosPage />
+  <Page v-bind="$attrs" />
   <KratosTabBar route=${JSON.stringify(page.route)} />
 </template>
 `;
@@ -401,5 +567,6 @@ export {
   createKratosUniPlugin,
   defineConfig,
   kratosApp,
-  loadEnv
+  loadEnv,
+  recoverStalePageTransaction
 };

package/package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git@github.com:liujitcn/kratos-admin.git"
   },
-  "version": "0.0.18",
+  "version": "0.0.20",
   "type": "module",
   "files": [
     "dist",

package/src/navigation-tree.d.mts

@@ -0,0 +1,14 @@
+export interface MenuNode<T extends { id: number; parentId?: number }> extends T {
+  children: MenuNode<T>[]
+}
+
+export function buildMenuTree<T extends { id: number; parentId?: number }>(
+  menus: readonly T[],
+  rootId: number,
+): MenuNode<T>[]
+
+export function resolveRootMenuId(
+  menus: readonly { id: number; parentId?: number }[],
+  menuId: number,
+  rootId: number,
+): number | undefined

package/src/rpc/base/v1/config.ts

@@ -5,7 +5,7 @@
 // source: base/v1/config.proto
 
 /* eslint-disable */
-import type { BaseConfigSite } from "../../common/v1/enum";
+import type { BaseConfigSite } from "./enum";
 
 /** 获取系统配置条件 */
 export interface GetConfigRequest {

package/src/rpc/{common → base}/v1/enum.ts

@@ -2,17 +2,30 @@
 // versions:
 //   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
-// source: common/v1/enum.proto
+// source: base/v1/enum.proto
 
 /* eslint-disable */
 
-/** 状态 */
-export enum Status {
-  UNKNOWN = 0,
-  /** ENABLE - 启用 */
-  ENABLE = 1,
-  /** DISABLE - 禁用 */
-  DISABLE = 2,
+/** AI 助手消息状态 */
+export enum AiMessageStatus {
+  /** UNKNOWN_AMS - 未知AI助手消息状态 */
+  UNKNOWN_AMS = 0,
+  /** GENERATING_AMS - 生成中 */
+  GENERATING_AMS = 1,
+  /** SUCCESS_AMS - 成功 */
+  SUCCESS_AMS = 2,
+  /** FAILED_AMS - 失败 */
+  FAILED_AMS = 3,
+}
+
+/** 终端类型 */
+export enum Terminal {
+  /** UNKNOWN_TERMINAL - 未知终端 */
+  UNKNOWN_TERMINAL = 0,
+  /** TERMINAL_APP - 移动端 */
+  TERMINAL_APP = 1,
+  /** TERMINAL_ADMIN - 管理端 */
+  TERMINAL_ADMIN = 2,
 }
 
 /** 系统配置位置 */
@@ -39,33 +52,3 @@ export enum PasswordCryptoScene {
   /** UPDATE_USER_PASSWORD - 个人修改密码加密场景 */
   UPDATE_USER_PASSWORD = 4,
 }
-
-/** AI 助手消息状态 */
-export enum AiMessageStatus {
-  /** UNKNOWN_AAMS - 未知AI助手消息状态 */
-  UNKNOWN_AAMS = 0,
-  /** GENERATING_AAMS - 生成中 */
-  GENERATING_AAMS = 1,
-  /** SUCCESS_AAMS - 成功 */
-  SUCCESS_AAMS = 2,
-  /** FAILED_AAMS - 失败 */
-  FAILED_AAMS = 3,
-}
-
-/** 支付通知资源类型 */
-export enum ResourceType {
-  /** TRANSACTION - 支付 */
-  TRANSACTION = 0,
-  /** REFUND - 退款 */
-  REFUND = 1,
-}
-
-/** 终端类型 */
-export enum Terminal {
-  /** TERMINAL_UNSPECIFIED - 未知终端 */
-  TERMINAL_UNSPECIFIED = 0,
-  /** TERMINAL_APP - 移动端 */
-  TERMINAL_APP = 1,
-  /** TERMINAL_ADMIN - 管理端 */
-  TERMINAL_ADMIN = 2,
-}

package/src/rpc/base/v1/login.ts

@@ -5,9 +5,9 @@
 // source: base/v1/login.proto
 
 /* eslint-disable */
-import type { PasswordCryptoScene } from "../../common/v1/enum";
 import type { PasswordCrypto } from "../../common/v1/types";
 import type { Empty } from "../../google/protobuf/empty";
+import type { PasswordCryptoScene } from "./enum";
 
 /** 验证码获取条件 */
 export interface CaptchaRequest {

package/src/stores/modules/setting.ts

@@ -1,7 +1,7 @@
 import { defConfigService } from '../../api/base/config'
 import { defineStore } from 'pinia'
 import { ref } from 'vue'
-import { BaseConfigSite } from '../../rpc/common/v1/enum'
+import { BaseConfigSite } from '../../rpc/base/v1/enum'
 
 const REQUIRED_APP_CONFIGS = [
   { key: 'serviceProtocol', name: '服务条款' },

package/src/utils/passwordCrypto.ts

@@ -1,5 +1,5 @@
 import { defLoginService } from '../api/base/login'
-import { PasswordCryptoScene } from '../rpc/common/v1/enum'
+import { PasswordCryptoScene } from '../rpc/base/v1/enum'
 import type { PasswordCrypto } from '../rpc/common/v1/types'
 
 // #ifdef MP-WEIXIN

package/src/vite.ts

@@ -41,8 +41,17 @@ type BuildTransaction = {
   generatedStaticFiles: string[]
   generatedStatic?: boolean
   ownerPid?: number
+  ready?: boolean
 }
 
+type PageAssembly = {
+  transaction: BuildTransaction
+  leaseFile: string
+}
+
+const PAGE_ASSEMBLY_WAIT_TIMEOUT_MS = 30_000
+const PAGE_ASSEMBLY_POLL_INTERVAL_MS = 25
+
 /** uni-app Vite 插件参数。 */
 export interface KratosAppViteOptions {
   /** 宿主模块清单，顺序同时决定覆盖优先级。 */
@@ -51,6 +60,7 @@ export interface KratosAppViteOptions {
 
 /** 创建 uni-app 官方 Vite 插件。 */
 export function createKratosUniPlugin() {
+  recoverStalePageTransaction()
   const createPlugin =
     typeof uniPlugin === 'function'
       ? uniPlugin
@@ -62,18 +72,14 @@ export function createKratosUniPlugin() {
 export function kratosApp(options: KratosAppViteOptions): Plugin {
   const sourceVersion = `${process.pid}-${Date.now()}-${++sourceVersionCounter}`
   const state: {
-    inputDir?: string
     pagesFile?: string
     originalPages?: string
-    generatedFiles: string[]
-    generatedStaticFiles: string[]
     cleaned: boolean
     persistent: boolean
     transactionFile?: string
+    leaseFile?: string
     moduleRoots: Map<string, string>
   } = {
-    generatedFiles: [],
-    generatedStaticFiles: [],
     cleaned: false,
     persistent: false,
     moduleRoots: new Map(),
@@ -85,19 +91,11 @@ export function kratosApp(options: KratosAppViteOptions): Plugin {
     process.removeListener('exit', cleanup)
     process.removeListener('SIGINT', handleSigint)
     process.removeListener('SIGTERM', handleSigterm)
-    for (const file of [...state.generatedFiles].reverse()) {
-      if (existsSync(file)) unlinkSync(file)
-      removeEmptyParents(dirname(file), state.inputDir ?? '')
-    }
-    if (state.inputDir) {
-      removeGeneratedStaticFiles(state.generatedStaticFiles, resolve(state.inputDir, 'static'))
-    }
-    if (state.pagesFile && state.originalPages !== undefined) {
+    if (state.transactionFile && state.leaseFile) {
+      releasePageAssembly(state.transactionFile, state.leaseFile)
+    } else if (state.pagesFile && state.originalPages !== undefined) {
       writeFileSync(state.pagesFile, state.originalPages)
     }
-    if (state.transactionFile && existsSync(state.transactionFile)) {
-      unlinkSync(state.transactionFile)
-    }
   }
   const handleSigint = () => {
     cleanup()
@@ -184,11 +182,8 @@ export function kratosApp(options: KratosAppViteOptions): Plugin {
       const inputDir = process.env.UNI_INPUT_DIR || resolve(process.cwd(), 'src')
       const pagesFile = resolve(inputDir, 'pages.json')
       const transactionFile = resolve(inputDir, '../.kratos-uni-app-pages-state.json')
-      recoverBuildTransaction(transactionFile, inputDir, pagesFile)
       const hostRequire = createRequire(resolve(inputDir, '../package.json'))
       const originalPages = readFileSync(pagesFile, 'utf8')
-      const manifest = JSON.parse(originalPages) as PagesManifest
-      manifest.pages ??= []
       const pageMap = new Map<string, ScannedPage>()
       const moduleRoots = options.modules.map((module) => {
         const linkedRoot = resolve(inputDir, '../node_modules', ...module.name.split('/'))
@@ -213,48 +208,19 @@ export function kratosApp(options: KratosAppViteOptions): Plugin {
         })
       })
 
-      state.inputDir = inputDir
       state.pagesFile = pagesFile
-      state.originalPages = originalPages
       state.transactionFile = transactionFile
-      state.generatedFiles = [...pageMap.values()]
-        .map((page) => resolve(inputDir, `${page.route}.vue`))
-        .filter((target) => !existsSync(target))
-      const staticTarget = resolve(inputDir, 'static')
-      const staticFiles = collectModuleStaticFiles(
-        moduleRoots.map(({ root }) => resolve(root, 'src/static')),
-        staticTarget,
-      )
-      state.generatedStaticFiles = staticFiles.map(({ target }) => target)
-      writeFileSync(
+      const pageAssembly = preparePageAssembly({
+        inputDir,
+        pagesFile,
         transactionFile,
-        `${JSON.stringify(
-          {
-            inputDir,
-            pagesFile,
-            originalPages,
-            generatedFiles: state.generatedFiles,
-            generatedStaticFiles: state.generatedStaticFiles,
-            ownerPid: process.pid,
-          } satisfies BuildTransaction,
-          null,
-          2,
-        )}\n`,
-        { flag: 'wx' },
-      )
-      pageMap.forEach((page) => {
-        const target = resolve(inputDir, `${page.route}.vue`)
-        if (existsSync(target)) return
-        mkdirSync(dirname(target), { recursive: true })
-        writeFileSync(target, createPageWrapper(page))
-        appendPage(manifest, page)
-      })
-
-      staticFiles.forEach(({ source, target }) => {
-        mkdirSync(dirname(target), { recursive: true })
-        copyFileSync(source, target)
+        originalPages,
+        moduleRoots,
+        pageMap: [...pageMap.values()],
+        sourceVersion,
       })
-      writeFileSync(pagesFile, `${JSON.stringify(manifest, null, 2)}\n`)
+      state.originalPages = pageAssembly.transaction.originalPages
+      state.leaseFile = pageAssembly.leaseFile
       process.once('exit', cleanup)
       process.prependOnceListener('SIGINT', handleSigint)
       process.prependOnceListener('SIGTERM', handleSigterm)
@@ -292,36 +258,260 @@ export function kratosApp(options: KratosAppViteOptions): Plugin {
   }
 }
 
-function recoverBuildTransaction(
+function preparePageAssembly(options: {
+  inputDir: string
+  pagesFile: string
+  transactionFile: string
+  originalPages: string
+  moduleRoots: Array<{ root: string }>
+  pageMap: ScannedPage[]
+  sourceVersion: string
+}): PageAssembly {
+  const lockFile = `${options.transactionFile}.lock`
+  acquirePageAssemblyLock(lockFile)
+  try {
+    let transaction = readBuildTransaction(
+      options.transactionFile,
+      options.inputDir,
+      options.pagesFile,
+    )
+    if (transaction && isPageAssemblyActive(transaction)) {
+      return {
+        transaction,
+        leaseFile: createPageAssemblyLease(options.transactionFile, options.sourceVersion),
+      }
+    }
+
+    let originalPages = options.originalPages
+    if (transaction) {
+      originalPages = transaction.originalPages
+      restoreBuildTransaction(transaction, options.transactionFile)
+    }
+
+    const manifest = JSON.parse(originalPages) as PagesManifest
+    manifest.pages ??= []
+    const generatedFiles = options.pageMap
+      .map((page) => resolve(options.inputDir, `${page.route}.vue`))
+      .filter((target) => !existsSync(target))
+    const staticTarget = resolve(options.inputDir, 'static')
+    const staticFiles = collectModuleStaticFiles(
+      options.moduleRoots.map(({ root }) => resolve(root, 'src/static')),
+      staticTarget,
+    )
+    const generatedStaticFiles = staticFiles.map(({ target }) => target)
+    transaction = {
+      inputDir: options.inputDir,
+      pagesFile: options.pagesFile,
+      originalPages,
+      generatedFiles,
+      generatedStaticFiles,
+      ownerPid: process.pid,
+      ready: false,
+    }
+    writeBuildTransaction(options.transactionFile, transaction, 'wx')
+    const leaseFile = createPageAssemblyLease(options.transactionFile, options.sourceVersion)
+    try {
+      options.pageMap.forEach((page) => {
+        const target = resolve(options.inputDir, `${page.route}.vue`)
+        if (existsSync(target)) return
+        mkdirSync(dirname(target), { recursive: true })
+        writeFileSync(target, createPageWrapper(page))
+        appendPage(manifest, page)
+      })
+
+      staticFiles.forEach(({ source, target }) => {
+        mkdirSync(dirname(target), { recursive: true })
+        copyFileSync(source, target)
+      })
+      writeFileSync(options.pagesFile, `${JSON.stringify(manifest, null, 2)}\n`)
+      transaction.ready = true
+      writeBuildTransaction(options.transactionFile, transaction)
+      return { transaction, leaseFile }
+    } catch (error) {
+      releasePageAssemblyLease(leaseFile)
+      restoreBuildTransaction(transaction, options.transactionFile)
+      throw error
+    }
+  } finally {
+    releasePageAssemblyLock(lockFile)
+  }
+}
+
+function readBuildTransaction(
   transactionFile: string,
   inputDir: string,
   pagesFile: string,
-): void {
+): BuildTransaction | undefined {
   if (!existsSync(transactionFile)) return
   const transaction = JSON.parse(readFileSync(transactionFile, 'utf8')) as BuildTransaction
   if (transaction.inputDir !== inputDir || transaction.pagesFile !== pagesFile) {
     throw new Error(`uni-app 构建事务目录不匹配：${transactionFile}`)
   }
-  if (
-    transaction.ownerPid !== undefined &&
-    transaction.ownerPid !== process.pid &&
-    isProcessRunning(transaction.ownerPid)
-  ) {
-    throw new Error(
-      `页面装配已由进程 ${transaction.ownerPid} 使用，请先停止另一个 H5 或小程序开发进程`,
-    )
-  }
+  return transaction
+}
+
+function writeBuildTransaction(
+  transactionFile: string,
+  transaction: BuildTransaction,
+  flag?: 'wx',
+): void {
+  writeFileSync(
+    transactionFile,
+    `${JSON.stringify(transaction, null, 2)}\n`,
+    flag ? { flag } : undefined,
+  )
+}
+
+function restoreBuildTransaction(transaction: BuildTransaction, transactionFile: string): void {
   for (const file of [...transaction.generatedFiles].reverse()) {
     if (existsSync(file)) unlinkSync(file)
-    removeEmptyParents(dirname(file), inputDir)
+    removeEmptyParents(dirname(file), transaction.inputDir)
   }
-  removeGeneratedStaticFiles(transaction.generatedStaticFiles ?? [], resolve(inputDir, 'static'))
+  removeGeneratedStaticFiles(
+    transaction.generatedStaticFiles ?? [],
+    resolve(transaction.inputDir, 'static'),
+  )
   // 兼容旧事务：旧格式仅在 static 原本不存在时记录整个目录由插件生成。
   if (transaction.generatedStatic && transaction.generatedStaticFiles === undefined) {
-    rmSync(resolve(inputDir, 'static'), { recursive: true, force: true })
+    rmSync(resolve(transaction.inputDir, 'static'), { recursive: true, force: true })
+  }
+  writeFileSync(transaction.pagesFile, transaction.originalPages)
+  if (existsSync(transactionFile)) unlinkSync(transactionFile)
+}
+
+function releasePageAssembly(transactionFile: string, leaseFile: string): void {
+  releasePageAssemblyLease(leaseFile)
+  const lockFile = `${transactionFile}.lock`
+  acquirePageAssemblyLock(lockFile)
+  try {
+    if (!existsSync(transactionFile)) return
+    const transaction = JSON.parse(readFileSync(transactionFile, 'utf8')) as BuildTransaction
+    const current = readBuildTransaction(
+      transactionFile,
+      transaction.inputDir,
+      transaction.pagesFile,
+    )
+    if (!current || isPageAssemblyActive(current)) return
+    restoreBuildTransaction(current, transactionFile)
+  } finally {
+    releasePageAssemblyLock(lockFile)
+  }
+}
+
+function createPageAssemblyLease(transactionFile: string, sourceVersion: string): string {
+  const leaseDirectory = `${transactionFile}.leases`
+  mkdirSync(leaseDirectory, { recursive: true })
+  const leaseFile = resolve(leaseDirectory, `${process.pid}-${sourceVersion}.lease`)
+  writeFileSync(leaseFile, `${JSON.stringify({ ownerPid: process.pid })}\n`, { flag: 'wx' })
+  return leaseFile
+}
+
+function releasePageAssemblyLease(leaseFile: string): void {
+  if (existsSync(leaseFile)) unlinkSync(leaseFile)
+  const leaseDirectory = dirname(leaseFile)
+  if (existsSync(leaseDirectory) && !readdirSync(leaseDirectory).length) {
+    try {
+      rmdirSync(leaseDirectory)
+    } catch (error) {
+      const code = (error as NodeJS.ErrnoException).code
+      if (code !== 'ENOTEMPTY' && code !== 'EEXIST') throw error
+    }
+  }
+}
+
+function isPageAssemblyActive(transaction: BuildTransaction): boolean {
+  const leaseDirectory = resolve(
+    dirname(transaction.pagesFile),
+    '../.kratos-uni-app-pages-state.json.leases',
+  )
+  if (listActivePageLeases(leaseDirectory).length) return true
+  return (
+    transaction.ownerPid !== undefined &&
+    transaction.ownerPid !== process.pid &&
+    isProcessRunning(transaction.ownerPid)
+  )
+}
+
+function listActivePageLeases(leaseDirectory: string): number[] {
+  if (!existsSync(leaseDirectory)) return []
+  const activePids: number[] = []
+  for (const entry of readdirSync(leaseDirectory)) {
+    const leaseFile = resolve(leaseDirectory, entry)
+    try {
+      const lease = JSON.parse(readFileSync(leaseFile, 'utf8')) as { ownerPid?: number }
+      if (lease.ownerPid && isProcessRunning(lease.ownerPid)) {
+        activePids.push(lease.ownerPid)
+      } else {
+        unlinkSync(leaseFile)
+      }
+    } catch {
+      unlinkSync(leaseFile)
+    }
   }
-  writeFileSync(pagesFile, transaction.originalPages)
-  unlinkSync(transactionFile)
+  return activePids
+}
+
+function acquirePageAssemblyLock(lockFile: string): void {
+  const deadline = Date.now() + PAGE_ASSEMBLY_WAIT_TIMEOUT_MS
+  while (true) {
+    try {
+      writeFileSync(lockFile, `${JSON.stringify({ ownerPid: process.pid })}\n`, { flag: 'wx' })
+      return
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code !== 'EEXIST') throw error
+      const ownerPid = readPageAssemblyLockOwner(lockFile)
+      if (ownerPid !== undefined && !isProcessRunning(ownerPid)) {
+        unlinkSync(lockFile)
+        continue
+      }
+      if (Date.now() >= deadline) {
+        throw new Error(`等待 uni-app 页面装配锁超时：${lockFile}`)
+      }
+      waitForPageAssembly(PAGE_ASSEMBLY_POLL_INTERVAL_MS)
+    }
+  }
+}
+
+function releasePageAssemblyLock(lockFile: string): void {
+  if (!existsSync(lockFile)) return
+  if (readPageAssemblyLockOwner(lockFile) === process.pid) unlinkSync(lockFile)
+}
+
+function readPageAssemblyLockOwner(lockFile: string): number | undefined {
+  try {
+    return (JSON.parse(readFileSync(lockFile, 'utf8')) as { ownerPid?: number }).ownerPid
+  } catch {
+    return
+  }
+}
+
+function waitForPageAssembly(milliseconds: number): void {
+  const buffer = new SharedArrayBuffer(4)
+  Atomics.wait(new Int32Array(buffer), 0, 0, milliseconds)
+}
+
+// recoverStalePageTransaction 在官方 uni 插件创建前恢复页面事务，避免官方插件先读取到空 pages.json。
+export function recoverStalePageTransaction(): void {
+  const inputDir = process.env.UNI_INPUT_DIR || resolve(process.cwd(), 'src')
+  const transactionFile = resolve(inputDir, '../.kratos-uni-app-pages-state.json')
+  const pagesFile = resolve(inputDir, 'pages.json')
+  const lockFile = `${transactionFile}.lock`
+  acquirePageAssemblyLock(lockFile)
+  try {
+    recoverBuildTransaction(transactionFile, inputDir, pagesFile)
+  } finally {
+    releasePageAssemblyLock(lockFile)
+  }
+}
+
+function recoverBuildTransaction(
+  transactionFile: string,
+  inputDir: string,
+  pagesFile: string,
+): void {
+  const transaction = readBuildTransaction(transactionFile, inputDir, pagesFile)
+  if (!transaction || isPageAssemblyActive(transaction)) return
+  restoreBuildTransaction(transaction, transactionFile)
 }
 
 // isProcessRunning 判断页面事务的所属进程是否仍然存活。
@@ -407,14 +597,16 @@ function appendPage(manifest: PagesManifest, page: ScannedPage): void {
 function createPageWrapper(page: ScannedPage): string {
   const source = page.source.replace(/\\/g, '/')
   return `<script setup lang="ts">
+import type { Component } from 'vue'
 import KratosPage from ${JSON.stringify(source)}
 import KratosTabBar from '@liujitcn/kratos-uni-app-core/components/KratosTabBar.vue'
 
 defineOptions({ inheritAttrs: false })
+const Page = KratosPage as Component
 </script>
 
 <template>
-  <KratosPage />
+  <Page v-bind="$attrs" />
   <KratosTabBar route=${JSON.stringify(page.route)} />
 </template>
 `