@wenbin_wb/dsh-bridge 2.10.8 → 2.10.10

package/lib/bridge-rpc.js

@@ -3,6 +3,7 @@
 
 import QRCode from 'qrcode';
 import { BRIDGE_RPC_CHANNEL, BRIDGE_ENDPOINTS } from './bridge-rpc-constants.js';
+import { registerRpcChannel } from './connection-compat.js';
 import { RateLimiter } from './security/rate-limiter.js';
 
 export { BRIDGE_RPC_CHANNEL, BRIDGE_ENDPOINTS };
@@ -87,7 +88,10 @@ export function installBridgeRpc(ctx, { service, authManager, platformManager, l
     return () => {};
   }
 
-  return ctx.connection.rpc.handle(
+  // 经 connection-compat 注册：兼容 DSH ≥ 0.1.5-alpha.1 的 webServer 注入回归
+  // （上游 register() 里对 connection 自身 ctx 取 webServer 而未加 inject 作用域）
+  return registerRpcChannel(
+    ctx,
     BRIDGE_RPC_CHANNEL,
     async (endpoint, payload = {}, signal) => {
       if (signal?.aborted) return fail('cancelled', 'Request was cancelled');
@@ -374,6 +378,29 @@ export function installBridgeRpc(ctx, { service, authManager, platformManager, l
 
         // ---- 平台管理器（多 IM 平台）----
 
+        // 本机可用的 DSH agent preset（设置页下拉用）。
+        // 只读、不含敏感信息：DSH 未提供 agentPresets 服务（旧版本）或名册读取失败时
+        // 返回 available:false，前端退化为手填，不影响会话创建。
+        if (endpoint === BRIDGE_ENDPOINTS.listAgentPresets) {
+          try {
+            const presets = ctx.get?.('agentPresets');
+            if (!presets?.list) return ok({ available: false, default: null, presets: [] });
+            const rows = await presets.list();
+            return ok({
+              available: true,
+              default: typeof presets.defaultId === 'string' ? presets.defaultId : null,
+              presets: (Array.isArray(rows) ? rows : [])
+                // 坏掉的预设不列出来（DSH 自己也会在挂载前拒绝）
+                .filter((p) => p && typeof p.id === 'string' && p.broken === undefined)
+                .map((p) => ({ id: p.id, name: typeof p.name === 'string' ? p.name : p.id })),
+            });
+          } catch (err) {
+            // 服务被卸载 / 名册不可读：这是设置页的辅助信息，不该让整个请求失败
+            logger?.warn?.('dsh-bridge: listAgentPresets failed: %s', err?.message ?? err);
+            return ok({ available: false, default: null, presets: [] });
+          }
+        }
+
         if (endpoint === BRIDGE_ENDPOINTS.listPlatforms) {
           if (!platformManager) return ok({});
           // 每个平台的 login.qrPayload 渲染为 dataURL 后返回
@@ -486,7 +513,10 @@ export function installBridgeRpc(ctx, { service, authManager, platformManager, l
         return fail('bad-request', err.message);
       }
     },
-    { authority: 'loopback' }
+    // DSH 0.1.0/0.1.1 支持 authority 选项（仅回环可达）；0.1.2+ 忽略之，透传无副作用。
+    // 见 lib/connection-compat.js 的 registerRpcChannel 说明。
+    { authority: 'loopback' },
+    logger
   );
 }
 

package/lib/connection-compat.js

@@ -0,0 +1,115 @@
+// 运行时兼容垫片：DSH ≥ 0.1.5-alpha.1 的 connection RPC 通道注册回归
+// （lib/connection-compat.js）
+//
+// 背景（上游回归，非本插件声明问题）
+// ---------------------------------------------------------------
+// @deepseek-ai/dsh-client-connection 在 0.1.5-alpha.1 改了插件级服务声明：
+//     ≤ 0.1.3-alpha.2    const inject = ["webServer", "credentials"];
+//     ≥ 0.1.5-alpha.1    const inject = ["credentials"];      // webServer 改为可选
+// 同时把 /api 路由改用作用域注入 ctx.inject(["webServer"], (webCtx) => …)。
+// 但 HostConnectionService.register() 里那一句没有同步改（各版本行号均为 618）：
+//     return owner.effect(() => owner.webServer.register(route),
+//                         `client-connection: ${channel} rpc channel`);
+// 其中 owner === this.ctx，即 connection 插件自己的 ctx。该 ctx 的 fiber 不再把
+// webServer 记入 inject，于是 cordis 4 的服务守卫直接抛：
+//     cannot get property "webServer" without inject
+// 注册发生在插件树加载期，异常向上冒泡 → 整棵插件树加载失败，`dsh web` 起不来：
+//     Error: dsh: plugin tree failed to load: failed to apply loader entry
+//            dsh-bridge (@wenbin_wb/dsh-bridge): cannot get property "webServer" without inject
+//
+// 影响面：任何调用 ctx.connection.rpc.handle() 的插件都会踩中（dsh-bridge 只是第一个撞上的）。
+// 已逐一核对 npm 上的版本：0.1.5-alpha.1 / alpha.2 / rc.1 / rc.2 全部未修
+// （0.1.5-rc.2 为当前已发布的最新版），0.1.3-alpha.2 及更早正常。
+//
+// 本垫片的做法
+// ---------------------------------------------------------------
+// 不改上游代码、不猜内部私有方法，只走两个公开面：
+//   1. 正常路径：ctx.connection.rpc.handle(channel, handler)（公开 API，未来上游修好即恢复）；
+//   2. 兜底路径：仅当该调用抛出 "webServer … without inject" 时，在 root 的
+//      `internal/get` 瀑布事件上临时挂一个监听器 —— 先让默认解析跑，默认解析失败
+//      （抛出的正是同一个 error 对象）才补上本插件已通过 inject 拿到的 webServer 引用。
+//      webServer 是单例服务，语义等价；默认解析成功时零干预。
+// 监听器只在这一次同步注册调用期间存在，返回后立即摘除（cordis 的 effect 同步执行，
+// 注册完成后 owner.webServer 不再被访问），因此对宿主其余部分完全无副作用。
+//
+// 上游修好后本模块自动空转：首次调用不再抛错，兜底分支根本不会进入。
+
+const MISSING_INJECT = /without inject/;
+
+/**
+ * 判断错误是否为"跨服务取属性缺 inject 作用域"的守卫错误，且对象是 webServer。
+ * @param {unknown} err 捕获到的异常
+ * @returns {boolean} 是否命中该回归
+ */
+export function isMissingWebServerInjectError(err) {
+  if (!(err instanceof Error)) return false;
+  return MISSING_INJECT.test(err.message) && /webServer/.test(err.message);
+}
+
+/**
+ * 在 root 的 `internal/get` 瀑布事件上挂一个临时兜底：默认解析失败时提供 webServer。
+ *
+ * cordis 4 的 `ctx.events` 是所有子 ctx 共享的同一个实例，且 `internal/get` 派发时
+ * 不带 context 过滤条件（thisArg 为 null），因此在本插件 ctx 上注册的监听器同样会对
+ * connection 插件 ctx 的查找生效。监听器由 root fiber 持有，须手工摘除。
+ *
+ * @param {object} ctx 本插件的 ctx
+ * @returns {() => void} 摘除函数
+ */
+export function installWebServerResolutionFallback(ctx) {
+  const webServer = ctx?.webServer;
+  if (webServer === undefined) return () => {};
+
+  const listener = function (lookupCtx, prop, error, next) {
+    if (prop !== 'webServer') return next();
+    try {
+      return next();
+    } catch (err) {
+      // 默认解析抛的不是本次守卫错误 → 原样上抛，绝不掩盖真实故障
+      if (err !== error) throw err;
+    }
+    // 默认解析确认失败：补上本插件已 inject 的单例引用（语义等价）
+    return webServer;
+  };
+
+  const off = ctx.on?.('internal/get', listener, { global: true });
+  return typeof off === 'function' ? off : () => {};
+}
+
+/**
+ * 注册 connection RPC 通道，并兼容 DSH ≥ 0.1.5-alpha.1 的 webServer 注入回归。
+ *
+ * @param {object} ctx 本插件的 ctx（须已 inject `connection` 与 `webServer`）
+ * @param {string} channel RPC 通道名（如 `/dsh-bridge`）
+ * @param {Function} handler 通道处理器
+ * @param {object} [rpcOptions] 透传给 connection 的通道选项。
+ *        DSH 0.1.0/0.1.1 的 `rpc.handle(channel, handler, options)` 支持
+ *        `{ authority: 'loopback' }`（仅回环可达，非回环请求 403）；
+ *        0.1.2-rc.1 起该第三参数已被移除（更高版本忽略它，传入无副作用）。
+ *        本插件依赖它来做回环加固，因此必须原样透传、不得丢失。
+ * @param {{warn?: Function}} [logger] 可选日志器
+ * @returns {Function} 由 connection 服务返回的处置函数
+ */
+export function registerRpcChannel(ctx, channel, handler, rpcOptions, logger) {
+  try {
+    return ctx.connection.rpc.handle(channel, handler, rpcOptions);
+  } catch (err) {
+    if (!isMissingWebServerInjectError(err)) throw err;
+
+    // 上游回归：owner（connection 插件自己的 ctx）解析不到 webServer。
+    // 该调用在 owner.webServer 处、于 webServer.register() 之前就抛，未产生任何副作用，
+    // 因此可以安全地补上兜底后重试一次。
+    const dispose = installWebServerResolutionFallback(ctx);
+    try {
+      const registered = ctx.connection.rpc.handle(channel, handler, rpcOptions);
+      logger?.warn?.(
+        'dsh-bridge: 检测到宿主 DSH 的 connection RPC 注册回归（cannot get property "webServer" without inject，'
+        + '见 dsh-client-connection 的 register()）；已用 webServer 解析兜底完成通道注册。'
+        + '此为宿主侧问题（DSH 0.1.5-alpha.1 起），插件侧垫片会在上游修复后自动空转。'
+      );
+      return registered;
+    } finally {
+      dispose();
+    }
+  }
+}

package/lib/feishu/index.js

@@ -4,6 +4,7 @@
 
 import QRCode from 'qrcode'
 import { Platform } from '../platform/base.js'
+import { applySessionConfig, readSessionConfig } from '../platform/session-config.js'
 import { FeishuGateway } from './gateway.js'
 import { FeishuConversationNode } from './node.js'
 
@@ -38,6 +39,11 @@ export class FeishuService extends Platform {
       maxMessageChars: config.maxMessageChars || 2000,
       sendChunkDelayMs: config.sendChunkDelayMs,
       activeSessionId: config.activeSessionId,
+      // 会话级配置：工作区 / Agent 预设 / 模型路由（构造期来自 cordis 配置，运行期由设置页写入）
+      cwd: config.cwd,
+      agentPreset: config.agentPreset,
+      agentProvider: config.agentProvider,
+      agentModel: config.agentModel,
     }, logger, {
       onFirstSender: () => this.persist({ allowFrom: [...(this.node?.config?.allowFrom ?? [])] }),
       onActiveSessionChange: (sessionId) => this.persist({ activeSessionId: sessionId }),
@@ -164,6 +170,7 @@ export class FeishuService extends Platform {
         appId: this.gateway.config.appId,
         appSecret: '',
         domain: this.gateway.config.domain,
+        ...readSessionConfig(this.node?.config),
       },
       botInfo: this.gateway.botInfo,
       botLink,
@@ -179,7 +186,7 @@ export class FeishuService extends Platform {
     return { success: true, allowFrom: list }
   }
 
-  async setConfig({ digestIntervalSec, approvalTimeoutSec, maxMessageChars, sendChunkDelayMs, groupAutoApprove, appId, appSecret, domain } = {}) {
+  async setConfig({ digestIntervalSec, approvalTimeoutSec, maxMessageChars, sendChunkDelayMs, groupAutoApprove, appId, appSecret, domain, agentPreset, cwd, agentProvider, agentModel } = {}) {
     if (digestIntervalSec != null)   this.node.config.digestIntervalSec   = Number(digestIntervalSec)
     if (approvalTimeoutSec != null)  this.node.config.approvalTimeoutSec  = Number(approvalTimeoutSec)
     if (maxMessageChars != null) {
@@ -188,6 +195,7 @@ export class FeishuService extends Platform {
     }
     if (sendChunkDelayMs != null)    this.node.config.sendChunkDelayMs    = Number(sendChunkDelayMs)
     if (groupAutoApprove != null)    this.node.config.groupAutoApprove    = groupAutoApprove === true
+    applySessionConfig(this.node.config, { agentPreset, cwd, agentProvider, agentModel })
     if (appId !== undefined || appSecret !== undefined || domain !== undefined) {
       this.gateway.updateConfig({
         appId: appId !== undefined ? appId.trim() : this.gateway.config.appId,
@@ -201,6 +209,7 @@ export class FeishuService extends Platform {
       maxMessageChars:    this.node.config.maxMessageChars,
       sendChunkDelayMs:   this.node.config.sendChunkDelayMs,
       groupAutoApprove:   this.node.config.groupAutoApprove === true,
+      ...readSessionConfig(this.node.config),
     }
     if (appId !== undefined || appSecret !== undefined || domain !== undefined) {
       patch.appId = this.gateway.config.appId

package/lib/index.js

@@ -13,17 +13,18 @@ import { fileURLToPath } from 'node:url';
 import { readFileSync, existsSync, realpathSync } from 'node:fs';
 import { readFile, writeFile, mkdir, unlink, readdir, stat, access } from 'node:fs/promises';
 import { spawn } from 'node:child_process';
-import { createHash, createHmac } from 'node:crypto';
 import QRCode from 'qrcode';
 import { installBridgeRpc } from './bridge-rpc.js';
 import { CustomTunnelClient } from './tunnel-client.mjs';
 import { CloudflaredManager } from './cloudflared-manager.mjs';
 import { PlatformManager } from './platform/manager.js';
+import { applyRestoredPlatformConfig, RESTORED_STRING_FIELDS, PLATFORM_TIMING_FIELDS } from './platform/config-restore.js';
 import { WechatService } from './wechat/index.js';
 import { QqService } from './qq/index.js';
 import { FeishuService } from './feishu/index.js';
 import { TelegramService } from './telegram/index.js';
 import { AuthManager } from './auth/manager.js';
+import { getDshLoopbackCookie as getDshLoopbackCookieImpl } from './auth/dsh-native-cookie.js';
 import { renderLoginPage } from './auth/login-template.js';
 import { isSafeWorkspacePath, isSensitiveFolderName } from './security/path-validator.js';
 import { stripSessionProjections } from './session-strip.js';
@@ -193,35 +194,14 @@ function isCompressed(headers) {
   return /(^|,\s*)(gzip|br|deflate)(\s*,|$)/i.test(String(headers['content-encoding'] ?? ''));
 }
 
-function encodeBase64Url(value) {
-  return Buffer.from(value).toString('base64url');
-}
-
 /**
  * 读取 DSH 本地凭证并生成 loopback dsh-auth 认证签名 Cookie (适配 DSH 新版原生认证)
+ *
+ * 实现见 lib/auth/dsh-native-cookie.js（含 cookie 名称/载荷/签名的格式说明与
+ * 凭据记录定位策略）。此处仅做 thin wrapper，保持既有调用点不变。
  */
 function getDshLoopbackCookie(targetPort) {
-  try {
-    const dshHome = process.env.DSH_HOME ?? join(homedir(), '.dsh');
-    const credPath = join(dshHome, '.credentials.yaml');
-    if (!existsSync(credPath)) return '';
-    const content = readFileSync(credPath, 'utf8');
-    const match = content.match(/secret:\s*([A-Za-z0-9_-]+)/);
-    if (!match) return '';
-    const secret = Buffer.from(match[1], 'base64url');
-
-    const authority = `127.0.0.1:${targetPort}`;
-    const name = 'dsh-auth-' + encodeBase64Url(createHash('sha256').update(authority).digest());
-    const issuedAt = Date.now() - 1000;
-    const expiresAt = issuedAt + 30 * 24 * 3600 * 1000;
-    const body = encodeBase64Url(Buffer.from(JSON.stringify({
-      version: 1, authority, issuedAt, expiresAt,
-    }), 'utf8'));
-    const sig = encodeBase64Url(createHmac('sha256', secret).update(body).digest());
-    return `${name}=v1.${body}.${sig}`;
-  } catch {
-    return '';
-  }
+  return getDshLoopbackCookieImpl(targetPort);
 }
 
 /** 把请求头中的 Host 和 Origin 改写成 loopback，让 DSH 的安全栅栏放行 */
@@ -1975,15 +1955,13 @@ function apply(ctx, config = {}) {
       const cfg = stored?.[platformKey];
       if (!cfg) return;
       const node = service.node;
-      node.config.allowFrom = Array.isArray(cfg.allowFrom) ? cfg.allowFrom : [];
-      for (const field of numericFields) {
-        if (cfg[field] != null) node.config[field] = Number(cfg[field]);
-      }
-      if (cfg.maxMessageChars != null) {
-        const val = Number(cfg.maxMessageChars);
-        node.config.maxMessageChars = (val >= 200) ? val : defaultMaxMessageChars;
-      }
-      if (cfg.groupAutoApprove != null) node.config.groupAutoApprove = cfg.groupAutoApprove === true;
+      // 白名单/数值字段 + 会话字符串字段（cwd/agentPreset/agentProvider/agentModel）一并回写，
+      // 否则"设置里配了、重启就丢"，远程会话会掉到默认或空 preset 层
+      applyRestoredPlatformConfig(node.config, cfg, {
+        numericFields,
+        stringFields: RESTORED_STRING_FIELDS,
+        defaultMaxMessageChars,
+      });
 
       node._restoringConfig = (async () => {
         if (cfg.activeSessionId) {
@@ -2008,7 +1986,7 @@ function apply(ctx, config = {}) {
 
   restorePlatform(wechat, {
     platformKey: 'wechat',
-    numericFields: ['digestIntervalSec', 'approvalTimeoutSec', 'sendChunkDelayMs'],
+    numericFields: PLATFORM_TIMING_FIELDS,
     hasCredentials: (cfg) => Boolean(cfg.token && cfg.accountId),
     applyCredentials: (cfg) => wechat.gateway.setCredentials({
       token: cfg.token,
@@ -2019,6 +1997,7 @@ function apply(ctx, config = {}) {
 
   restorePlatform(qq, {
     platformKey: 'qq',
+    numericFields: PLATFORM_TIMING_FIELDS,
     hasCredentials: (cfg) => Boolean(cfg.appId && cfg.clientSecret),
     applyCredentials: (cfg) => qq.gateway.setCredentials({
       appId: cfg.appId,
@@ -2032,6 +2011,7 @@ function apply(ctx, config = {}) {
 
   restorePlatform(feishu, {
     platformKey: 'feishu',
+    numericFields: PLATFORM_TIMING_FIELDS,
     hasCredentials: (cfg) => Boolean(cfg.appId && cfg.appSecret),
     applyCredentials: (cfg) => feishu.gateway.updateConfig({
       appId: cfg.appId,
@@ -2042,7 +2022,7 @@ function apply(ctx, config = {}) {
 
   restorePlatform(telegram, {
     platformKey: 'telegram',
-    numericFields: ['digestIntervalSec', 'approvalTimeoutSec', 'sendChunkDelayMs'],
+    numericFields: PLATFORM_TIMING_FIELDS,
     defaultMaxMessageChars: 4096,
     hasCredentials: (cfg) => Boolean(cfg.botToken),
     applyCredentials: (cfg) => telegram.gateway.setCredentials({
@@ -2107,22 +2087,24 @@ function apply(ctx, config = {}) {
       if (incoming.customTunnel) {
         service.customTunnelConfig = incoming.customTunnel;
       }
-      // 重新载入各 IM 平台白名单与配置
-      if (incoming.wechat) wechat.node.config.allowFrom = incoming.wechat.allowFrom ?? [];
+      // 重新载入各 IM 平台白名单与配置（含 cwd/agentPreset/agentProvider/agentModel）
+      if (incoming.wechat) {
+        applyRestoredPlatformConfig(wechat.node.config, incoming.wechat, { stringFields: RESTORED_STRING_FIELDS });
+      }
       if (incoming.qq) {
-        qq.node.config.allowFrom = incoming.qq.allowFrom ?? [];
+        applyRestoredPlatformConfig(qq.node.config, incoming.qq, { stringFields: RESTORED_STRING_FIELDS });
         if (incoming.qq.appId && incoming.qq.clientSecret) {
           qq.gateway.setCredentials({ appId: incoming.qq.appId, clientSecret: incoming.qq.clientSecret });
         }
       }
       if (incoming.feishu) {
-        feishu.node.config.allowFrom = incoming.feishu.allowFrom ?? [];
+        applyRestoredPlatformConfig(feishu.node.config, incoming.feishu, { stringFields: RESTORED_STRING_FIELDS });
         if (incoming.feishu.appId && incoming.feishu.appSecret) {
           feishu.gateway.setCredentials({ appId: incoming.feishu.appId, appSecret: incoming.feishu.appSecret });
         }
       }
       if (incoming.telegram) {
-        telegram.node.config.allowFrom = incoming.telegram.allowFrom ?? [];
+        applyRestoredPlatformConfig(telegram.node.config, incoming.telegram, { stringFields: RESTORED_STRING_FIELDS });
         if (incoming.telegram.botToken) {
           telegram.gateway.setCredentials({ botToken: incoming.telegram.botToken, proxy: incoming.telegram.proxy || '' });
         }

package/lib/platform/commands.js

@@ -55,11 +55,25 @@ export async function routeCommand(node, text, senderId = null) {
 
       try {
         const session = node.activeSession()
-        if (session) {
-          session.title = newTitle
+        if (!session) {
+          // 会话尚未在内存中恢复（如宿主刚重启）：DSH 的会话标题服务只接受 live 会话，
+          // 此时无法真正改名，明确告知而不是回复一句"成功"却什么都没发生
+          await node.sendText(`❌ **无法重命名**：当前会话尚未恢复（宿主重启后需先发一条消息重新挂载）。\n\n> 发送任意消息后再次执行 \`/rename <新标题>\` 即可。`)
+          return true
         }
-        if (node.ctx.sessionPersistence?.update) {
-          await node.ctx.sessionPersistence.update(node.activeSessionId, { title: newTitle }).catch(() => {})
+        // 首选 DSH 原生会话标题服务：rename() 会追加 session/title 事件并落盘，
+        // 宿主重启与 Web 侧边栏都能看到。注意 sessionPersistence 并不提供 update()
+        // （真实方法只有 create/open/stat/list/...），旧写法被可选链静默跳过，
+        // 导致 /rename 只改了内存对象、重启即失效。
+        const titleService = node.ctx.get?.('sessionTitle')
+        if (titleService?.rename) {
+          titleService.rename(session, newTitle)
+        } else {
+          // 旧版 DSH 回退：内存标题立即可见，并尝试历史持久化接口（存在才用）
+          session.title = newTitle
+          if (node.ctx.sessionPersistence?.update) {
+            await node.ctx.sessionPersistence.update(node.activeSessionId, { title: newTitle }).catch(() => {})
+          }
         }
         await node.sendText(`✓ **会话重命名成功**\n- **会话 ID**：\`${fmtSessionId(node.activeSessionId)}\`\n- **新标题**：${newTitle}`)
       } catch (err) {

package/lib/platform/config-restore.js

@@ -0,0 +1,69 @@
+// 平台配置恢复（从 ~/.dsh/dsh-bridge/config.json 回写到会话桥 config）
+//
+// 背景：平台配置的写入链路把整段平台配置落在 config.json 里，但启动/重启时的
+// 读回链路只挑了几个白名单字段，导致 agentPreset / cwd / agentProvider / agentModel
+// 这类字符串配置"配了、重启就丢"，会话随后落到 DSH 默认 preset 或空 preset 层。
+//
+// 这里把恢复规则收敛成一个纯函数，既供 lib/index.js 的 restorePlatform 使用，
+// 也让"只恢复白名单字段"这条不变量可以被单测钉住。
+
+/**
+ * 恢复平台配置时必须透传的字符串字段白名单。
+ *
+ * 这四个键直接决定远程会话在哪里、以什么预设和模型启动：
+ *   - cwd           会话工作区（`/new` 建在哪个目录）
+ *   - agentPreset   DSH agent preset（决定该会话挂载的工具/提示词/技能目录）
+ *   - agentProvider / agentModel  会话默认模型路由
+ */
+export const RESTORED_STRING_FIELDS = ['agentPreset', 'cwd', 'agentProvider', 'agentModel']
+
+/**
+ * 各平台 `setConfig()` 会持久化、因此恢复时必须一并回写的数值字段。
+ *
+ * 写入侧（wechat / qq / feishu / telegram 的 setConfig）统一持久化这三个会话节奏参数；
+ * 恢复侧若漏掉，用户在设置页调好的摘要间隔 / 审批超时 / 分块延时只活到下一次重启。
+ * 写入侧新增数值字段时，必须同步这里。
+ */
+export const PLATFORM_TIMING_FIELDS = ['digestIntervalSec', 'approvalTimeoutSec', 'sendChunkDelayMs']
+
+/**
+ * 把 config.json 中某个平台的持久化配置回写到会话桥的 node.config。
+ *
+ * 规则（与磁盘上的写入契约一致）：
+ *   - allowFrom 一律以数组形式落回，缺失即空数组；
+ *   - numericFields 与 maxMessageChars 走数值归一，maxMessageChars 低于 200 视为无效并回落默认值；
+ *   - groupAutoApprove 仅在显式写入时按布尔解释；
+ *   - stringFields 只接受非空字符串，空串/非字符串一律忽略（保留构造期配置）。
+ *
+ * @param {object} nodeConfig 会话桥的 config 对象（就地修改）
+ * @param {object} cfg        config.json 里该平台的持久化配置
+ * @param {object} [opts]
+ * @param {string[]} [opts.numericFields] 需要数值归一化的字段名
+ * @param {string[]} [opts.stringFields]  需要字符串透传的字段名
+ * @param {number}   [opts.defaultMaxMessageChars] maxMessageChars 无效时的默认值
+ * @returns {object} 同一个 nodeConfig（便于串联）
+ */
+export function applyRestoredPlatformConfig(nodeConfig, cfg, {
+  numericFields = [],
+  stringFields = [],
+  defaultMaxMessageChars = 2000,
+} = {}) {
+  if (!nodeConfig || !cfg) return nodeConfig
+
+  nodeConfig.allowFrom = Array.isArray(cfg.allowFrom) ? cfg.allowFrom : []
+  for (const field of numericFields) {
+    if (cfg[field] != null) nodeConfig[field] = Number(cfg[field])
+  }
+  if (cfg.maxMessageChars != null) {
+    const val = Number(cfg.maxMessageChars)
+    nodeConfig.maxMessageChars = (val >= 200) ? val : defaultMaxMessageChars
+  }
+  if (cfg.groupAutoApprove != null) nodeConfig.groupAutoApprove = cfg.groupAutoApprove === true
+
+  for (const field of stringFields) {
+    const val = cfg[field]
+    // 只接受非空（且非纯空白）字符串：空串/垃圾值不应清掉或污染构造期配置
+    if (typeof val === 'string' && val.trim().length > 0) nodeConfig[field] = val
+  }
+  return nodeConfig
+}