重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。

同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。

Made-with: Cursor

openclaw/scripts/ios-pin-version.ts

@@ -0,0 +1,148 @@
+import path from "node:path";
+import {
+  normalizePinnedIosVersion,
+  resolveGatewayVersionForIosRelease,
+  resolveIosVersion,
+  syncIosVersioning,
+  writeIosVersionManifest,
+} from "./lib/ios-version.ts";
+
+type CliOptions = {
+  explicitVersion: string | null;
+  fromGateway: boolean;
+  rootDir: string;
+  sync: boolean;
+};
+
+export type PinIosVersionResult = {
+  previousVersion: string | null;
+  nextVersion: string;
+  packageVersion: string | null;
+  versionFilePath: string;
+  syncedPaths: string[];
+};
+
+function usage(): string {
+  return [
+    "Usage: node --import tsx scripts/ios-pin-version.ts (--from-gateway | --version <YYYY.M.D>) [--no-sync] [--root dir]",
+    "",
+    "Examples:",
+    "  node --import tsx scripts/ios-pin-version.ts --from-gateway",
+    "  node --import tsx scripts/ios-pin-version.ts --version 2026.4.10",
+  ].join("\n");
+}
+
+export function parseArgs(argv: string[]): CliOptions {
+  let explicitVersion: string | null = null;
+  let fromGateway = false;
+  let rootDir = path.resolve(".");
+  let sync = true;
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    switch (arg) {
+      case "--from-gateway": {
+        fromGateway = true;
+        break;
+      }
+      case "--version": {
+        explicitVersion = argv[index + 1] ?? null;
+        index += 1;
+        break;
+      }
+      case "--no-sync": {
+        sync = false;
+        break;
+      }
+      case "--root": {
+        const value = argv[index + 1];
+        if (!value) {
+          throw new Error("Missing value for --root.");
+        }
+        rootDir = path.resolve(value);
+        index += 1;
+        break;
+      }
+      case "-h":
+      case "--help": {
+        console.log(`${usage()}\n`);
+        process.exit(0);
+      }
+      default: {
+        throw new Error(`Unknown argument: ${arg}`);
+      }
+    }
+  }
+
+  if (fromGateway === (explicitVersion !== null)) {
+    throw new Error("Choose exactly one of --from-gateway or --version <YYYY.M.D>.");
+  }
+
+  if (explicitVersion !== null && !explicitVersion.trim()) {
+    throw new Error("Missing value for --version.");
+  }
+
+  return { explicitVersion, fromGateway, rootDir, sync };
+}
+
+export function pinIosVersion(params: CliOptions): PinIosVersionResult {
+  const rootDir = path.resolve(params.rootDir);
+  let previousVersion: string | null = null;
+  try {
+    previousVersion = resolveIosVersion(rootDir).canonicalVersion;
+  } catch {
+    previousVersion = null;
+  }
+
+  const gatewayVersion = params.fromGateway ? resolveGatewayVersionForIosRelease(rootDir) : null;
+  const packageVersion = gatewayVersion?.packageVersion ?? null;
+  const nextVersion =
+    gatewayVersion?.pinnedIosVersion ?? normalizePinnedIosVersion(params.explicitVersion ?? "");
+  const versionFilePath = writeIosVersionManifest(nextVersion, rootDir);
+  const syncedPaths = params.sync ? syncIosVersioning({ mode: "write", rootDir }).updatedPaths : [];
+
+  return {
+    previousVersion,
+    nextVersion,
+    packageVersion,
+    versionFilePath,
+    syncedPaths,
+  };
+}
+
+export async function main(argv: string[]): Promise<number> {
+  try {
+    const options = parseArgs(argv);
+    const result = pinIosVersion(options);
+    const sourceText = result.packageVersion
+      ? ` from gateway version ${result.packageVersion}`
+      : "";
+    process.stdout.write(`Pinned iOS version to ${result.nextVersion}${sourceText}.\n`);
+    if (result.previousVersion && result.previousVersion !== result.nextVersion) {
+      process.stdout.write(`Previous pinned iOS version: ${result.previousVersion}.\n`);
+    }
+    process.stdout.write(
+      `Updated version manifest: ${path.relative(process.cwd(), result.versionFilePath)}\n`,
+    );
+    if (options.sync) {
+      if (result.syncedPaths.length === 0) {
+        process.stdout.write("iOS versioning artifacts already up to date.\n");
+      } else {
+        process.stdout.write(
+          `Updated iOS versioning artifacts:\n- ${result.syncedPaths.map((filePath) => path.relative(process.cwd(), filePath)).join("\n- ")}\n`,
+        );
+      }
+    }
+    return 0;
+  } catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    return 1;
+  }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const exitCode = await main(process.argv.slice(2));
+  if (exitCode !== 0) {
+    process.exit(exitCode);
+  }
+}