cardbuddy 0.22.0 → 0.24.0

package/dist/vendored/skills/{finmall-card-sync → platform-card-sync}/scripts/api_batch_sync.mjs

@@ -2,14 +2,35 @@ import { mkdir, stat, writeFile, readFile, readdir } from 'node:fs/promises';
 import { createHash } from 'node:crypto';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { finmallConfig } from '../../shared/finmall-config.mjs';
+import { platformConfig } from '../../shared/platform-config.mjs';
+
+/**
+ * 对端站点 host（从配置派生，不写死域名）。
+ * 用于在多个标签页里认出「已登录的那个」——控制台里常同时开着本地 dev 页与对端页。
+ * 配置缺失时返回空串，调用方按「找不到就新建页」处理。
+ */
+const PLATFORM_HOST = (() => {
+  try {
+    return new URL(platformConfig.baseUrl).host;
+  } catch {
+    return '';
+  }
+})();
+/** 该标签页是否属于对端站点 */
+function isPlatformPage(page) {
+  try {
+    return Boolean(PLATFORM_HOST) && page.url().includes(PLATFORM_HOST);
+  } catch {
+    return false;
+  }
+}
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const skillDir = path.resolve(scriptDir, '..');
 // skill now lives under <repo-root>/skills/<name>: repo root is two levels up from skillDir
 const workspace = path.resolve(skillDir, '..', '..');
-// 与 finmall_login.mjs 保持一致的解析方式：用裸标识符让 Node 从项目根 node_modules 解析
-// playwright。原硬编码路径指向 .workbuddy/skills/finmall-session-navigator/scripts/node_modules
+// 与 platform_login.mjs 保持一致的解析方式：用裸标识符让 Node 从项目根 node_modules 解析
+// playwright。原硬编码路径指向 .workbuddy/skills/platform-session-navigator/scripts/node_modules
 // （该 node_modules 是已失效的断链符号链接），导致「Cannot find module」报错。
 const { chromium } = await import('playwright');
 
@@ -31,18 +52,18 @@ try {
 }
 
 // 后台会话管理：点击预览「同步远程数据」时自动拉起/复用无界面 Chrome 并登录，
-// 无需手动运行 finmall-session-navigator。
-import { ensureFinMallSession } from "../../finmall-session-navigator/scripts/session-manager.mjs";
+// 无需手动运行 platform-session-navigator。
+import { ensurePlatformSession } from "../../platform-session-navigator/scripts/session-manager.mjs";
 import {
   performLogin,
   clearTimeoutPrompts,
   waitForAuthenticatedPage,
   loadCredentials,
-} from "../../finmall-session-navigator/scripts/finmall_login.mjs";
+} from "../../platform-session-navigator/scripts/platform_login.mjs";
 
 // 代理处理：本机设了 HTTP_PROXY，但 Chrome 远程调试端口在 127.0.0.1，需把
 // localhost 排除在代理外，否则 connectOverCDP 会经代理拿到 502 / ECONNREFUSED。
-// 仅影响 Node 侧 CDP 连接；浏览器内访问 finmall.com 仍走代理。
+// 仅影响 Node 侧 CDP 连接；浏览器内访问对端站点仍走代理。
 for (const key of ["NO_PROXY", "no_proxy"]) {
   const cur = process.env[key];
   const extra = "127.0.0.1,localhost";
@@ -77,9 +98,9 @@ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 // 404，而是直接挂起不响应；page.evaluate 本身没有默认超时，裸 fetch 会把整次同步永久拖死。
 // 内部用 AbortController 掐断请求，外部再包一层 Promise.race 兜住 evaluate 自身不返回的情况。
 const COVER_FETCH_TIMEOUT_MS = Number(process.env.CARDBUDDY_COVER_TIMEOUT_MS || 15000);
-// FinMall 交易请求超时。IDC10001/IDC10012 偶发挂起（后端不响应），同样没有任何默认超时，
+// 远端交易请求超时。IDC10001/IDC10012 偶发挂起（后端不响应），同样没有任何默认超时，
 // 一张卡挂住就会拖垮整批同步——所以和预览图一样，内层 abort + 外层 race 双重设防。
-const FINMALL_POST_TIMEOUT_MS = Number(process.env.CARDBUDDY_POST_TIMEOUT_MS || 30000);
+const PLATFORM_POST_TIMEOUT_MS = Number(process.env.CARDBUDDY_POST_TIMEOUT_MS || 30000);
 // 卡片预览图上传（IDC10014.do）超时。与切图上传同款设防：内层 AbortController +
 // 外层 Promise.race 兜住 page.evaluate 自身不返回（evaluate 无默认超时）。
 const PREVIEW_UPLOAD_TIMEOUT_MS = Number(process.env.CARDBUDDY_PREVIEW_UPLOAD_TIMEOUT_MS || 30000);
@@ -94,37 +115,37 @@ function withTimeout(promise, ms, label) {
   ]).finally(() => clearTimeout(timer));
 }
 
-// 服务端判定会话/权限失效并应「重新进入」的特征集合。命中后由 finmallPostWithHeal
+// 服务端判定会话/权限失效并应「重新进入」的特征集合。命中后由 platformPostWithHeal
 // 自动清 session 重登再试一次——覆盖会话超时（BLEC0006）、token 失效、
 // 「您当前角色菜单权限发生变化，请重新进入」这类权限态异常，以及前端页面会话键丢失
 // （localStorage._sessionId 为空，如后台 Chrome 被清理/重启后）：本地凭证仍在即可自愈。
 const SESSION_INVALID_RE = /BLEC0006|会话超时|会话过期|登录超时|未登录|登录失效|登录已失效|请重新登录|invalid token|token|角色菜单权限发生变化|权限发生变化|重新进入|请重新进入|缺少会话凭据/i;
 
 /**
- * 带自愈的 FinMall 接口调用：正常请求，若命中会话/权限失效特征则清 session 重登后重试一次。
+ * 带自愈的远端接口调用：正常请求，若命中会话/权限失效特征则清 session 重登后重试一次。
  * 列表（IDC10001）与 schema（IDC10012）共用，确保任意一步出现权限态异常都能自动恢复。
  */
-async function finmallPostWithHeal(page, urlPath, requestBody, transCode = urlPath) {
+async function platformPostWithHeal(page, urlPath, requestBody, transCode = urlPath) {
   try {
-    return await finmallPost(page, urlPath, requestBody, transCode);
+    return await platformPost(page, urlPath, requestBody, transCode);
   } catch (error) {
     if (SESSION_INVALID_RE.test(error.message)) {
       log.warn('会话/权限失效，自动重新登录后重试', { url: urlPath, reason: error.message.slice(0, 40) });
       await relogin(page);
-      return await finmallPost(page, urlPath, requestBody, transCode);
+      return await platformPost(page, urlPath, requestBody, transCode);
     }
     throw error;
   }
 }
 
 /**
- * 从已认证的 FinMall 浏览器会话同步卡片到 src/cards。
+ * 从已认证的远端浏览器会话同步卡片到 src/cards。
  * 既可由 CLI 直接运行（api_batch_sync.mjs），也可被 Vite 中间件 import 后供预览「同步远程数据」按钮调用。
  *
- * 会话由 ensureFinMallSession 自动保证：若后台无界面 Chrome（专用端口）未启动或会话缺失，
+ * 会话由 ensurePlatformSession 自动保证：若后台无界面 Chrome（专用端口）未启动或会话缺失，
  * 会自动拉起并登录；完成后只 disconnect 不关闭进程，便于复用。
  * 若服务端会话/权限失效（IDC10012 返回 BLEC0006 或「角色菜单权限发生变化」等），
- * finmallPostWithHeal 会自动清 session 重登再重试。
+ * platformPostWithHeal 会自动清 session 重登再重试。
  *
  * @param {object} opts
  * @param {string} [opts.cardCode]     仅同步该英文卡 id（用列表接口 searchValue 定位）
@@ -135,7 +156,7 @@ async function finmallPostWithHeal(page, urlPath, requestBody, transCode = urlPa
  * @param {number} [opts.maxCards]     最多同步张数（不传=全部）
  * @param {string} [opts.appId]
  * @param {string} [opts.workspaceId]
- * @param {string} [opts.cdpUrl]       已废弃：会话现在由 ensureFinMallSession 在专用后台端口自动管理
+ * @param {string} [opts.cdpUrl]       已废弃：会话现在由 ensurePlatformSession 在专用后台端口自动管理
  * @param {string} [opts.outRoot]      输出根目录（默认 workspace/src/cards）
  * @param {(p: {done:number,total:number|null,currentId:string,currentTitle:string}) => void} [opts.onProgress]
  *                                     每张卡处理完毕后的进度回调（失败也回调），供前端进度条消费
@@ -157,8 +178,8 @@ export async function syncCards(opts = {}) {
   const startIndex = Number(opts.startIndex || 0);
   const pageSize = Number(opts.pageSize || 24);
   const maxCards = opts.maxCards != null ? Number(opts.maxCards) : Infinity;
-  const appId = opts.appId || finmallConfig.appId;
-  const workspaceId = opts.workspaceId || finmallConfig.workspaceId;
+  const appId = opts.appId || platformConfig.appId;
+  const workspaceId = opts.workspaceId || platformConfig.workspaceId;
   // 单卡筛选：传 cardCode 时仅同步该卡
   const cardCodeFilter = opts.cardCode || '';
   // 集合筛选：cardCodes 非空时仅同步集合内卡片（与单卡筛选互斥，单卡优先）。
@@ -175,8 +196,8 @@ export async function syncCards(opts = {}) {
   // 预期总张数：单卡=1；集合=集合大小；全量=0（未知，边拉边算）
   const expectedTotal = cardCodeFilter ? 1 : cardCodeSet ? cardCodeSet.size : 0;
 
-  // 自动确保后台 FinMall 会话：未启动/缺失则拉起无界面 Chrome 并登录，无需手动触发。
-  const session = await ensureFinMallSession();
+  // 自动确保后台远端会话：未启动/缺失则拉起无界面 Chrome 并登录，无需手动触发。
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   const summary = { success: true, synced: [], failed: [], duplicates: [] };
   // 重复 schema 检测：记录每张卡 schema 的 MD5，若不同 code 命中相同 schema 说明抓取仍串卡。
@@ -184,8 +205,8 @@ export async function syncCards(opts = {}) {
 
   try {
     const context = browser.contexts()[0];
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请检查凭据或重新触发同步。');
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请检查凭据或重新触发同步。');
     await page.bringToFront();
 
     const firstList = await fetchCardList(page, { pageNo: startPage, pageSize, appId, workspaceId, searchValue: cardCodeFilter });
@@ -256,7 +277,8 @@ export async function syncCards(opts = {}) {
     // 全部分页，allCards 即完整列表，整体刷新同样准确。缓存未就绪则跳过（不影响同步）。
     try {
       const cache = await getCardListCache();
-      if (cache) cache.refreshCardList(allCards, { full: !cardCodeFilter });
+      // 盖 appId / workspaceId 戳：环境切换后旧 app 的缓存会被闸门识别为失效而非误判
+      if (cache) cache.refreshCardList(allCards, { full: !cardCodeFilter, appId, workspaceId });
     } catch (e) {
       log.warn('刷新卡片列表缓存失败（不影响同步）', { error: e && e.message });
     }
@@ -269,7 +291,7 @@ export async function syncCards(opts = {}) {
 
 /**
  * 拉取远端完整卡片列表（IDC10001 分页全量），供编辑器「查看全部」网格浏览。
- * 只读、不落盘；与 syncCards 共用同一后台 FinMall 会话（ensureFinMallSession 自动保活）。
+ * 只读、不落盘；与 syncCards 共用同一后台远端会话（ensurePlatformSession 自动保活）。
  *
  * @param {object} [opts]
  * @param {number} [opts.pageSize=50]    列表分页大小
@@ -277,22 +299,22 @@ export async function syncCards(opts = {}) {
  * @param {string} [opts.appId]
  * @param {string} [opts.workspaceId]
  * @returns {Promise<Array<{id:string,title:string,cardId:string|number,coverUrl:string,picUrl:string,cardClassId:string}>>}
- *   id=英文卡 code（本地目录名同源）；coverUrl 为 FinMall 图片库绝对地址（可能为空串）；
+ *   id=英文卡 code（本地目录名同源）；coverUrl 为远端图片库绝对地址（可能为空串）；
  *   picUrl 为原始 `@filestore/...` 站内地址、cardClassId 为卡片类型 id，二者供「编辑基本信息」原样回传。
  */
 export async function listRemoteCards(opts = {}) {
-  const appId = opts.appId || finmallConfig.appId;
-  const workspaceId = opts.workspaceId || finmallConfig.workspaceId;
+  const appId = opts.appId || platformConfig.appId;
+  const workspaceId = opts.workspaceId || platformConfig.workspaceId;
   const pageSize = Number(opts.pageSize || 50);
   const maxPages = Number(opts.maxPages || 400);
 
-  // 自动确保后台 FinMall 会话：未启动/缺失则拉起无界面 Chrome 并登录，无需手动触发。
-  const session = await ensureFinMallSession();
+  // 自动确保后台远端会话：未启动/缺失则拉起无界面 Chrome 并登录，无需手动触发。
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
     const context = browser.contexts()[0];
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请检查凭据或重新触发。');
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请检查凭据或重新触发。');
     await page.bringToFront();
 
     const out = [];
@@ -333,11 +355,11 @@ export async function listRemoteCards(opts = {}) {
   }
 }
 
-/** 从后台会话中取出 FinMall 页面（列表 / 字典 / 新建 / 编辑共用同一页面上下文） */
-function finmallPage(browser) {
+/** 从后台会话中取出远端页面（列表 / 字典 / 新建 / 编辑共用同一页面上下文） */
+function platformPage(browser) {
   const context = browser.contexts()[0];
-  const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-  if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请检查凭据或重新触发。');
+  const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+  if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请检查凭据或重新触发。');
   return page;
 }
 
@@ -353,14 +375,14 @@ function finmallPage(browser) {
  * @returns {Promise<Array<{id:string,name:string,count:number}>>}
  */
 export async function listRemoteCardTypes(opts = {}) {
-  const appId = opts.appId || finmallConfig.appId;
-  const workspaceId = opts.workspaceId || finmallConfig.workspaceId;
-  const session = await ensureFinMallSession();
+  const appId = opts.appId || platformConfig.appId;
+  const workspaceId = opts.workspaceId || platformConfig.workspaceId;
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
-    const page = finmallPage(browser);
+    const page = platformPage(browser);
     await page.bringToFront();
-    const body = await finmallPostWithHeal(
+    const body = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10009.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -395,20 +417,20 @@ export async function listRemoteCardTypes(opts = {}) {
  * @returns {Promise<{cardId:string, code:string}>}
  */
 export async function createRemoteCard(input = {}) {
-  const appId = input.appId || finmallConfig.appId;
-  const workspaceId = input.workspaceId || finmallConfig.workspaceId;
+  const appId = input.appId || platformConfig.appId;
+  const workspaceId = input.workspaceId || platformConfig.workspaceId;
   const code = String(input.code || '').trim();
   const cardName = String(input.cardName || '').trim();
   if (!/^[A-Za-z0-9_-]+$/.test(code)) throw new Error(`卡片编码非法（仅允许字母/数字/_/-）：${code || '(空)'}`);
   if (!cardName) throw new Error('卡片名称不能为空');
   if (input.cardClassId == null || String(input.cardClassId) === '') throw new Error('请选择卡片类型');
 
-  const session = await ensureFinMallSession();
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
-    const page = finmallPage(browser);
+    const page = platformPage(browser);
     await page.bringToFront();
-    const body = await finmallPostWithHeal(
+    const body = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10002.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -439,8 +461,8 @@ export async function createRemoteCard(input = {}) {
  * @returns {Promise<{cardId:string, code:string}>}
  */
 export async function updateRemoteCard(input = {}) {
-  const appId = input.appId || finmallConfig.appId;
-  const workspaceId = input.workspaceId || finmallConfig.workspaceId;
+  const appId = input.appId || platformConfig.appId;
+  const workspaceId = input.workspaceId || platformConfig.workspaceId;
   const cardId = String(input.cardId || '');
   const code = String(input.code || '').trim();
   const cardName = String(input.cardName || '').trim();
@@ -449,14 +471,14 @@ export async function updateRemoteCard(input = {}) {
   if (!cardName) throw new Error('卡片名称不能为空');
   if (input.cardClassId == null || String(input.cardClassId) === '') throw new Error('请选择卡片类型');
 
-  const session = await ensureFinMallSession();
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
-    const page = finmallPage(browser);
+    const page = platformPage(browser);
     await page.bringToFront();
     // 线上实测：IDC10008 的 URL 不带 sassAppId 查询串（只有 transCode 里带），
     // 带了也能用；此处按实测的干净路径发送，减少与官方实现的差异面。
-    const body = await finmallPostWithHeal(
+    const body = await platformPostWithHeal(
       page,
       '/ubomp-web/IDC10008.do',
       {
@@ -485,25 +507,25 @@ export async function updateRemoteCard(input = {}) {
  *   { channel:'', cardId }
  * 即只认数字主键 cardId（列表行数据的 `id`），**不传英文 code**。
  *
- * 不可逆：删除后该卡在 FinMall 侧的元数据与已发布版本一并消失，无法通过重新新建
+ * 不可逆：删除后该卡在远端侧的元数据与已发布版本一并消失，无法通过重新新建
  * 恢复同一 cardId。调用方必须在执行前做二次确认。本地 src/cards/<code> 目录不受影响。
  *
  * @param {{cardId:string|number, channel?:string, appId?:string, workspaceId?:string}} input
  * @returns {Promise<{cardId:string}>}
  */
 export async function deleteRemoteCard(input = {}) {
-  const appId = input.appId || finmallConfig.appId;
-  const workspaceId = input.workspaceId || finmallConfig.workspaceId;
+  const appId = input.appId || platformConfig.appId;
+  const workspaceId = input.workspaceId || platformConfig.workspaceId;
   const cardId = String(input.cardId || '').trim();
   if (!cardId) throw new Error('缺少 cardId，无法删除远端卡片');
 
-  const session = await ensureFinMallSession();
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
-    const page = finmallPage(browser);
+    const page = platformPage(browser);
     await page.bringToFront();
     // 与 IDC10002（新建）同一写法：URL 带 sassAppId / sassWorkspaceId，transCode 取默认（同 URL）
-    await finmallPostWithHeal(
+    await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10003.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -518,8 +540,8 @@ export async function deleteRemoteCard(input = {}) {
 }
 
 /**
- * 把一张卡片的最新 schema 写回 FinMall（线上编辑器「保存」接口 IDC10010.do）。
- * 与 syncCards 共用同一套已登录浏览器会话与带自愈的 finmallPost，
+ * 把一张卡片的最新 schema 写回远端（线上编辑器「保存」接口 IDC10010.do）。
+ * 与 syncCards 共用同一套已登录浏览器会话与带自愈的 platformPost，
  * 确保任意一步会话/权限失效都能自动重登重试。
  *
  * 入参 schema 即本地 src/cards/<id>/schema.json 的完整内容（含 pageId / dictionary / view …）。
@@ -528,7 +550,7 @@ export async function deleteRemoteCard(input = {}) {
  *   - body.schemaValue = 整张 schema 的 JSON 字符串（非对象）
  *   - body.skeletonScreen = 骨架屏 SVG（仅用于编辑器列表缩略图，可传空串）
  *
- * 保存成功后默认立刻读回（IDC10012.do）做落库校验——FinMall 网关有
+ * 保存成功后默认立刻读回（IDC10012.do）做落库校验——远端网关有
  * 「errorCode=0 但 body 空/未落库」的静默空返回先例，不校验无法判断真实生效。
  *
  * @param {object} schema  完整卡片 schema（含 pageId）
@@ -540,14 +562,14 @@ export async function saveCardToRemote(schema, { skeletonScreen = '', verify = t
   if (!schema || !schema.pageId) {
     throw new Error('schema 缺少 pageId，无法确定要保存的卡片（IDC10010.do 需要数字型 cardId）。')
   }
-  const appId = finmallConfig.appId
-  const workspaceId = finmallConfig.workspaceId
-  const session = await ensureFinMallSession()
+  const appId = platformConfig.appId
+  const workspaceId = platformConfig.workspaceId
+  const session = await ensurePlatformSession()
   const browser = session.browser
   try {
     const context = browser.contexts()[0]
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0]
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请检查凭据或重新触发同步。')
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0]
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请检查凭据或重新触发同步。')
     await page.bringToFront()
 
     // 保护远端列表缩略图：本地未提供骨架屏时，先读回远端已有的 skeletonScreen 复用，
@@ -555,7 +577,7 @@ export async function saveCardToRemote(schema, { skeletonScreen = '', verify = t
     let sk = skeletonScreen && String(skeletonScreen).trim() ? skeletonScreen : ''
     if (!sk) {
       try {
-        const pre = await finmallPostWithHeal(page, '/ubomp-web/IDC10012.do', {
+        const pre = await platformPostWithHeal(page, '/ubomp-web/IDC10012.do', {
           cardId: String(schema.pageId),
           sassAppId: appId,
           sassWorkspaceId: workspaceId,
@@ -565,7 +587,7 @@ export async function saveCardToRemote(schema, { skeletonScreen = '', verify = t
     }
     if (!sk) sk = '<svg xmlns="http://www.w3.org/2000/svg" width="200" height="400"></svg>'
 
-    // finmallPost 会把 requestBody 放进 payload.body，并自己生成 payload.header；
+    // platformPost 会把 requestBody 放进 payload.body，并自己生成 payload.header；
     // 因此这里只传「内层 body」（与读接口 fetchCardSchema 保持一致），切勿再包一层 {header, body}。
     // 关键：IDC10010.do 需要 sassAppId/sassWorkspaceId（与读接口一致），缺失会返回 PEO000003。
     const innerBody = {
@@ -577,13 +599,13 @@ export async function saveCardToRemote(schema, { skeletonScreen = '', verify = t
     }
     const urlPath = `/ubomp-web/IDC10010.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`
     log.info('保存卡片', { pageId: schema.pageId, name: schema.name || '' })
-    const response = await finmallPostWithHeal(page, urlPath, innerBody, 'IDC10010.do')
+    const response = await platformPostWithHeal(page, urlPath, innerBody, 'IDC10010.do')
 
     // 落库校验：保存后立刻读回，确认内容真的写进去了（而非静默空返回）。
     const verified = { ok: false, cardIdMatched: false, fingerprintMatched: false, diff: null, readBackError: null }
     if (verify) {
       try {
-        const readBody = await finmallPostWithHeal(page, '/ubomp-web/IDC10012.do', {
+        const readBody = await platformPostWithHeal(page, '/ubomp-web/IDC10012.do', {
           cardId: String(schema.pageId),
           sassAppId: appId,
           sassWorkspaceId: workspaceId,
@@ -621,7 +643,7 @@ export async function saveCardToRemote(schema, { skeletonScreen = '', verify = t
  *   - 没有 `fileName` 纯文本字段；
  *   - 鉴权头只有 `token`。
  *
- * token 仅在页面上下文内读取并直接用于请求，不回传 Node 侧、不打印、不落盘（与 finmallPost 同纪律）。
+ * token 仅在页面上下文内读取并直接用于请求，不回传 Node 侧、不打印、不落盘（与 platformPost 同纪律）。
  *
  * @returns {Promise<string>} 原始响应文本（交由 parsePreviewUploadResponse 解析）
  */
@@ -651,7 +673,7 @@ async function postPreviewUpload(page, { cardId, fileName, base64, appId, worksp
         };
         const sessionToken = readSessionToken();
         if (!sessionToken) {
-          throw new Error('页面缺少会话凭据（localStorage._sessionId 为空），请先运行 finmall-session-navigator 登录。');
+          throw new Error('页面缺少会话凭据（localStorage._sessionId 为空），请先运行 platform-session-navigator 登录。');
         }
         const binary = atob(base64);
         const bytes = new Uint8Array(binary.length);
@@ -683,7 +705,7 @@ async function postPreviewUpload(page, { cardId, fileName, base64, appId, worksp
 /**
  * 解析 IDC10014.do 响应（导出仅为单测可直接断言；正常路径走 uploadCardPreview）。
  *
- * 该接口的响应体形态没有可比对的既有文档，故按 FinMall 交易接口的通用信封
+ * 该接口的响应体形态没有可比对的既有文档，故按远端交易接口的通用信封
  * （`{header:{errorCode,errorMsg}, body:{...}}`）做**宽松**判定：
  *   - 空响应体 → 视为成功（HTTP 2xx 已由调用方保证，接口可能不返回业务体）；
  *   - 非 JSON 非空 → 直接报错（多半是网关 HTML 错误页，不能当成功）；
@@ -712,7 +734,7 @@ export function parsePreviewUploadResponse(text, cardId) {
   const bad = codes.find((c) => String(c) !== '0');
   if (bad != null) {
     throw new Error(
-      `FinMall 预览图上传失败 [errorCode=${bad}] ${header.errorMsg || body.errorMsg || ''} | ${raw.slice(0, 300)}`,
+      `远端预览图上传失败 [errorCode=${bad}] ${header.errorMsg || body.errorMsg || ''} | ${raw.slice(0, 300)}`,
     );
   }
   // 地址字段多键兜底：接口未回地址属正常（上传即生效），所以这里只做尽力提取。
@@ -728,10 +750,10 @@ export function parsePreviewUploadResponse(text, cardId) {
 
 /**
  * 上传卡片预览图到远端（IDC10014.do）。供「推送」成功后由 server/core/cardSave.js 调用：
- * 本地无头渲染出透明底 PNG → 交给已登录的 FinMall 后台会话上传，卡片列表缩略图随之更新。
+ * 本地无头渲染出透明底 PNG → 交给已登录的远端后台会话上传，卡片列表缩略图随之更新。
  *
  * 与 saveCardToRemote 的会话纪律一致：saveCardToRemote 末尾会 disconnect，故本函数自行
- * ensureFinMallSession 重新取一次连接（Chrome 已常驻时这一步是廉价的 attach）。
+ * ensurePlatformSession 重新取一次连接（Chrome 已常驻时这一步是廉价的 attach）。
  * 会话/权限失效命中 SESSION_INVALID_RE 时自动清 session 重登并重试一次。
  *
  * @param {{ cardId: string|number, pngBase64: string, appId?: string, workspaceId?: string }} opts
@@ -744,16 +766,16 @@ export async function uploadCardPreview({ cardId, pngBase64, appId, workspaceId
   }
   const base64 = String(pngBase64 == null ? '' : pngBase64);
   if (!base64) throw new Error('上传卡片预览图缺少 PNG 内容（pngBase64 为空）。');
-  const appIdv = appId || finmallConfig.appId;
-  const workspaceIdv = workspaceId || finmallConfig.workspaceId;
+  const appIdv = appId || platformConfig.appId;
+  const workspaceIdv = workspaceId || platformConfig.workspaceId;
   const fileName = `${id}.png`;
 
-  const session = await ensureFinMallSession();
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
     const context = browser.contexts()[0];
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请检查凭据或重新触发同步。');
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请检查凭据或重新触发同步。');
     await page.bringToFront();
 
     const payload = { cardId: id, fileName, base64, appId: appIdv, workspaceId: workspaceIdv };
@@ -788,7 +810,7 @@ export async function uploadCardPreview({ cardId, pngBase64, appId, workspaceId
  * 前端据返回的 cardCode 生成 scheme 二维码：
  *   app://previewCard?cardId=<id>&cardCode=<code>&cardVersion=00000000&socket=<wss>
  *
- * 会话由 ensureFinMallSession 自动保证；与「保存到远端」共用同一套已登录后台 Chrome。
+ * 会话由 ensurePlatformSession 自动保证；与「保存到远端」共用同一套已登录后台 Chrome。
  * 注意：saveCardToRemote 内部会自行 ensure+disconnect，故本函数先调用它（自带会话），
  * 之后再重新 ensure 一次拿干净会话处理后续三个接口，避免复用已被 disconnect 的 page。
  *
@@ -800,8 +822,8 @@ export async function previewCardRemote(schema, { skeletonScreen = '', publish =
   if (!schema || !schema.pageId) {
     throw new Error('schema 缺少 pageId，无法确定要预览的卡片（IDC10020.do 需要 cardId）。')
   }
-  const appId = finmallConfig.appId
-  const workspaceId = finmallConfig.workspaceId
+  const appId = platformConfig.appId
+  const workspaceId = platformConfig.workspaceId
   const cardId = String(schema.pageId)
   const result = { cardCode: '', version: '00000000', steps: {} }
 
@@ -816,17 +838,17 @@ export async function previewCardRemote(schema, { skeletonScreen = '', publish =
   }
 
   // 后续三个接口使用一次干净的会话
-  const session = await ensureFinMallSession()
+  const session = await ensurePlatformSession()
   const browser = session.browser
   try {
     const context = browser.contexts()[0]
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0]
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。')
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0]
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。')
     await page.bringToFront()
 
     // 2) 取卡片 code（对齐 ubomp queryCardDetail → IDC10015.do 的 code 字段）
     try {
-      const detail = await finmallPostWithHeal(
+      const detail = await platformPostWithHeal(
         page,
         `/ubomp-web/IDC10015.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
         { cardId, sassAppId: appId, sassWorkspaceId: workspaceId },
@@ -840,7 +862,7 @@ export async function previewCardRemote(schema, { skeletonScreen = '', publish =
     // 3) 发布预览测试版（对齐 ubomp submitForm → IDC10020.do）
     if (publish) {
       try {
-        await finmallPostWithHeal(
+        await platformPostWithHeal(
           page,
           `/ubomp-web/IDC10020.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
           {
@@ -862,7 +884,7 @@ export async function previewCardRemote(schema, { skeletonScreen = '', publish =
     // 4) 消息通知（对齐 ubomp doNotify → IDC10021.do）
     if (notify) {
       try {
-        await finmallPostWithHeal(
+        await platformPostWithHeal(
           page,
           `/ubomp-web/IDC10021.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
           { agentId: cardId, sassAppId: appId, sassWorkspaceId: workspaceId },
@@ -882,7 +904,7 @@ export async function previewCardRemote(schema, { skeletonScreen = '', publish =
 }
 
 /**
- * FinMall 版本号格式：8 位「年份 + 4 位序号」，如 20260025。
+ * 远端版本号格式：8 位「年份 + 4 位序号」，如 20260025。
  * 该格式的最小值约 20200001，故任何 < 10000000 的纯数字都不符合格式
  * （含旧实现首发时误写出的 1 / 2 / 3…）。
  */
@@ -916,7 +938,7 @@ export function nextPublishVersion(maxVersion) {
  *   2) IDC10016.do 以 nextPublishVersion(maxVersion) 作为新版本号发布（发布的是远端「当前已保存」的卡片内容——
  *      故发布前应先用「推送当前卡」把本地内容保存到远端，否则会发布陈旧内容）。
  *      版本号格式为 8 位「年份 + 4 位序号」：远端从未发布时取 `${当前年份}0001`（不是裸 1）。
- * 会话由 ensureFinMallSession 自动保证；与 saveCardToRemote / syncCards / previewCardRemote
+ * 会话由 ensurePlatformSession 自动保证；与 saveCardToRemote / syncCards / previewCardRemote
  * 共用同一套已登录后台 Chrome，命中会话/权限失效（BLEC0006 等）时自动清 session 重登重试一次。
  *
  * @param {object} schema 当前卡片 schema（需含 pageId）
@@ -926,19 +948,19 @@ export async function publishCard(schema) {
   if (!schema || !schema.pageId) {
     throw new Error('schema 缺少 pageId，无法确定要发布的卡片（IDC10016.do 需要 cardId）。')
   }
-  const appId = finmallConfig.appId
-  const workspaceId = finmallConfig.workspaceId
+  const appId = platformConfig.appId
+  const workspaceId = platformConfig.workspaceId
   const cardId = String(schema.pageId)
-  const session = await ensureFinMallSession()
+  const session = await ensurePlatformSession()
   const browser = session.browser
   try {
     const context = browser.contexts()[0]
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0]
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。')
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0]
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。')
     await page.bringToFront()
 
     // 1) 取当前最大版本号
-    const maxResp = await finmallPostWithHeal(
+    const maxResp = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10004.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       { cardId, pageNo: 1, pageSize: 1, sassAppId: appId, sassWorkspaceId: workspaceId },
@@ -949,7 +971,7 @@ export async function publishCard(schema) {
     log.info('发布前取最大版本', { cardId, maxVersion, nextVersion })
 
     // 2) 以 maxVersion+1 发布（发布类型/平台等参数对齐 ubomp 发布弹窗的默认值）
-    const response = await finmallPostWithHeal(
+    const response = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10016.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -978,7 +1000,7 @@ export async function publishCard(schema) {
 /**
  * 取远端「当前卡片最新版本号」：IDC10004 返回 maxVersion（该卡线上已发布的最高版本）。
  * 供 UI「卡片来源」tab 展示「远端最新版本」，让用户一眼看到线上当前版本。
- * 只读、不发布；与 publishCard 共用同一后台 FinMall 会话（ensureFinMallSession + finmallPostWithHeal）。
+ * 只读、不发布；与 publishCard 共用同一后台远端会话（ensurePlatformSession + platformPostWithHeal）。
  * @param {string|number} cardId
  * @returns {Promise<{ maxVersion: string }>}
  */
@@ -986,17 +1008,17 @@ export async function fetchCardLatestVersion(cardId) {
   if (cardId == null) {
     throw new Error('缺少 cardId，无法查询远端版本（IDC10004.do 需要 cardId）。')
   }
-  const appId = finmallConfig.appId
-  const workspaceId = finmallConfig.workspaceId
+  const appId = platformConfig.appId
+  const workspaceId = platformConfig.workspaceId
   const id = String(cardId)
-  const session = await ensureFinMallSession()
+  const session = await ensurePlatformSession()
   const browser = session.browser
   try {
     const context = browser.contexts()[0]
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0]
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。')
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0]
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。')
     await page.bringToFront()
-    const maxResp = await finmallPostWithHeal(
+    const maxResp = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10004.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       { cardId: id, pageNo: 1, pageSize: 1, sassAppId: appId, sassWorkspaceId: workspaceId },
@@ -1044,8 +1066,8 @@ function normalizeVersionTask(raw) {
  * 取远端「发布版本记录」分页列表：IDC10004.do 的 versionList（新→旧，最多一页 pageSize 条）。
  * 供调试面板「导入信息」tab 的「发布版本记录」弹框渲染
  * （版本号 / 平台 / 状态 / 发布时间 / 操作：停止发布）。
- * 只读；与 fetchCardLatestVersion / fetchCardHistory 共用同一后台 FinMall 会话
- * （ensureFinMallSession + finmallPostWithHeal，命中会话失效自动清 session 重登重试一次）。
+ * 只读；与 fetchCardLatestVersion / fetchCardHistory 共用同一后台远端会话
+ * （ensurePlatformSession + platformPostWithHeal，命中会话失效自动清 session 重登重试一次）。
  *
  * 响应体（逆向 innermanage 前端 inner_flamePublish 页面）：
  *   body.versionList[] = { versionId, version, platformStatus（JSON 字符串，如 '["iOS","Android"]'）,
@@ -1075,17 +1097,17 @@ export async function fetchCardPublishVersions(
   if (cardId == null) {
     throw new Error('缺少 cardId，无法查询发布版本记录（IDC10004.do 需要 cardId）。');
   }
-  const appId = finmallConfig.appId;
-  const workspaceId = finmallConfig.workspaceId;
+  const appId = platformConfig.appId;
+  const workspaceId = platformConfig.workspaceId;
   const id = String(cardId);
-  const session = await ensureFinMallSession();
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
     const context = browser.contexts()[0];
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。');
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。');
     await page.bringToFront();
-    const resp = await finmallPostWithHeal(
+    const resp = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10004.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -1136,7 +1158,7 @@ export async function fetchCardPublishVersions(
       await Promise.all(
         pending.slice(i, i + TASK_CONCURRENCY).map(async (row) => {
           try {
-            const taskResp = await finmallPostWithHeal(
+            const taskResp = await platformPostWithHeal(
               page,
               `/ubomp-web/IDC20002.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
               { packageInfoId: row.versionId },
@@ -1190,17 +1212,17 @@ export async function fetchCardVersionTasks(packageInfoId) {
   if (packageInfoId == null || packageInfoId === '') {
     throw new Error('缺少 packageInfoId（版本记录 versionId），无法查询发布任务（IDC20002.do）。');
   }
-  const appId = finmallConfig.appId;
-  const workspaceId = finmallConfig.workspaceId;
+  const appId = platformConfig.appId;
+  const workspaceId = platformConfig.workspaceId;
   const id = String(packageInfoId);
-  const session = await ensureFinMallSession();
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
     const context = browser.contexts()[0];
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。');
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。');
     await page.bringToFront();
-    const resp = await finmallPostWithHeal(
+    const resp = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC20002.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       { packageInfoId: id },
@@ -1234,16 +1256,16 @@ export async function updateCardTaskStatus({ taskId, taskStatus = '0' } = {}) {
   if (taskId == null || taskId === '') {
     throw new Error('缺少 taskId，无法变更发布任务状态（IDC20003.do 需要 taskId）。');
   }
-  const appId = finmallConfig.appId;
-  const workspaceId = finmallConfig.workspaceId;
-  const session = await ensureFinMallSession();
+  const appId = platformConfig.appId;
+  const workspaceId = platformConfig.workspaceId;
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
     const context = browser.contexts()[0];
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0];
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。');
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0];
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。');
     await page.bringToFront();
-    const body = await finmallPostWithHeal(
+    const body = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC20003.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -1287,16 +1309,16 @@ export async function createCardPublishTask({ cardId, versionId, version = "", m
   if (cardId == null || cardId === "" || versionId == null || versionId === "") {
     throw new Error("缺少 cardId / versionId，无法创建发布任务（IDC20004.do 需要两者）。");
   }
-  const appId = finmallConfig.appId;
-  const workspaceId = finmallConfig.workspaceId;
-  const session = await ensureFinMallSession();
+  const appId = platformConfig.appId;
+  const workspaceId = platformConfig.workspaceId;
+  const session = await ensurePlatformSession();
   const browser = session.browser;
   try {
     const context = browser.contexts()[0];
     const page = context?.pages().find((p) => p.url().includes("finmall.com")) || context?.pages()[0];
-    if (!page) throw new Error("未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。");
+    if (!page) throw new Error("未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。");
     await page.bringToFront();
-    const body = await finmallPostWithHeal(
+    const body = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC20004.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       {
@@ -1325,7 +1347,7 @@ export async function createCardPublishTask({ cardId, versionId, version = "", m
 /**
  * 取远端「卡片历史版本时间线」：IDC10013 按 cardId 分页返回 schemaValueList（新→旧）。
  * 供编辑器「卡片历史记录」tab 渲染 git 式时间线。只读；与 fetchCardLatestVersion 共用
- * 同一后台 FinMall 会话（ensureFinMallSession + finmallPostWithHeal）。
+ * 同一后台远端会话（ensurePlatformSession + platformPostWithHeal）。
  *
  * schema 全量（每条数 KB~上百 KB）不跨端透传：服务端就地解析为轻量摘要 + 相邻版本 diff
  * 标签，响应体积与 schema 大小解耦，UI 拿到的就是可直接渲染的字段。
@@ -1339,7 +1361,7 @@ export async function createCardPublishTask({ cardId, versionId, version = "", m
 // fetchCardHistory（时间线列表）本来就会解析页内全部 schema 算 diff，顺手按
 // (cardId, versionId) 缓存；fetchCardVersionSchema 命中缓存时零网络请求，
 // 把点击到加载的等待从 ~7s 降到毫秒级。未命中仍走原分页翻找兜底。
-const SCHEMA_CACHE_TTL_MS = Number(process.env.FINMALL_SCHEMA_CACHE_TTL_MS || 300000)
+const SCHEMA_CACHE_TTL_MS = Number(process.env.PLATFORM_SCHEMA_CACHE_TTL_MS || 300000)
 const SCHEMA_CACHE_MAX = 500
 const _versionSchemaCache = new Map() // `${cardId}::${versionId}` → { schema, createTime, at }
 
@@ -1371,17 +1393,17 @@ export async function fetchCardHistory(cardId, { pageNo = 1, pageSize = 30 } = {
   if (cardId == null) {
     throw new Error('缺少 cardId，无法查询远端历史（IDC10013.do 需要 cardId）。')
   }
-  const appId = finmallConfig.appId
-  const workspaceId = finmallConfig.workspaceId
+  const appId = platformConfig.appId
+  const workspaceId = platformConfig.workspaceId
   const id = String(cardId)
-  const session = await ensureFinMallSession()
+  const session = await ensurePlatformSession()
   const browser = session.browser
   try {
     const context = browser.contexts()[0]
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0]
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。')
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0]
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。')
     await page.bringToFront()
-    const resp = await finmallPostWithHeal(
+    const resp = await platformPostWithHeal(
       page,
       `/ubomp-web/IDC10013.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`,
       { cardId: id, pageNo, pageSize, sassAppId: appId, sassWorkspaceId: workspaceId },
@@ -1442,20 +1464,20 @@ export async function fetchCardVersionSchema(cardId, versionId) {
     log.info('命中版本 schema 缓存（零网络）', { cardId: id, versionId: want })
     return { schema: cached.schema, record: { id: want, createTime: cached.createTime || '' } }
   }
-  const appId = finmallConfig.appId
-  const workspaceId = finmallConfig.workspaceId
-  const session = await ensureFinMallSession()
+  const appId = platformConfig.appId
+  const workspaceId = platformConfig.workspaceId
+  const session = await ensurePlatformSession()
   const browser = session.browser
   try {
     const context = browser.contexts()[0]
-    const page = context?.pages().find((p) => p.url().includes('finmall.com')) || context?.pages()[0]
-    if (!page) throw new Error('未能在后台 Chrome 中找到 FinMall 页面，请先运行 finmall-session-navigator 登录。')
+    const page = context?.pages().find((p) => isPlatformPage(p)) || context?.pages()[0]
+    if (!page) throw new Error('未能在后台 Chrome 中找到远端页面，请先运行 platform-session-navigator 登录。')
     await page.bringToFront()
     const url = `/ubomp-web/IDC10013.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`
     let pageNo = 1
     let totalPages = 1
     do {
-      const resp = await finmallPostWithHeal(
+      const resp = await platformPostWithHeal(
         page,
         url,
         { cardId: id, pageNo, pageSize: 100, sassAppId: appId, sassWorkspaceId: workspaceId },
@@ -1626,7 +1648,7 @@ function parseArgs(argv) {
 }
 
 async function fetchCardList(page, { pageNo, pageSize, appId, workspaceId, searchValue = '' }) {
-  const body = await finmallPostWithHeal(page, `/ubomp-web/IDC10001.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`, {
+  const body = await platformPostWithHeal(page, `/ubomp-web/IDC10001.do?sassAppId=${appId}&sassWorkspaceId=${workspaceId}`, {
     channel: '',
     applyScene: '1',
     pageNo,
@@ -1640,7 +1662,7 @@ async function fetchCardList(page, { pageNo, pageSize, appId, workspaceId, searc
 }
 
 /**
- * 拉取远端 schema。返回 `null` 表示「空白卡」——该卡片在 FinMall 侧从未保存过
+ * 拉取远端 schema。返回 `null` 表示「空白卡」——该卡片在远端侧从未保存过
  * schema（新建后未编辑），IDC10012.do 会返回 errorCode=0 但 body 无 schemaValue。
  * 这是合法状态而非主键错误，调用方须走「空白卡落盘」分支，不要当成同步失败。
  */
@@ -1651,7 +1673,7 @@ async function fetchCardSchema(page, card, { appId, workspaceId }) {
   // dialog 变体的 cardId 本就不同（如 activityLevel=10000840 / activityLevelDialog=10000841），
   // 因此按 cardId 抓取不会串卡；此前的串卡来自已废弃的编辑器 DOM 抓取路径。
   if (!card.cardId) throw new Error(`列表未返回 cardId，无法抓取 ${card.id} 的 schema。`);
-  const body = await finmallPostWithHeal(page, '/ubomp-web/IDC10012.do', {
+  const body = await platformPostWithHeal(page, '/ubomp-web/IDC10012.do', {
     cardId: card.cardId,
     sassAppId: appId,
     sassWorkspaceId: workspaceId,
@@ -1673,9 +1695,9 @@ async function fetchCardSchema(page, card, { appId, workspaceId }) {
 }
 
 /**
- * 取 schema（已在 finmallPostWithHeal 内带会话/权限失效自愈）。
+ * 取 schema（已在 platformPostWithHeal 内带会话/权限失效自愈）。
  * IDC10012.do 只接受数字型 `cardId` 作为主键，命中 SESSION_INVALID_RE 特征时
- * finmallPostWithHeal 会自动清 session 重登再试一次，覆盖会话超时与权限态异常。
+ * platformPostWithHeal 会自动清 session 重登再试一次，覆盖会话超时与权限态异常。
  */
 
 /** 清空过期会话并以保存的凭据重新登录（复用导航器的登录逻辑，全程在页面上下文内完成）。 */
@@ -1689,7 +1711,7 @@ async function relogin(page) {
         /* ignore */
       }
     }),
-    FINMALL_POST_TIMEOUT_MS,
+    PLATFORM_POST_TIMEOUT_MS,
     'page.evaluate(localStorage.clear)',
   ).catch(() => {});
   await page.reload({ waitUntil: "domcontentloaded", timeout: 15000 }).catch(() => {});
@@ -1708,12 +1730,12 @@ async function relogin(page) {
   await waitForAuthenticatedPage(page, 20000);
 }
 
-async function finmallPost(page, urlPath, requestBody, transCode = urlPath) {
+async function platformPost(page, urlPath, requestBody, transCode = urlPath) {
   return withTimeout(
     page.evaluate(async ({ urlPath, requestBody, transCode, timeoutMs }) => {
       const controller = new AbortController();
       setTimeout(() => controller.abort(), timeoutMs);
-      // FinMall 不用 Cookie 鉴权（document.cookie 恒为空），会话凭据存在 localStorage
+      // 远端不用 Cookie 鉴权（document.cookie 恒为空），会话凭据存在 localStorage
       // 的 `_sessionId` 中，由前端以 `token` 请求头透传。缺这个头时 IDC10001.do（不鉴权）
       // 仍能返回，但 IDC10012.do 会返回 BLEC0006「会话超时」——这正是此前抓取失败的根因。
       // 该值仅在页面上下文内读取并直接用于请求，不回传 Node 侧、不打印、不落盘。
@@ -1733,7 +1755,7 @@ async function finmallPost(page, urlPath, requestBody, transCode = urlPath) {
       };
       const sessionToken = readSessionToken();
       if (!sessionToken) {
-        throw new Error('页面缺少会话凭据（localStorage._sessionId 为空），请先运行 finmall-session-navigator 登录。');
+        throw new Error('页面缺少会话凭据（localStorage._sessionId 为空），请先运行 platform-session-navigator 登录。');
       }
       const url = new URL(urlPath, location.origin).href;
       const payload = {
@@ -1772,12 +1794,12 @@ async function finmallPost(page, urlPath, requestBody, transCode = urlPath) {
       if (errorCode && errorCode !== '0') {
         // 把 errorCode 与响应体片段一并抛出，便于排查（如 cardId 不存在 / 无权限 / 入参结构不符）。
         const detail = JSON.stringify(parsed).slice(0, 600);
-        throw new Error(`FinMall 交易失败 [errorCode=${errorCode}] ${parsed.header?.errorMsg || parsed.body?.errorMsg || ''} | ${detail}`);
+        throw new Error(`远端交易失败 [errorCode=${errorCode}] ${parsed.header?.errorMsg || parsed.body?.errorMsg || ''} | ${detail}`);
       }
       return parsed.body;
-  }, { urlPath, requestBody, transCode, timeoutMs: FINMALL_POST_TIMEOUT_MS }),
-    FINMALL_POST_TIMEOUT_MS + 2000,
-    `FinMall 请求 ${transCode}`
+  }, { urlPath, requestBody, transCode, timeoutMs: PLATFORM_POST_TIMEOUT_MS }),
+    PLATFORM_POST_TIMEOUT_MS + 2000,
+    `远端请求 ${transCode}`
   );
 }
 
@@ -1794,7 +1816,7 @@ function normalizeCard(raw) {
 }
 
 function filestoreToUrl(value) {
-  return finmallConfig.filestoreUrl(value);
+  return platformConfig.filestoreUrl(value);
 }
 
 async function syncCard(page, card, { outRoot, appId, workspaceId, summary, schemaHashes, importMeta }) {
@@ -1813,7 +1835,7 @@ async function syncCard(page, card, { outRoot, appId, workspaceId, summary, sche
   }
   const coverPath = await saveCover(page, card, cardDir);
   // 注意：schema 内部的 pageId 一律以「远端拉取」的为准，原样落盘，不做覆盖。
-  // 远端返回的 pageId 是 FinMall 编辑器维护的权威页面/模板 ID，落盘后随 schema 一并保留，
+  // 远端返回的 pageId 是远端编辑器维护的权威页面/模板 ID，落盘后随 schema 一并保留，
   // 供保存（IDC10010）/预览（IDC10015/10020/10021）链路按此主键打到线上。
   // 重复 schema 检测：若不同 code 抓到了字节完全相同的 schema，说明仍串卡，
   // 记录到 duplicates 并把整体结果标为失败，便于重抓时立即发现而非事后排查。
@@ -2008,7 +2030,7 @@ async function writeImportSidecar(cardDir, { appId, workspaceId, card, files, im
     const mod = importMeta || (await import(pathToFileURL(path.resolve(workspace, 'server', 'core', 'cardImportMeta.js')).href));
     const raw = card.raw || {};
     const meta = mod.buildImportMeta({
-      baseUrl: finmallConfig.baseUrl,
+      baseUrl: platformConfig.baseUrl,
       appId,
       workspaceId,
       cardId: card.cardId,