ylib-syim 0.0.45 → 0.0.47

package/bridges/main.ts

@@ -32,6 +32,9 @@ process.env.TZ = "Asia/Shanghai";
 const bridgeDir = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(bridgeDir, "..");
 const requireAtBridge = createRequire(import.meta.url);
+// 固定 syim 路径在 bridge 改写 HOME 前确定，避免后续插件临时 HOME
+// 影响 os.homedir()，导致“固定配置真源”和插件运行镜像混在一起。
+const runtimeFixedSyimPath = path.join(os.homedir(), ".syim", "syim.json");
 
 // 当前进程运行实例 ID，会在 restart-all 成功后旋转。
 let runtimeInstanceId = `bridges-${process.pid}-${Date.now()}`;
@@ -1194,7 +1197,6 @@ function applyRemoteRuntimeConfigToPluginHome(): void {
         path.join(os.tmpdir(), "im-agent-hub-plugin-home-"),
       );
     }
-    const payload = JSON.stringify(slice, null, 2);
     const syimDir = path.join(pluginTempHomeDir, ".syim");
     const syimPath = path.join(syimDir, "syim.json");
     if (!fs.existsSync(syimDir)) {
@@ -1204,7 +1206,8 @@ function applyRemoteRuntimeConfigToPluginHome(): void {
         `[bridges/main] plugin temp HOME syim dir exists: ${syimDir}`,
       );
     }
-    fs.writeFileSync(syimPath, payload, "utf-8");
+    writeJsonFileAtomic(syimPath, slice);
+    logSyimConfigFileSnapshot("plugin-home:syim-write", syimPath, slice);
     const openclawDir = path.join(pluginTempHomeDir, ".openclaw");
     const openclawPath = path.join(openclawDir, "openclaw.json");
     if (!fs.existsSync(openclawDir)) {
@@ -1214,7 +1217,8 @@ function applyRemoteRuntimeConfigToPluginHome(): void {
         `[bridges/main] plugin temp HOME openclaw dir exists: ${openclawDir}`,
       );
     }
-    fs.writeFileSync(openclawPath, payload, "utf-8");
+    writeJsonFileAtomic(openclawPath, slice);
+    logSyimConfigFileSnapshot("plugin-home:openclaw-write", openclawPath, slice);
     // 让 openclaw host 与插件均优先读取 .syim/syim.json。
     process.env.OPENCLAW_CONFIG_PATH = syimPath;
     process.env.HOME = pluginTempHomeDir;
@@ -1230,6 +1234,52 @@ function applyRemoteRuntimeConfigToPluginHome(): void {
   }
 }
 
+function writeJsonFileAtomic(targetPath: string, value: unknown): void {
+  const normalizedTargetPath = String(targetPath || "").trim();
+  if (!normalizedTargetPath) {
+    throw new Error("target json path is empty");
+  }
+  const dir = path.dirname(normalizedTargetPath);
+  fs.mkdirSync(dir, { recursive: true });
+  const tempPath = path.join(
+    dir,
+    `.${path.basename(normalizedTargetPath)}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}.tmp`,
+  );
+  let fd: number | null = null;
+  try {
+    // 配置文件用“临时文件 + fsync + rename”替换，避免 Node/插件在保存过程中
+    // 读到半截 JSON。rename 在同目录内是原子替换，符合固定 syim 真源模式。
+    fd = fs.openSync(tempPath, "w");
+    fs.writeFileSync(fd, JSON.stringify(value, null, 2), "utf-8");
+    fs.fsyncSync(fd);
+    fs.closeSync(fd);
+    fd = null;
+    fs.renameSync(tempPath, normalizedTargetPath);
+    try {
+      const dirFd = fs.openSync(dir, "r");
+      try {
+        fs.fsyncSync(dirFd);
+      } finally {
+        fs.closeSync(dirFd);
+      }
+    } catch {
+      // 目录 fsync 是增强持久化保障；平台不支持时不影响 rename 原子性。
+    }
+  } catch (err) {
+    try {
+      if (fd !== null) fs.closeSync(fd);
+    } catch {
+      // ignore cleanup failure; original write error is more useful.
+    }
+    try {
+      if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath);
+    } catch {
+      // ignore cleanup failure; original write error is more useful.
+    }
+    throw err;
+  }
+}
+
 function persistRuntimeConfigSnapshot(params: {
   config: Record<string, unknown>;
   targetPath: string;
@@ -1239,32 +1289,170 @@ function persistRuntimeConfigSnapshot(params: {
   if (!targetPath) {
     throw new Error("target config path is empty");
   }
-  const dir = path.dirname(targetPath);
-  fs.mkdirSync(dir, { recursive: true });
-  const tempPath = path.join(
-    dir,
-    `.${path.basename(targetPath)}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}.tmp`,
-  );
   try {
-    fs.writeFileSync(
-      tempPath,
-      JSON.stringify(params.config, null, 2),
-      "utf-8",
+    writeJsonFileAtomic(targetPath, params.config);
+    logSyimConfigFileSnapshot(
+      `persist:${params.reason}`,
+      targetPath,
+      params.config,
     );
-    fs.renameSync(tempPath, targetPath);
     console.log(
       `[bridges/main] runtime config persisted reason=${params.reason} path=${targetPath}`,
     );
   } catch (err) {
-    try {
-      if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath);
-    } catch {
-      // ignore cleanup failure; original persist error is more useful.
-    }
     throw err;
   }
 }
 
+function reloadRuntimeConfigFromFixedSyim(reason: string): {
+  ok: boolean;
+  error?: string;
+  configPath?: string;
+} {
+  const configPath = runtimeFixedSyimPath;
+  try {
+    if (!fs.existsSync(configPath)) {
+      logSyimConfigFileSnapshot(`reload:${reason}:missing`, configPath, null);
+      return {
+        ok: false,
+        error: `fixed syim not found: ${configPath}`,
+        configPath,
+      };
+    }
+    logSyimConfigFileSnapshot(`reload:${reason}:before-read`, configPath, null);
+    const content = fs.readFileSync(configPath, "utf-8");
+    const parsed = JSON.parse(content) as Record<string, unknown>;
+    const normalizedResult = normalizeRuntimeConfigByWhitelist(parsed);
+    if (normalizedResult.droppedFields.length > 0) {
+      logSyimConfigFileSnapshot(
+        `reload:${reason}:rejected`,
+        configPath,
+        parsed,
+      );
+      return {
+        ok: false,
+        error: `fixed syim contains non-whitelisted fields: ${normalizedResult.droppedFields
+          .map((item) => `${item.channel}/${item.accountId}:${item.field}`)
+          .join(", ")}`,
+        configPath,
+      };
+    }
+    loadedConfigForRuntime = normalizedResult.normalized;
+    loadedConfigPathForRuntime = configPath;
+    exposeRuntimeConfigToBridges(loadedConfigForRuntime, configPath);
+    updateConfigVersion(normalizedResult.normalized);
+    applyRemoteRuntimeConfigToPluginHome();
+    logSyimConfigFileSnapshot(
+      `reload:${reason}:applied`,
+      configPath,
+      normalizedResult.normalized,
+    );
+    console.log(
+      `[bridges/main] runtime config reloaded from fixed syim reason=${reason} path=${configPath} version=${configVersionHash || "unknown"}`,
+    );
+    return { ok: true, configPath };
+  } catch (err) {
+    logSyimConfigFileSnapshot(`reload:${reason}:failed`, configPath, null);
+    return {
+      ok: false,
+      error: (err as Error).message,
+      configPath,
+    };
+  }
+}
+
+function countConfiguredAccountsInConfig(
+  cfg: Record<string, unknown>,
+): Record<string, number> {
+  const channels =
+    cfg.channels && typeof cfg.channels === "object" && !Array.isArray(cfg.channels)
+      ? (cfg.channels as Record<string, unknown>)
+      : {};
+  const result: Record<string, number> = {};
+  for (const [channelKey, channelValue] of Object.entries(channels)) {
+    if (!channelValue || typeof channelValue !== "object") {
+      result[channelKey] = 0;
+      continue;
+    }
+    const channel = channelValue as Record<string, unknown>;
+    const accounts =
+      channel.accounts &&
+      typeof channel.accounts === "object" &&
+      !Array.isArray(channel.accounts)
+        ? Object.keys(channel.accounts as Record<string, unknown>).length
+        : 0;
+    const hasSingleConfig = Object.keys(channel).some((key) =>
+      [
+        "appId",
+        "appSecret",
+        "clientId",
+        "clientSecret",
+        "botId",
+        "secret",
+        "wxid",
+      ].includes(key),
+    );
+    result[channelKey] = accounts || (hasSingleConfig ? 1 : 0);
+  }
+  return result;
+}
+
+function summarizeRuntimeConfigForLog(cfg: Record<string, unknown>): {
+  hash: string;
+  channels: string[];
+  accountCounts: Record<string, number>;
+  bindings: number;
+} {
+  const channels =
+    cfg.channels && typeof cfg.channels === "object" && !Array.isArray(cfg.channels)
+      ? Object.keys(cfg.channels as Record<string, unknown>)
+      : [];
+  const bindings = Array.isArray(cfg.bindings) ? cfg.bindings.length : 0;
+  return {
+    hash: calcSchemaHash(cfg),
+    channels,
+    accountCounts: countConfiguredAccountsInConfig(cfg),
+    bindings,
+  };
+}
+
+function logSyimConfigFileSnapshot(
+  label: string,
+  configPath: string,
+  cfg?: Record<string, unknown> | null,
+): void {
+  const normalizedPath = String(configPath || "").trim();
+  let fileMeta: Record<string, unknown> = {
+    exists: false,
+    path: normalizedPath,
+  };
+  try {
+    if (normalizedPath && fs.existsSync(normalizedPath)) {
+      const stat = fs.statSync(normalizedPath);
+      fileMeta = {
+        exists: true,
+        path: normalizedPath,
+        size: stat.size,
+        mtimeMs: Math.trunc(stat.mtimeMs),
+        mtimeIso: stat.mtime.toISOString(),
+      };
+    }
+  } catch (err) {
+    fileMeta = {
+      exists: false,
+      path: normalizedPath,
+      statError: (err as Error).message,
+    };
+  }
+  const configMeta =
+    cfg && typeof cfg === "object" && !Array.isArray(cfg)
+      ? summarizeRuntimeConfigForLog(cfg)
+      : null;
+  console.log(
+    `[bridges/main][syim-config] ${label} file=${JSON.stringify(fileMeta)} config=${JSON.stringify(configMeta)}`,
+  );
+}
+
 // nowIso: 生成当前 ISO 时间戳。
 function nowIso(): string {
   // 全链路统一使用 ISO 字符串时间戳。
@@ -4781,6 +4969,9 @@ function exposeRuntimeConfigToBridges(
     (globalThis as Record<string, unknown>).__IM_RUNTIME_CONFIG__ = config;
     (globalThis as Record<string, unknown>).__IM_RUNTIME_CONFIG_PATH__ =
       configPath;
+    // stdio bridge 每次 buildCfg() 优先读取这个固定 syim。内存只作为
+    // 文件缺失/本地调试时的兜底快照，避免单机器人重启继续使用旧内存配置。
+    process.env.IM_RUNTIME_FIXED_CONFIG_PATH = runtimeFixedSyimPath;
   } catch {
     // ignore
   }
@@ -6424,8 +6615,7 @@ async function pullRuntimeConfigFromPython(
 
     let persistedConfigPath: string | null = null;
     if (runtimeConfigPullPersist) {
-      const targetPath =
-        loadedConfigPathForRuntime || path.join(process.cwd(), "syim.json");
+      const targetPath = runtimeFixedSyimPath;
       // pull 成功但写盘失败时不能先切内存：否则调用方看到失败，
       // 当前进程却已经按新配置运行，形成“失败响应 + 已变更运行态”。
       persistRuntimeConfigSnapshot({
@@ -6569,6 +6759,15 @@ async function recoverRuntimeAccountByHealthGuard(params: {
     1;
 
   try {
+    const reloadResult = reloadRuntimeConfigFromFixedSyim(
+      `health_guard_restart:${reason}`,
+    );
+    if (!reloadResult.ok) {
+      throw new Error(
+        `reload fixed syim failed: ${reloadResult.error || "unknown"}`,
+      );
+    }
+
     let control = resolveRuntimeBridgeControl(item.platform);
     if (!control) {
       await ensureBridgeReadyForBotControl(item.platform, item.bot_account_id);
@@ -7734,6 +7933,26 @@ async function startInternalApiServer(): Promise<void> {
       }
       botControlInFlight.add(inFlightKey);
 
+      if (botControlAction === "start" || botControlAction === "restart") {
+        const reloadResult = reloadRuntimeConfigFromFixedSyim(
+          `bot_${botControlAction}`,
+        );
+        if (!reloadResult.ok) {
+          botControlInFlight.delete(inFlightKey);
+          res.writeHead(500, { "Content-Type": "application/json" });
+          res.end(
+            JSON.stringify({
+              ok: false,
+              error: `reload fixed syim failed: ${reloadResult.error || "unknown"}`,
+              configPath: reloadResult.configPath || runtimeFixedSyimPath,
+              platform,
+              bot_account_id: botAccountId,
+            }),
+          );
+          return;
+        }
+      }
+
       let control = resolveRuntimeBridgeControl(platform);
       if (
         !control &&
@@ -8043,10 +8262,7 @@ async function startInternalApiServer(): Promise<void> {
 
         let persistedConfigPath: string | null = null;
         if (persist) {
-          const targetPath =
-            String(body.target_path || "").trim() ||
-            loadedConfigPathForRuntime ||
-            path.join(process.cwd(), "syim.json");
+          const targetPath = runtimeFixedSyimPath;
           try {
             // config/apply 对外返回失败时，运行中配置也必须保持不变。
             // 因此 persist=true 先写盘，写盘成功后才切换内存、版本与 probe。
@@ -8200,18 +8416,12 @@ async function startInternalApiServer(): Promise<void> {
           console.log(
             `[bridges/main] restart-all step=pull_config done pulled=${String(pullResult.pulled)} version=${pullResult.version || "unknown"}`,
           );
-        } else if (
-          loadedConfigPathForRuntime &&
-          fs.existsSync(loadedConfigPathForRuntime)
-        ) {
+        } else if (fs.existsSync(runtimeFixedSyimPath)) {
           console.log(
-            `[bridges/main] restart-all step=reload_local_config begin path=${loadedConfigPathForRuntime}`,
+            `[bridges/main] restart-all step=reload_local_config begin path=${runtimeFixedSyimPath}`,
           );
           try {
-            const content = fs.readFileSync(
-              loadedConfigPathForRuntime,
-              "utf-8",
-            );
+            const content = fs.readFileSync(runtimeFixedSyimPath, "utf-8");
             const parsed = JSON.parse(content) as Record<string, unknown>;
             const normalizedResult = normalizeRuntimeConfigByWhitelist(parsed);
             if (normalizedResult.droppedFields.length > 0) {
@@ -8226,9 +8436,10 @@ async function startInternalApiServer(): Promise<void> {
               return;
             }
             loadedConfigForRuntime = normalizedResult.normalized;
+            loadedConfigPathForRuntime = runtimeFixedSyimPath;
             exposeRuntimeConfigToBridges(
               loadedConfigForRuntime,
-              loadedConfigPathForRuntime,
+              runtimeFixedSyimPath,
             );
             updateConfigVersion(normalizedResult.normalized);
             console.log(
@@ -8818,8 +9029,8 @@ function loadOpenClawConfig(): {
     return null;
   }
   const configPaths = [
+    runtimeFixedSyimPath,
     path.join(process.cwd(), "syim.json"),
-    path.join(os.homedir(), ".syim", "syim.json"),
   ];
   for (const configPath of configPaths) {
     if (!fs.existsSync(configPath)) continue;
@@ -8928,12 +9139,11 @@ async function main(): Promise<void> {
     // 远端配置权威模式：只要配置了 RUNTIME_CONFIG_PULL_URL，就不能在
     // 初始 pull 失败时回退使用本地旧 syim.json 启动 bridge。否则 Python
     // DB 真源不可用时，Node 可能用过期本地文件启动旧账号/旧凭证。
-    const fallbackPath = path.join(os.homedir(), ".syim", "syim.json");
     console.log(
       `[bridges/main] runtime pull url configured, skip local config bootstrap and wait for remote source: ${runtimeConfigPullUrl}`,
     );
     loadedConfigForRuntime = { channels: {}, bindings: [] };
-    loadedConfigPathForRuntime = fallbackPath;
+    loadedConfigPathForRuntime = runtimeFixedSyimPath;
     exposeRuntimeConfigToBridges(
       loadedConfigForRuntime,
       loadedConfigPathForRuntime,
@@ -8966,12 +9176,11 @@ async function main(): Promise<void> {
         "startup_bootstrap_empty",
       );
     } else {
-      const fallbackPath = path.join(os.homedir(), ".syim", "syim.json");
       console.log(
         `[bridges/main] local config not found, bootstrap from runtime pull url: ${runtimeConfigPullUrl}`,
       );
       loadedConfigForRuntime = { channels: {}, bindings: [] };
-      loadedConfigPathForRuntime = fallbackPath;
+      loadedConfigPathForRuntime = runtimeFixedSyimPath;
       exposeRuntimeConfigToBridges(
         loadedConfigForRuntime,
         loadedConfigPathForRuntime,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ylib-syim",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "description": "多 IM / 多 Agent 的会话路由与上下文管理（支持 /new）",
   "type": "module",
   "exports": {
@@ -48,7 +48,7 @@
     "@ffmpeg-installer/ffmpeg": "^1.1.0",
     "ylib-dingtalk-connector": "0.7.10-23",
     "ylib-openclaw-lark": "2026.3.17-30",
-    "ylib-openclaw-weixin": "2.1.7-17",
+    "ylib-openclaw-weixin": "2.1.7-18",
     "axios": "^1.6.0",
     "dingtalk-stream": "^2.1.4",
     "fluent-ffmpeg": "^2.1.3",

package/scripts/dingtalk-stdio-bridge.ts

@@ -304,24 +304,47 @@ function channelsForLog(
   return out;
 }
 
+function syimFileMetaForLog(configPath: string): Record<string, unknown> {
+  try {
+    const stat = fs.statSync(configPath);
+    return {
+      path: configPath,
+      size: stat.size,
+      mtimeMs: Math.trunc(stat.mtimeMs),
+      mtimeIso: stat.mtime.toISOString(),
+    };
+  } catch (err) {
+    return {
+      path: configPath,
+      statError: (err as Error).message,
+    };
+  }
+}
+
+function configSummaryForLog(config: Record<string, unknown>): Record<string, unknown> {
+  const channels =
+    config.channels && typeof config.channels === "object" && !Array.isArray(config.channels)
+      ? (config.channels as Record<string, unknown>)
+      : {};
+  const dingtalk = channels[CHANNEL_KEY] as Record<string, unknown> | undefined;
+  const accounts =
+    dingtalk?.accounts &&
+    typeof dingtalk.accounts === "object" &&
+    !Array.isArray(dingtalk.accounts)
+      ? Object.keys(dingtalk.accounts as Record<string, unknown>)
+      : [];
+  return {
+    channels: Object.keys(channels),
+    dingtalkAccounts: accounts,
+    bindings: Array.isArray(config.bindings) ? config.bindings.length : 0,
+  };
+}
+
 /** 加载 syim.json，与 connector-host 一致 */
 function loadOpenClawConfig(): Record<string, unknown> | null {
-  const runtimeConfig = (globalThis as Record<string, unknown>)
-    .__IM_RUNTIME_CONFIG__;
-  if (
-    runtimeConfig &&
-    typeof runtimeConfig === "object" &&
-    !Array.isArray(runtimeConfig)
-  ) {
-    console.log(
-      "[dingtalk-stdio-bridge] 从 runtime 内存配置加载，跳过本地 syim fallback",
-    );
-    try {
-      return JSON.parse(JSON.stringify(runtimeConfig)) as Record<string, unknown>;
-    } catch {
-      return { ...(runtimeConfig as Record<string, unknown>) };
-    }
-  }
+  const fixedConfigPath = String(
+    process.env.IM_RUNTIME_FIXED_CONFIG_PATH || "",
+  ).trim();
   const runtimeConfigPath = String(
     (globalThis as Record<string, unknown>).__IM_RUNTIME_CONFIG_PATH__ || "",
   ).trim();
@@ -329,15 +352,24 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
   const configPaths = Array.from(
     new Set(
       [
-        envConfigPath,
+        fixedConfigPath,
         runtimeConfigPath,
+        envConfigPath,
         path.join(os.homedir(), ".syim", "syim.json"),
         path.join(getProjectRoot(), "syim.json"),
       ].filter((p) => Boolean(p)),
     ),
   );
+  console.log(
+    `[dingtalk-stdio-bridge][syim-config] candidates=${JSON.stringify(configPaths)}`,
+  );
   for (const configPath of configPaths) {
-    if (!fs.existsSync(configPath)) continue;
+    if (!fs.existsSync(configPath)) {
+      console.log(
+        `[dingtalk-stdio-bridge][syim-config] skip missing path=${configPath}`,
+      );
+      continue;
+    }
     try {
       const content = fs.readFileSync(configPath, "utf-8");
       const config = JSON.parse(content) as Record<string, unknown>;
@@ -345,6 +377,9 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
         "[dingtalk-stdio-bridge] 配置与 connector 匹配: 从 syim.json 加载配置，路径:",
         configPath,
       );
+      console.log(
+        `[dingtalk-stdio-bridge][syim-config] selected file=${JSON.stringify(syimFileMetaForLog(configPath))} summary=${JSON.stringify(configSummaryForLog(config))}`,
+      );
       console.log(
         "[dingtalk-stdio-bridge] 配置文件 channels:",
         JSON.stringify(
@@ -362,6 +397,30 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
       );
     }
   }
+  const runtimeConfig = (globalThis as Record<string, unknown>)
+    .__IM_RUNTIME_CONFIG__;
+  if (
+    runtimeConfig &&
+    typeof runtimeConfig === "object" &&
+    !Array.isArray(runtimeConfig)
+  ) {
+    console.log(
+      "[dingtalk-stdio-bridge] syim 不可用，使用 runtime 内存配置兜底",
+    );
+    try {
+      const cloned = JSON.parse(JSON.stringify(runtimeConfig)) as Record<string, unknown>;
+      console.log(
+        `[dingtalk-stdio-bridge][syim-config] runtime fallback summary=${JSON.stringify(configSummaryForLog(cloned))}`,
+      );
+      return cloned;
+    } catch {
+      const cloned = { ...(runtimeConfig as Record<string, unknown>) };
+      console.log(
+        `[dingtalk-stdio-bridge][syim-config] runtime fallback summary=${JSON.stringify(configSummaryForLog(cloned))}`,
+      );
+      return cloned;
+    }
+  }
   console.log(
     "[dingtalk-stdio-bridge] 配置与 connector 匹配: 未找到 syim.json，将使用环境变量",
   );
@@ -407,7 +466,10 @@ function buildCfg(): {
     firstStringInAccounts(accountsMap, "gatewayToken") ||
     ""
   ).trim();
-  console.log("[dingtalk-stdio-bridge] gatewayToken =", gatewayToken);
+  console.log(
+    "[dingtalk-stdio-bridge] gatewayToken =",
+    gatewayToken ? "<present>" : "<absent>",
+  );
   console.log("[dingtalk-stdio-bridge] gatewayBaseUrl =", gatewayBaseUrl);
 
   if (!gatewayBaseUrl) {
@@ -490,6 +552,14 @@ function buildCfg(): {
   console.log(
     `[dingtalk-stdio-bridge] single account alias = ${bridgeDefaultAccountAlias}`,
   );
+  console.log(
+    `[dingtalk-stdio-bridge][syim-config] buildCfg summary=${JSON.stringify({
+      ...configSummaryForLog(cfg),
+      gatewayBaseUrl: gatewayBaseUrl || "<absent>",
+      gatewayToken: gatewayToken ? "<present>" : "<absent>",
+      singleAccountAlias: bridgeDefaultAccountAlias,
+    })}`,
+  );
 
   return { cfg, gatewayBaseUrl, gatewayToken };
 }

package/scripts/lark-stdio-bridge.ts

@@ -318,27 +318,48 @@ function channelsForLog(
   return out;
 }
 
+function syimFileMetaForLog(configPath: string): Record<string, unknown> {
+  try {
+    const stat = fs.statSync(configPath);
+    return {
+      path: configPath,
+      size: stat.size,
+      mtimeMs: Math.trunc(stat.mtimeMs),
+      mtimeIso: stat.mtime.toISOString(),
+    };
+  } catch (err) {
+    return {
+      path: configPath,
+      statError: (err as Error).message,
+    };
+  }
+}
+
+function configSummaryForLog(config: Record<string, unknown>): Record<string, unknown> {
+  const channels =
+    config.channels && typeof config.channels === "object" && !Array.isArray(config.channels)
+      ? (config.channels as Record<string, unknown>)
+      : {};
+  const feishu = channels[CHANNEL_KEY] as Record<string, unknown> | undefined;
+  const accounts =
+    feishu?.accounts && typeof feishu.accounts === "object" && !Array.isArray(feishu.accounts)
+      ? Object.keys(feishu.accounts as Record<string, unknown>)
+      : [];
+  return {
+    channels: Object.keys(channels),
+    feishuAccounts: accounts,
+    bindings: Array.isArray(config.bindings) ? config.bindings.length : 0,
+  };
+}
+
 // ---------------------------------------------------------------------------
 // 配置加载
 // ---------------------------------------------------------------------------
 
 function loadOpenClawConfig(): Record<string, unknown> | null {
-  const runtimeConfig = (globalThis as Record<string, unknown>)
-    .__IM_RUNTIME_CONFIG__;
-  if (
-    runtimeConfig &&
-    typeof runtimeConfig === "object" &&
-    !Array.isArray(runtimeConfig)
-  ) {
-    console.log(
-      "[lark-stdio-bridge] 从 runtime 内存配置加载，跳过本地 syim fallback",
-    );
-    try {
-      return JSON.parse(JSON.stringify(runtimeConfig)) as Record<string, unknown>;
-    } catch {
-      return { ...(runtimeConfig as Record<string, unknown>) };
-    }
-  }
+  const fixedConfigPath = String(
+    process.env.IM_RUNTIME_FIXED_CONFIG_PATH || "",
+  ).trim();
   const runtimeConfigPath = String(
     (globalThis as Record<string, unknown>).__IM_RUNTIME_CONFIG_PATH__ || "",
   ).trim();
@@ -346,19 +367,31 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
   const configPaths = Array.from(
     new Set(
       [
-        envConfigPath,
+        fixedConfigPath,
         runtimeConfigPath,
+        envConfigPath,
         path.join(os.homedir(), ".syim", "syim.json"),
         path.join(getProjectRoot(), "syim.json"),
       ].filter((p) => Boolean(p)),
     ),
   );
+  console.log(
+    `[lark-stdio-bridge][syim-config] candidates=${JSON.stringify(configPaths)}`,
+  );
   for (const configPath of configPaths) {
-    if (!fs.existsSync(configPath)) continue;
+    if (!fs.existsSync(configPath)) {
+      console.log(
+        `[lark-stdio-bridge][syim-config] skip missing path=${configPath}`,
+      );
+      continue;
+    }
     try {
       const content = fs.readFileSync(configPath, "utf-8");
       const config = JSON.parse(content) as Record<string, unknown>;
       console.log("[lark-stdio-bridge] 从 syim.json 加载配置:", configPath);
+      console.log(
+        `[lark-stdio-bridge][syim-config] selected file=${JSON.stringify(syimFileMetaForLog(configPath))} summary=${JSON.stringify(configSummaryForLog(config))}`,
+      );
       console.log(
         "[lark-stdio-bridge] channels:",
         JSON.stringify(
@@ -376,6 +409,30 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
       );
     }
   }
+  const runtimeConfig = (globalThis as Record<string, unknown>)
+    .__IM_RUNTIME_CONFIG__;
+  if (
+    runtimeConfig &&
+    typeof runtimeConfig === "object" &&
+    !Array.isArray(runtimeConfig)
+  ) {
+    console.log(
+      "[lark-stdio-bridge] syim 不可用，使用 runtime 内存配置兜底",
+    );
+    try {
+      const cloned = JSON.parse(JSON.stringify(runtimeConfig)) as Record<string, unknown>;
+      console.log(
+        `[lark-stdio-bridge][syim-config] runtime fallback summary=${JSON.stringify(configSummaryForLog(cloned))}`,
+      );
+      return cloned;
+    } catch {
+      const cloned = { ...(runtimeConfig as Record<string, unknown>) };
+      console.log(
+        `[lark-stdio-bridge][syim-config] runtime fallback summary=${JSON.stringify(configSummaryForLog(cloned))}`,
+      );
+      return cloned;
+    }
+  }
   console.log("[lark-stdio-bridge] 未找到 syim.json，将使用环境变量");
   return null;
 }
@@ -504,6 +561,14 @@ function buildCfg(): {
   console.log(
     `[lark-stdio-bridge] single account alias = ${bridgeDefaultAccountAlias}`,
   );
+  console.log(
+    `[lark-stdio-bridge][syim-config] buildCfg summary=${JSON.stringify({
+      ...configSummaryForLog(cfg),
+      gatewayBaseUrl: gatewayBaseUrl || "<absent>",
+      gatewayToken: gatewayToken ? "<present>" : "<absent>",
+      singleAccountAlias: bridgeDefaultAccountAlias,
+    })}`,
+  );
 
   return { cfg, gatewayBaseUrl, gatewayToken };
 }

package/scripts/weixin-stdio-bridge.ts

@@ -437,23 +437,44 @@ function normalizeConfiguredAccountIds(ids: string[]): string[] {
   return normalized;
 }
 
-function loadOpenClawConfig(): Record<string, unknown> | null {
-  const runtimeConfig = (globalThis as Record<string, unknown>)
-    .__IM_RUNTIME_CONFIG__;
-  if (
-    runtimeConfig &&
-    typeof runtimeConfig === "object" &&
-    !Array.isArray(runtimeConfig)
-  ) {
-    console.log(
-      "[weixin-stdio-bridge] 从 runtime 内存配置加载，跳过本地 syim fallback",
-    );
-    try {
-      return JSON.parse(JSON.stringify(runtimeConfig)) as Record<string, unknown>;
-    } catch {
-      return { ...(runtimeConfig as Record<string, unknown>) };
-    }
+function syimFileMetaForLog(configPath: string): Record<string, unknown> {
+  try {
+    const stat = fs.statSync(configPath);
+    return {
+      path: configPath,
+      size: stat.size,
+      mtimeMs: Math.trunc(stat.mtimeMs),
+      mtimeIso: stat.mtime.toISOString(),
+    };
+  } catch (err) {
+    return {
+      path: configPath,
+      statError: (err as Error).message,
+    };
   }
+}
+
+function configSummaryForLog(config: Record<string, unknown>): Record<string, unknown> {
+  const channels =
+    config.channels && typeof config.channels === "object" && !Array.isArray(config.channels)
+      ? (config.channels as Record<string, unknown>)
+      : {};
+  const weixin = channels[CHANNEL_KEY] as Record<string, unknown> | undefined;
+  const accounts =
+    weixin?.accounts && typeof weixin.accounts === "object" && !Array.isArray(weixin.accounts)
+      ? Object.keys(weixin.accounts as Record<string, unknown>)
+      : [];
+  return {
+    channels: Object.keys(channels),
+    weixinAccounts: accounts,
+    bindings: Array.isArray(config.bindings) ? config.bindings.length : 0,
+  };
+}
+
+function loadOpenClawConfig(): Record<string, unknown> | null {
+  const fixedConfigPath = String(
+    process.env.IM_RUNTIME_FIXED_CONFIG_PATH || "",
+  ).trim();
   const runtimeConfigPath = String(
     (globalThis as Record<string, unknown>).__IM_RUNTIME_CONFIG_PATH__ || "",
   ).trim();
@@ -461,20 +482,32 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
   const configPaths = Array.from(
     new Set(
       [
-        envConfigPath,
+        fixedConfigPath,
         runtimeConfigPath,
+        envConfigPath,
         path.join(os.homedir(), ".syim", "syim.json"),
         path.join(getProjectRoot(), "syim.json"),
       ].filter((p) => Boolean(p)),
     ),
   );
 
+  console.log(
+    `[weixin-stdio-bridge][syim-config] candidates=${JSON.stringify(configPaths)}`,
+  );
   for (const configPath of configPaths) {
-    if (!fs.existsSync(configPath)) continue;
+    if (!fs.existsSync(configPath)) {
+      console.log(
+        `[weixin-stdio-bridge][syim-config] skip missing path=${configPath}`,
+      );
+      continue;
+    }
     try {
       const content = fs.readFileSync(configPath, "utf-8");
       const config = JSON.parse(content) as Record<string, unknown>;
       console.log("[weixin-stdio-bridge] config loaded:", configPath);
+      console.log(
+        `[weixin-stdio-bridge][syim-config] selected file=${JSON.stringify(syimFileMetaForLog(configPath))} summary=${JSON.stringify(configSummaryForLog(config))}`,
+      );
       return config;
     } catch (err) {
       console.warn(
@@ -484,6 +517,28 @@ function loadOpenClawConfig(): Record<string, unknown> | null {
       );
     }
   }
+  const runtimeConfig = (globalThis as Record<string, unknown>)
+    .__IM_RUNTIME_CONFIG__;
+  if (
+    runtimeConfig &&
+    typeof runtimeConfig === "object" &&
+    !Array.isArray(runtimeConfig)
+  ) {
+    console.log("[weixin-stdio-bridge] syim 不可用，使用 runtime 内存配置兜底");
+    try {
+      const cloned = JSON.parse(JSON.stringify(runtimeConfig)) as Record<string, unknown>;
+      console.log(
+        `[weixin-stdio-bridge][syim-config] runtime fallback summary=${JSON.stringify(configSummaryForLog(cloned))}`,
+      );
+      return cloned;
+    } catch {
+      const cloned = { ...(runtimeConfig as Record<string, unknown>) };
+      console.log(
+        `[weixin-stdio-bridge][syim-config] runtime fallback summary=${JSON.stringify(configSummaryForLog(cloned))}`,
+      );
+      return cloned;
+    }
+  }
   console.log("[weixin-stdio-bridge] no syim.json found, fallback to env");
   return null;
 }
@@ -595,6 +650,14 @@ function buildCfg(): {
   console.log(
     `[weixin-stdio-bridge] single account alias = ${bridgeDefaultAccountAlias}`,
   );
+  console.log(
+    `[weixin-stdio-bridge][syim-config] buildCfg summary=${JSON.stringify({
+      ...configSummaryForLog(cfg),
+      gatewayBaseUrl: gatewayBaseUrl || "<absent>",
+      gatewayToken: gatewayToken ? "<present>" : "<absent>",
+      singleAccountAlias: bridgeDefaultAccountAlias,
+    })}`,
+  );
 
   return { cfg, gatewayBaseUrl, gatewayToken };
 }