cardbuddy 0.22.0 → 0.23.0

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

@@ -2,14 +2,14 @@
 /**
  * slice_upload —— 切图上传（slices_convention.md 的「③ 远程同步」阶段实现）。
  *
- * 把 `src/slices/` 下被卡片引用的切图上传到 FinMall 图片库（`CC0000.do`，multipart：
+ * 把 `src/slices/` 下被卡片引用的切图上传到远端图片库（`CC0000.do`，multipart：
  * `fileName` + `file`），拿到线上地址（形如 `@filestore/dzqd-download/<ts>_<name>.png`），
  * 然后做两件事：
  *   1. 写「本地文件 ↔ 线上地址」映射：`src/slices/manifest.json`；
  *   2. 把卡片 `schema.json` / `data.json` 里的 `"/slices/<name>"` 引用改写为该线上地址
  *      （运行时 `adapter.doReplaceUrl` 再把 `@filestore/x` 解析成 `/minio/x`，预览链路无需改动）。
  *
- * 鉴权与会话复用与 api_batch_sync.mjs 完全一致：ensureFinMallSession 拉起/复用后台无界面
+ * 鉴权与会话复用与 api_batch_sync.mjs 完全一致：ensurePlatformSession 拉起/复用后台无界面
  * Chrome，token（localStorage `_sessionId`）只在页面上下文内读取并直接用于请求——
  * **绝不回传 Node 侧、不打印、不落盘**（见 shared/auth-model.md §1.5）。
  * 命中会话/权限失效（BLEC0006 等）时自动清 session 重登并重试一次。
@@ -22,16 +22,35 @@
  * 避免卡片继续指向过期的线上图。
  *
  * 用法：
- *   node skills/finmall-card-sync/scripts/slice_upload.mjs
- *   node skills/finmall-card-sync/scripts/slice_upload.mjs --only=arrowRightGray.png,icon.png
- *   node skills/finmall-card-sync/scripts/slice_upload.mjs --all --dry-run
- *   node skills/finmall-card-sync/scripts/slice_upload.mjs --force --no-rewrite
+ *   node skills/platform-card-sync/scripts/slice_upload.mjs
+ *   node skills/platform-card-sync/scripts/slice_upload.mjs --only=arrowRightGray.png,icon.png
+ *   node skills/platform-card-sync/scripts/slice_upload.mjs --all --dry-run
+ *   node skills/platform-card-sync/scripts/slice_upload.mjs --force --no-rewrite
  */
 import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
 import { createHash } from 'node:crypto';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { finmallConfig } from '../../shared/finmall-config.mjs';
+import { platformConfig } from '../../shared/platform-config.mjs';
+
+/**
+ * 对端站点 host（从配置派生，不写死域名），用于在多个标签页里认出已登录的那个。
+ * 配置缺失时返回空串 → 判定一律 false，调用方回落到「取第一个页 / 新建页」。
+ */
+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, '..');
@@ -55,13 +74,13 @@ try {
   };
 }
 
-import { ensureFinMallSession } from '../../finmall-session-navigator/scripts/session-manager.mjs';
+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 时，Node→Chrome 的 CDP 连接（127.0.0.1）必须排除在代理外。
 for (const key of ['NO_PROXY', 'no_proxy']) {
@@ -166,7 +185,7 @@ async function postUpload(page, { fileName, mime, base64, appId, workspaceId, en
         };
         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);
@@ -212,7 +231,7 @@ function parseUploadResponse(text, fileName) {
   const body = (parsed && parsed.body) || {};
   const errorCode = header.errorCode || body.errorCode;
   if (errorCode && errorCode !== '0') {
-    throw new Error(`FinMall 上传失败 [errorCode=${errorCode}] ${header.errorMsg || body.errorMsg || ''}`);
+    throw new Error(`远端上传失败 [errorCode=${errorCode}] ${header.errorMsg || body.errorMsg || ''}`);
   }
   const list = Array.isArray(body.uploadFileList)
     ? body.uploadFileList
@@ -246,7 +265,7 @@ async function uploadWithHeal(page, payload) {
 }
 
 /**
- * 上传单张图片到 FinMall 图片库（CC0000.do），返回 `@filestore/...` 站内地址。
+ * 上传单张图片到远端图片库（CC0000.do），返回 `@filestore/...` 站内地址。
  *
  * 与切图上传是同一条链路（同接口、同会话自愈、同响应解析），差异只在用途：
  * 这里不写 manifest、不改写 schema —— 新建/编辑卡片抽屉只需要一个能写进 `picUrl` 的地址。
@@ -260,15 +279,15 @@ export async function uploadCardImage(input = {}) {
   if (!fileName) throw new Error('缺少文件名，无法上传封面');
   if (!input.base64) throw new Error('缺少图片内容，无法上传封面');
   const mime = input.mime || IMAGE_MIME[path.extname(fileName).toLowerCase()] || 'image/png';
-  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 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 result = await uploadWithHeal(page, {
       fileName,
@@ -276,7 +295,7 @@ export async function uploadCardImage(input = {}) {
       base64: input.base64,
       appId,
       workspaceId,
-      endpoint: finmallConfig.uploadImgEndpoint,
+      endpoint: platformConfig.uploadImgEndpoint,
     });
     return { url: result.url, dimensions: result.dimensions || '', fileName };
   } finally {
@@ -466,7 +485,7 @@ function rewriteCardRefs(cardFiles, root, mapping) {
  * @param {boolean}  [opts.force]        true=忽略 sha256 判重，强制重新上传
  * @param {boolean}  [opts.dryRun]       true=只报告计划，不上传、不写盘
  * @param {boolean}  [opts.noRewrite]    true=只上传 + 写映射，不改写卡片引用
- * @param {string}   [opts.appId]        覆盖 sassAppId（默认取 .env.cb 的 FINMALL_APP_ID）
+ * @param {string}   [opts.appId]        覆盖 sassAppId（默认取 .env.cb 的 PLATFORM_APP_ID）
  * @param {string}   [opts.workspaceId]  覆盖 sassWorkspaceId
  * @param {string}   [opts.slicesRoot]   切图目录（默认 <repo>/src/slices）
  * @param {string}   [opts.cardsRoot]    卡片目录（默认 <repo>/src/cards）
@@ -477,8 +496,8 @@ export async function uploadSlices(opts = {}) {
   const slicesRoot = path.resolve(opts.slicesRoot || path.join(process.cwd(), 'src', 'slices'));
   const cardsRoot = path.resolve(opts.cardsRoot || path.join(process.cwd(), 'src', 'cards'));
   const manifestPath = path.join(slicesRoot, MANIFEST_FILE);
-  const appId = String(opts.appId || finmallConfig.appId);
-  const workspaceId = String(opts.workspaceId || finmallConfig.workspaceId);
+  const appId = String(opts.appId || platformConfig.appId);
+  const workspaceId = String(opts.workspaceId || platformConfig.workspaceId);
   const dryRun = !!opts.dryRun;
   const force = !!opts.force;
   const cardId = opts.cardId ? String(opts.cardId) : '';
@@ -550,7 +569,7 @@ export async function uploadSlices(opts = {}) {
   const writeReusedEntry = (slice, fromName, fromEntry) => {
     const reused = {
       url: fromEntry.url,
-      httpUrl: fromEntry.httpUrl || finmallConfig.filestoreUrl(fromEntry.url),
+      httpUrl: fromEntry.httpUrl || platformConfig.filestoreUrl(fromEntry.url),
       sha256: slice.sha256,
       size: slice.size,
       reusedFrom: fromName,
@@ -603,12 +622,12 @@ export async function uploadSlices(opts = {}) {
 
   if (pending.length) {
     log.info('待上传切图', { count: pending.length, appId, workspaceId });
-    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();
 
       for (const slice of pending) {
@@ -619,7 +638,7 @@ export async function uploadSlices(opts = {}) {
             base64: slice.base64,
             appId,
             workspaceId,
-            endpoint: finmallConfig.uploadImgEndpoint,
+            endpoint: platformConfig.uploadImgEndpoint,
           });
           const prev = manifest.files[slice.name];
           // 内容变了会拿到新地址：旧地址进 superseded（上限 5），改写阶段一并替换，
@@ -630,7 +649,7 @@ export async function uploadSlices(opts = {}) {
               : (prev && prev.superseded) || [];
           const entry = {
             url: result.url,
-            httpUrl: finmallConfig.filestoreUrl(result.url),
+            httpUrl: platformConfig.filestoreUrl(result.url),
             sha256: slice.sha256,
             size: slice.size,
             uploadedAt: new Date().toISOString(),
@@ -733,8 +752,8 @@ if (isMain) {
     ...(summary.dangling.length ? [`悬空引用（schema 引用但 src/slices 无此文件）：${summary.dangling.join('、')}`] : []),
   ];
   log.box({ title: '切图上传结果', level: summary.success ? 'ok' : 'warn', lines });
-  // 显式退出：ensureFinMallSession 内部的登录流程会另开一条 CDP 连接且按约定不关闭
+  // 显式退出：ensurePlatformSession 内部的登录流程会另开一条 CDP 连接且按约定不关闭
   // （后台 Chrome 要常驻复用），残留的 WebSocket 会让事件循环一直不空、进程挂住不退出。
-  // 与 finmall_login.mjs CLI 同款处理——detached 的 Chrome 进程不受影响，继续运行。
+  // 与 platform_login.mjs CLI 同款处理——detached 的 Chrome 进程不受影响，继续运行。
   process.exit(summary.success ? 0 : 1);
 }

package/dist/vendored/skills/{finmall-session-navigator → platform-session-navigator}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: finmall-session-navigator
-description: 使用 Playwright 独立启动 Chrome，自动登录 FinMall UAT 并打开卡片列表页，恢复超时会话并验证数据列表。不依赖 Codex 或任何浏览器插件，用户无需附加 @Chrome chip。
+name: platform-session-navigator
+description: 使用 Playwright 独立启动 Chrome，自动登录远端 UAT 并打开卡片列表页，恢复超时会话并验证数据列表。不依赖 Codex 或任何浏览器插件，用户无需附加 @Chrome chip。
 ---
 
-# FinMall 会话导航
+# 远端会话导航
 
-通过 Playwright 独立启动 Chrome 浏览器，自动登录 FinMall 并打开卡片列表页。
+通过 Playwright 独立启动 Chrome 浏览器，自动登录远端并打开卡片列表页。
 
 ## 环境配置
 
@@ -20,9 +20,9 @@ description: 使用 Playwright 独立启动 Chrome，自动登录 FinMall UAT
 
 | 变量名 | 说明 | 默认值 |
 |---------|------|--------|
-| `FINMALL_BASE_URL` | 服务域名 | `https://uat-pkg.finmall.com` |
-| `FINMALL_APP_ID` | 应用 ID | `100042` |
-| `FINMALL_WORKSPACE_ID` | 工作空间 ID | `dev` |
+| `PLATFORM_BASE_URL` | 服务域名 | `https://uat-pkg.finmall.com` |
+| `PLATFORM_APP_ID` | 应用 ID | `100042` |
+| `PLATFORM_WORKSPACE_ID` | 工作空间 ID | `dev` |
 | `CARDBUDDY_CDP_PORT` | Chrome 调试端口 | `9222` |
 
 切换环境（如生产/测试）只需修改 `.env.cb.local`，无需改动代码。
@@ -33,7 +33,7 @@ description: 使用 Playwright 独立启动 Chrome，自动登录 FinMall UAT
 
 1. 以独立进程启动系统 Chrome（或 Playwright 内置 Chromium），开启 `--remote-debugging-port=9222`。
 2. 使用 Playwright `connectOverCDP` 连接到该 Chrome 实例。
-3. 在 FinMall 同源页面上下文中通过 `page.evaluate()` 注入登录请求。
+3. 在远端同源页面上下文中通过 `page.evaluate()` 注入登录请求。
 4. 登录后刷新页面、验证列表渲染完成。
 5. 脚本退出后 Chrome 进程继续运行，用户可直接操作页面。
 
@@ -51,7 +51,7 @@ Chrome 使用独立持久化用户数据目录（`.local/browser-data/`），loc
 
 - 不依赖 Codex、Chrome 插件、`@Chrome` chip、`mcp__node_repl__js` 或任何外部浏览器控制工具。
 - 不使用终端 curl 代替浏览器内请求——curl 的 Cookie 会话不会同步回 Chrome。
-- 登录请求必须在当前 FinMall Chrome 页面的同源上下文中执行，确保浏览器 Cookie 和会话状态被更新。
+- 登录请求必须在当前远端 Chrome 页面的同源上下文中执行，确保浏览器 Cookie 和会话状态被更新。
 - 不读取 Chrome Cookie、密码库或用户配置文件。
 - localStorage 中的 `_sessionId` 只允许在页面上下文内读取，用途仅限两项：判断会话是否存在、作为 `token` 请求头发出。**禁止**把它回传到 Node 侧、打印到日志、写入文件或硬编码。
 - 不输出账号、密码哈希、会话 token 或登录接口完整响应。
@@ -64,7 +64,7 @@ Chrome 使用独立持久化用户数据目录（`.local/browser-data/`），loc
 1. 检查 `scripts/node_modules/playwright` 是否存在。
 2. 若不存在，在 `scripts/` 目录下执行安装：
    ```bash
-   cd skills/finmall-session-navigator/scripts
+   cd skills/platform-session-navigator/scripts
    npm install
    ```
 3. 若系统无 Chrome 且需要内置 Chromium，执行：
@@ -79,7 +79,7 @@ Chrome 使用独立持久化用户数据目录（`.local/browser-data/`），loc
 一条命令完成全部操作：
 
 ```bash
-node skills/finmall-session-navigator/scripts/finmall_login.mjs
+node skills/platform-session-navigator/scripts/platform_login.mjs
 ```
 
 脚本内部执行：
@@ -92,7 +92,7 @@ node skills/finmall-session-navigator/scripts/finmall_login.mjs
    - 关闭超时弹框（原生 JS 对话框通过 `page.on("dialog")` 自动 accept + 页面内含「会话超时」「登录超时」「登录已过期」的可见模态框）。
    - 在页面同源上下文中通过 `page.evaluate(fetch(...))` 发起 `IM01001.do` 登录请求；请求体含 `loginName`、`loginPassword`(MD5 小写)、`requestTime`（当前毫秒时间戳，每次生成）；**登录请求不需要 `token` 请求头**。
    - 注入脚本只显式设置 `Accept: application/json, text/plain, */*` 和 `Content-Type: application/json;charset=UTF-8`；`Origin` / `Referer` / `User-Agent` / `Sec-Fetch-*` / `sec-ch-ua*` / `Connection` 属于浏览器管理或受限请求头，由 Chrome 在同源上下文自动生成，不要在 page.evaluate 里手设。
-   - 读取响应头中的新会话 token，按 FinMall 前端格式保存为 `_sessionId`（双层编码 `{"value":"\"<uuid>\""}`），同时保存 `_userInfo`。
+   - 读取响应头中的新会话 token，按远端前端格式保存为 `_sessionId`（双层编码 `{"value":"\"<uuid>\""}`），同时保存 `_userInfo`。
    - 调用 `IM01002.do` 获取权限菜单，写入 `__menuList`、`__menuItemList`。
    - 刷新页面，等待应用重新初始化并验证列表渲染完成。
 6. 失败后间隔 1 秒重试，最多执行 3 次。
@@ -162,7 +162,7 @@ node skills/finmall-session-navigator/scripts/finmall_login.mjs
 
 ## 资源
 
-- `scripts/finmall_login.mjs`：主脚本——读取凭据、启动/连接 Chrome、注入登录请求、处理弹框、重试并验证列表。
+- `scripts/platform_login.mjs`：主脚本——读取凭据、启动/连接 Chrome、注入登录请求、处理弹框、重试并验证列表。
 - `scripts/session-manager.mjs`：会话管理辅助脚本（如需要复用同一 Chrome 实例多次评估页面状态可用）。
 - `scripts/package.json`：Playwright 依赖声明。
 - `.local/credentials.json`：登录凭据（被 Git 忽略）。

package/dist/vendored/skills/{finmall-session-navigator → platform-session-navigator}/scripts/package-lock.json

@@ -1,11 +1,11 @@
 {
-  "name": "finmall-session-navigator-scripts",
+  "name": "platform-session-navigator-scripts",
   "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "finmall-session-navigator-scripts",
+      "name": "platform-session-navigator-scripts",
       "version": "1.0.0",
       "dependencies": {
         "playwright": "^1.62.1"

package/dist/vendored/skills/{finmall-session-navigator → platform-session-navigator}/scripts/package.json

@@ -1,9 +1,9 @@
 {
-  "name": "finmall-session-navigator-scripts",
+  "name": "platform-session-navigator-scripts",
   "version": "1.0.0",
   "private": true,
   "type": "module",
-  "description": "Playwright-based FinMall UAT auto-login scripts",
+  "description": "Playwright-based 远端 UAT auto-login scripts",
   "dependencies": {
     "playwright": "^1.62.1"
   }

package/dist/vendored/skills/{finmall-session-navigator/scripts/finmall_login.mjs → platform-session-navigator/scripts/platform_login.mjs}

@@ -7,13 +7,26 @@ import { fileURLToPath } from "node:url";
 import { createHash } from "node:crypto";
 import * as readline from "node:readline/promises";
 import { stdin as rlInput, stdout as rlOutput } from "node:process";
-import { finmallConfig } from "../../shared/finmall-config.mjs";
+import { platformConfig } from "../../shared/platform-config.mjs";
+
+/** 对端站点 host（从配置派生，不写死域名）；配置缺失时为空串，判定一律 false。 */
+const PLATFORM_HOST = (() => {
+  try {
+    return new URL(platformConfig.baseUrl).host;
+  } catch {
+    return "";
+  }
+})();
+/** 目标页是否为「卡片列表页」（host + 路径双条件） */
+function isPlatformCardListPage(url) {
+  return Boolean(PLATFORM_HOST) && url.includes(PLATFORM_HOST) && url.includes("card/list");
+}
 
 // ---------------------------------------------------------------------------
 // 代理处理：本机环境设了 HTTP_PROXY，但 Chrome 远程调试端口在 127.0.0.1，
 // 若让 Node（undici）也走代理会导致 connectOverCDP 拿到 502 / ECONNREFUSED。
 // 这里把 localhost 排除在代理之外，仅影响 Node 侧 CDP 连接；Chrome 进程在
-// macOS 走系统代理、不受此 env 影响，因此浏览器内访问 finmall.com 仍走代理。
+// macOS 走系统代理、不受此 env 影响，因此浏览器内访问对端站点仍走代理。
 // ---------------------------------------------------------------------------
 for (const key of ["NO_PROXY", "no_proxy"]) {
   const cur = process.env[key];
@@ -30,13 +43,13 @@ const SKILL_DIR = path.resolve(SCRIPT_DIR, "..");
 const LOCAL_DIR = path.join(SKILL_DIR, ".local");
 const BROWSER_DATA_DIR = path.join(LOCAL_DIR, "browser-data");
 export const DEFAULT_CREDENTIALS_PATH = path.join(LOCAL_DIR, "credentials.json");
-const DEBUG_PORT = finmallConfig.cdpPort;
+const DEBUG_PORT = platformConfig.cdpPort;
 
-export const TARGET_URL = finmallConfig.targetUrl;
+export const TARGET_URL = platformConfig.targetUrl;
 
-export const LOGIN_ENDPOINT = finmallConfig.loginEndpoint;
+export const LOGIN_ENDPOINT = platformConfig.loginEndpoint;
 
-const MENU_ENDPOINT = finmallConfig.menuEndpoint;
+const MENU_ENDPOINT = platformConfig.menuEndpoint;
 
 // 系统级 Chrome 路径（按优先级排列），找不到时回退到 Playwright 内置 Chromium
 const CHROME_CANDIDATES = [
@@ -54,8 +67,8 @@ const CHROME_CANDIDATES = [
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
-// page.evaluate 没有默认超时：FinMall 页面主线程被占 / 页面内 fetch 挂起（实测该环境确有
-// responseStatus=0 的常驻请求）时，裸 evaluate 永远不返回，连带 ensureFinMallSession 与
+// page.evaluate 没有默认超时：远端页面主线程被占 / 页面内 fetch 挂起（实测该环境确有
+// responseStatus=0 的常驻请求）时，裸 evaluate 永远不返回，连带 ensurePlatformSession 与
 // 整个同步任务永久挂起——同步中间件是单飞制，一个挂死的任务会让之后每次「远端同步」都拿到
 // 409「已有同步任务正在进行」，用户侧就是「点了同步、服务端再也不响应」。
 // 这里给每次 evaluate 套硬超时：Node 侧停止等待并抛明确错误（页面里仍在跑的那个 evaluate
@@ -113,7 +126,7 @@ export async function loadCredentials(
     raw = await readFile(credentialsPath, "utf8");
   } catch (e) {
     const err = new Error(
-      `FinMall 登录凭据不存在或不可读：${credentialsPath}。请运行登录流程，或在预览界面点「远程同步」时按提示填写账号密码。`,
+      `远端登录凭据不存在或不可读：${credentialsPath}。请运行登录流程，或在预览界面点「远程同步」时按提示填写账号密码。`,
     );
     err.code = "NO_CREDENTIALS";
     throw err;
@@ -183,8 +196,8 @@ async function promptAndSaveCredentials(
   }
   const rl = readline.createInterface({ input: rlInput, output: rlOutput });
   try {
-    const loginName = (await rl.question("FinMall 登录账号：")).trim();
-    const rawPassword = (await rl.question("FinMall 登录密码：")).trim();
+    const loginName = (await rl.question("远端登录账号：")).trim();
+    const rawPassword = (await rl.question("远端登录密码：")).trim();
     return await saveCredentials(loginName, rawPassword, credentialsPath);
   } finally {
     rl.close();
@@ -268,7 +281,7 @@ export async function tryConnectBrowser(port) {
  * 使用 page.evaluate 在浏览器中执行，返回 JSON 可序列化结果。
  * 包含重试逻辑以处理 SPA 客户端导航导致的执行上下文销毁。
  *
- * 重要：FinMall 不使用 Cookie 鉴权（document.cookie 恒为空），会话凭据存放在
+ * 重要：远端不使用 Cookie 鉴权（document.cookie 恒为空），会话凭据存放在
  * localStorage 的 `_sessionId` 中，由前端以 `token` 请求头透传。而卡片列表接口
  * IDC10001.do 本身不校验鉴权，因此「列表渲染出来了」并不代表会话有效——只看 DOM
  * 会把过期会话误判成已登录，导致后续需要鉴权的接口（如 IDC10012.do）返回
@@ -457,7 +470,7 @@ export async function waitForAuthenticatedPage(page, timeoutMs = 20000) {
 
 /**
  * 在页面上下文中执行登录请求（IM01001 + IM01002）。
- * 请求在 FinMall 同源页面内发起，浏览器自动携带 Cookie 和管理请求头。
+ * 请求在远端同源页面内发起，浏览器自动携带 Cookie 和管理请求头。
  */
 export async function performLogin(page, credentials) {
   const payload = buildPayload(
@@ -468,7 +481,7 @@ export async function performLogin(page, credentials) {
     page,
     async (input) => {
       // 页面内 fetch 也必须自带超时：IM01001 / IM01002 挂起时（该环境实测有常驻不返回的请求），
-      // 没有 AbortController 就会把 performLogin → runFinmallLogin → ensureFinMallSession
+      // 没有 AbortController 就会把 performLogin → runPlatformLogin → ensurePlatformSession
       // 整条链永久挂住。这里内层 abort + 外层 evaluateWithRetry 的硬超时双重设防。
       const ctl = new AbortController();
       const timer = setTimeout(() => ctl.abort(), input.timeoutMs);
@@ -526,15 +539,15 @@ export async function performLogin(page, credentials) {
           usrDeptName: body.usrDeptName,
           cstNo: body.cstNo,
         };
-        const setFinmallStorage = (key, value) => {
+        const setPlatformStorage = (key, value) => {
           if (globalThis.app?.api?.setLocalStorage) {
             globalThis.app.api.setLocalStorage(key, value);
             return;
           }
           localStorage.setItem(key, JSON.stringify({ value }));
         };
-        setFinmallStorage("_sessionId", JSON.stringify(sessionId));
-        setFinmallStorage("_userInfo", JSON.stringify(userInfo));
+        setPlatformStorage("_sessionId", JSON.stringify(sessionId));
+        setPlatformStorage("_userInfo", JSON.stringify(userInfo));
 
         // 获取权限菜单
         const menuPayload = {
@@ -616,9 +629,9 @@ export async function performLogin(page, credentials) {
           ],
         };
         menuTree.unshift(welcome);
-        setFinmallStorage("__menuList", JSON.stringify(menuTree));
-        setFinmallStorage("__menuItemList", JSON.stringify(menuItemList));
-        setFinmallStorage("_chatLogin", true);
+        setPlatformStorage("__menuList", JSON.stringify(menuTree));
+        setPlatformStorage("__menuItemList", JSON.stringify(menuItemList));
+        setPlatformStorage("_chatLogin", true);
         if (menuResponseBody?.header?.errorCode !== "0" || menuList.length === 0) {
           return {
             httpOk: response.ok,
@@ -652,7 +665,7 @@ export async function performLogin(page, credentials) {
 // ---------------------------------------------------------------------------
 
 /**
- * 自动登录 FinMall UAT 并打开卡片列表页。
+ * 自动登录远端 UAT 并打开卡片列表页。
  *
  * 流程：
  * 1. 尝试连接已运行的 Chrome 调试实例（端口 9222）。
@@ -671,7 +684,7 @@ export async function performLogin(page, credentials) {
  * @param {boolean} [options.closeBrowser=false] 完成后是否关闭浏览器
  * @returns {Promise<object>} 登录结果
  */
-export async function runFinmallLogin(options = {}) {
+export async function runPlatformLogin(options = {}) {
   const {
     credentialsPath = DEFAULT_CREDENTIALS_PATH,
     maxAttempts = 3,
@@ -689,7 +702,7 @@ export async function runFinmallLogin(options = {}) {
   } catch (e) {
     // 凭据缺失且处于交互终端：引导用户输入账号密码并落盘，再继续登录。
     if (e && e.code === "NO_CREDENTIALS" && process.stdout.isTTY) {
-      console.error("本地 FinMall 凭据缺失，进入交互式填写…");
+      console.error("本地远端凭据缺失，进入交互式填写…");
       credentials = await promptAndSaveCredentials(credentialsPath);
     } else {
       throw e;
@@ -723,7 +736,7 @@ export async function runFinmallLogin(options = {}) {
       .pages()
       .find((p) => {
         try {
-          return p.url().includes("finmall.com");
+          return PLATFORM_HOST ? p.url().includes(PLATFORM_HOST) : false;
         } catch {
           return false;
         }
@@ -739,10 +752,7 @@ export async function runFinmallLogin(options = {}) {
     // 导航到目标页面
     try {
       const currentUrl = page.url();
-      if (
-        !currentUrl.includes("finmall.com") ||
-        !currentUrl.includes("card/list")
-      ) {
+      if (!isPlatformCardListPage(currentUrl)) {
         await page.goto(TARGET_URL, {
           waitUntil: "domcontentloaded",
           timeout: 30000,
@@ -832,7 +842,7 @@ export async function runFinmallLogin(options = {}) {
             // 不消耗固定的重试次数（避免一次性输错就把次数吃光）。
             credentialPrompts += 1;
             console.error(
-              `✖ 登录失败：账号或密码错误。请重新输入 FinMall 凭据（${credentialPrompts}/${maxCredentialPrompts}）`,
+              `✖ 登录失败：账号或密码错误。请重新输入远端凭据（${credentialPrompts}/${maxCredentialPrompts}）`,
             );
             try {
               credentials = await promptAndSaveCredentials(credentialsPath);
@@ -915,7 +925,7 @@ async function selfTest() {
     throw new Error("请求体生成测试失败");
   }
   console.log(
-    JSON.stringify({ success: true, message: "FinMall 登录脚本自检通过" }),
+    JSON.stringify({ success: true, message: "远端登录脚本自检通过" }),
   );
 }
 
@@ -935,7 +945,7 @@ if (globalThis.process?.argv?.[1]) {
           process.exit(1);
         });
     } else {
-      runFinmallLogin({ closeBrowser })
+      runPlatformLogin({ closeBrowser })
         .then((result) => {
           console.log(JSON.stringify(result, null, 2));
           // 显式退出，避免 Playwright WebSocket 连接阻止进程退出。

package/dist/vendored/skills/{finmall-session-navigator → platform-session-navigator}/scripts/session-manager.mjs

@@ -1,14 +1,14 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { finmallConfig } from "../../shared/finmall-config.mjs";
+import { platformConfig } from "../../shared/platform-config.mjs";
 import {
-  runFinmallLogin,
+  runPlatformLogin,
   tryConnectBrowser,
   waitForDebugPort,
   findChromePath,
   launchChromeDetached,
   TARGET_URL,
-} from "./finmall_login.mjs";
+} from "./platform_login.mjs";
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const LOCAL_DIR = path.resolve(SCRIPT_DIR, "..", ".local");
@@ -17,10 +17,10 @@ const LOCAL_DIR = path.resolve(SCRIPT_DIR, "..", ".local");
 const SYNC_BROWSER_DATA_DIR = path.join(LOCAL_DIR, "sync-browser-data");
 // 后台会话专用调试端口，与手动导航器端口隔离（手动可见、自动无界面互不干扰）。
 // 取值走统一配置链：process.env CARDBUDDY_SYNC_CDP_PORT > .env.cb(.local) > 内置默认。
-const SYNC_PORT = finmallConfig.syncCdpPort;
+const SYNC_PORT = platformConfig.syncCdpPort;
 
 // 排除 localhost 代理：本机若设了 HTTP_PROXY，Node 侧 connectOverCDP 走代理会
-// 拿到 502 / ECONNREFUSED。仅影响 Node→Chrome 的 CDP 连接；浏览器内访问 finmall
+// 拿到 502 / ECONNREFUSED。仅影响 Node→Chrome 的 CDP 连接；浏览器内访问 platform
 // 仍走系统代理（Chrome 进程不受此 env 影响）。
 for (const key of ["NO_PROXY", "no_proxy"]) {
   const cur = process.env[key];
@@ -28,26 +28,26 @@ for (const key of ["NO_PROXY", "no_proxy"]) {
   process.env[key] = cur && cur.length ? `${cur},${extra}` : extra;
 }
 
-// 进程内会话缓存：runFinmallLogin 热路径固定消耗导航 + networkidle + sleep(2000)（实测 ~2.6s），
-// 而同步/保存/历史查询等高频只读操作都会经过 ensureFinMallSession。TTL 内且 CDP 仍连通时
-// 直接复用，跳过重复登录校验；服务端会话真过期时由 finmallPostWithHeal 的 SESSION_INVALID
+// 进程内会话缓存：runPlatformLogin 热路径固定消耗导航 + networkidle + sleep(2000)（实测 ~2.6s），
+// 而同步/保存/历史查询等高频只读操作都会经过 ensurePlatformSession。TTL 内且 CDP 仍连通时
+// 直接复用，跳过重复登录校验；服务端会话真过期时由 platformPostWithHeal 的 SESSION_INVALID
 // 自愈（清 session 重登重试）兜底，故此处缓存不削弱正确性。
-const SESSION_CACHE_TTL_MS = Number(process.env.FINMALL_SESSION_CACHE_TTL_MS || 60000);
+const SESSION_CACHE_TTL_MS = Number(process.env.PLATFORM_SESSION_CACHE_TTL_MS || 60000);
 let _sessionCache = null; // { browser, login, at }
 
 /**
- * 确保存在一个已登录的 FinMall 后台浏览器会话（无界面 headless，端口 SYNC_PORT）。
+ * 确保存在一个已登录的远端后台浏览器会话（无界面 headless，端口 SYNC_PORT）。
  *
  * 行为：
  * - 若 SYNC_PORT 未启动（含上次 dev server 退出后该 detached Chrome 也已崩溃的情况）：
  *   以 headless 模式启动一个独立（detached）Chrome，并用保存的凭据自动登录。
  * - 若 SYNC_PORT 已启动（含跨 dev server 重启复用的上一实例）：直接连上并复用，
- *   仅在 _sessionId 缺失时由 runFinmallLogin 自动登录。
+ *   仅在 _sessionId 缺失时由 runPlatformLogin 自动登录。
  * - 进程内热路径：距上次成功 ensure 不足 TTL 且 CDP 仍连通（isConnected）时直接返回缓存，
  *   省去重复导航与固定等待；调用方 finally 的 browser.disconnect() 会令 isConnected()
  *   为 false，缓存随之作废走完整流程，与原先行为一致。
  *
- * 注意：runFinmallLogin 只校验 _sessionId 是否存在，无法发现「服务端会话已过期」
+ * 注意：runPlatformLogin 只校验 _sessionId 是否存在，无法发现「服务端会话已过期」
  * （IDC10001 列表接口不鉴权，会骗过它）。最终的服务端过期由 syncCards 以需鉴权的
  * IDC10012 返回 BLEC0006 为准，并在那里自动重登。因此本函数只保证「有 Chrome +
  * 页面 + 本地凭据存在」，不保证服务端一定有效。
@@ -60,8 +60,8 @@ let _sessionCache = null; // { browser, login, at }
  * @param {boolean} [options.headless=true]
  * @returns {Promise<{ browser: import('playwright').Browser, login: object }>}
  */
-export async function ensureFinMallSession({ debugPort = SYNC_PORT, headless = true } = {}) {
-  // 热路径：进程内缓存未过期且 CDP 仍连通 → 直接复用（跳过 runFinmallLogin 的
+export async function ensurePlatformSession({ debugPort = SYNC_PORT, headless = true } = {}) {
+  // 热路径：进程内缓存未过期且 CDP 仍连通 → 直接复用（跳过 runPlatformLogin 的
   // 导航 + networkidle + sleep(2000)，实测可从 ~2.6s 降到毫秒级）。
   if (_sessionCache && Date.now() - _sessionCache.at < SESSION_CACHE_TTL_MS) {
     try {
@@ -98,9 +98,9 @@ export async function ensureFinMallSession({ debugPort = SYNC_PORT, headless = t
     }
   }
 
-  // runFinmallLogin 内部会连上该端口、导航到卡片列表页、并在需要时自动登录
+  // runPlatformLogin 内部会连上该端口、导航到卡片列表页、并在需要时自动登录
   // （使用 .local/credentials.json 中的保存凭据，全程在页面上下文内完成）。
-  const login = await runFinmallLogin({
+  const login = await runPlatformLogin({
     debugPort,
     headless,
     browserDataDir: SYNC_BROWSER_DATA_DIR,
@@ -110,7 +110,7 @@ export async function ensureFinMallSession({ debugPort = SYNC_PORT, headless = t
   if (!login.success) {
     const reason = login.reason || "未知原因";
     const captchaNote = login.captchaSignal ? "（页面要求验证码，需人工处理）" : "";
-    throw new Error(`后台自动登录 FinMall 失败：${reason}${captchaNote}`);
+    throw new Error(`后台自动登录远端失败：${reason}${captchaNote}`);
   }
 
   _sessionCache = { browser, login, at: Date.now() };