weaver-e9-assistant-cli 1.0.0

package/dist/cube.js

@@ -0,0 +1,1633 @@
+/**
+ * E9 建模中心（Cube）自定义列表/台账模块。
+ *
+ * 原有能力（0.4.0-7）：getCubeInit / getCubeCondition / listCube / exportCubeExcel
+ * 本次拓展（建模优化）：getSearchColumnInfo / listCubeExcel / getCubeCellColor /
+ *   getCubeCountData / getCubeGroupData / getExpCardConfig / getModeBrowserOptions
+ *   （来源：台账基础操作.har + 新建.har 逆向）
+ *
+ * 实跑确认的接口（测试环境，customid=1001 董事会议题-未开）：
+ *   GET  /api/cube/search/init                列表初始化
+ *   GET  /api/cube/search/condition           查询条件定义
+ *   GET  /api/cube/search/getSearchColumnInfo 字段下拉选项全表（★新）
+ *   POST /api/cube/search/getList             列表入口 → dataKey（响应 datas 字段）
+ *   POST /api/cube/search/getCountData        聚合统计（★新）
+ *   POST /api/cube/search/getGroupData        分组统计（★新）
+ *   GET  /api/cube/excelsearch/columns        Excel 视图列定义（★新）
+ *   POST /api/cube/excelsearch/getDataAndTime Excel 视图数据+时间（★新）
+ *   POST /api/cube/excelsearch/columnWidth   列宽（UI 状态，CLI 不接）
+ *   POST /api/cube/excelsearch/getCellColor   单元格颜色（★新）
+ *   POST /api/cube/mode/mode/doExpCardConfig  卡片导出配置（★新）
+ *   POST /api/cube/search/doExcelExpost       发起 Excel 导出 → key
+ *   GET  /api/cube/search/getExcelExpProgress 轮询导出进度
+ *   GET  /weaver/weaver.formmode.data.FileDownload 下载文件流
+ *   GET  /api/public/browser/data/<dt>?isFromMode=1&modeId=&fieldid=  建模浏览框选项（★新，新建记录选人/部门用）
+ *
+ * ID 映射（init 返回）：customid ↔ modeId ↔ formId ↔ appid。
+ * 注意：getList 的 menuIds/menuPathIds 在 displayType=excel 模式下需要（HAR 用 3,-17，随台账菜单而定），
+ *   普通 list 模式可不传；Excel 视图函数的 menuIds 由调用方通过 opts.menuIds 传入（可从前台菜单接口取）。
+ */
+import { createApiFromProfile, e9Request } from './client.js';
+import { endpointFor, profileNameFromBaseUrl } from './config.js';
+import { pickByPaths, stripHtml, extractColumns, extractRows, extractTotal } from './parse.js';
+import { sleep } from './util.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { inflateRawSync } from 'node:zlib';
+import { assertExcelLike, nextAvailablePath } from './fileutil.js';
+const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
+/**
+ * 列表初始化。GET /api/cube/search/init?customid=<id>&guid=search。
+ * 返回 {customId, modeId, formId, pageSize, name, appid, raw}。
+ */
+export async function getCubeInit(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/cube/search/init', { customid: String(opts.customid), guid: 'search' });
+    const j = r.json || {};
+    return {
+        customId: stringify(j.customId) ?? String(opts.customid),
+        modeId: stringify(j.modeId),
+        formId: stringify(j.formId),
+        pageSize: typeof j.pageSize === 'number' ? j.pageSize : Number(j.pageSize ?? 10) || 10,
+        name: stringify(pickByPaths(j, ['top.name', 'name', 'windowTitle'])),
+        appid: stringify(j.appid),
+        raw: j,
+    };
+}
+/**
+ * 查询条件定义。GET /api/cube/search/condition?customid=<id>&guid=search。
+ * 返回 items:[{label, domkey, type, isQuickSearch, options:[{key,showname}]}]。
+ */
+export async function getCubeCondition(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/cube/search/condition', { customid: String(opts.customid), guid: 'search' });
+    const j = r.json || {};
+    const groups = pickByPaths(j, ['conditionInfo', 'data.conditionInfo']) ?? [];
+    const items = (Array.isArray(groups) ? groups : [])
+        .flatMap((g) => Array.isArray(g?.items) ? g.items : [])
+        .filter(Boolean)
+        .map((it) => ({
+        label: stringify(it.label),
+        domkey: Array.isArray(it.domkey) ? it.domkey.map(stringify).filter(Boolean) : (stringify(it.domkey) ? [stringify(it.domkey)] : []),
+        type: stringify(it.conditionType) ?? stringify(it.type),
+        isQuickSearch: !!pickByPaths(it, ['isQuickSearch', 'otherParams.quickSearch']),
+        options: (Array.isArray(it.options) ? it.options : [])
+            .map((o) => ({ key: stringify(o.key), showname: stringify(o.showname) }))
+            .filter((o) => o.showname || o.key),
+    }))
+        .filter((it) => it.label);
+    return { items, raw: j };
+}
+/**
+ * ★新 条件字符串 → conditionValues 映射（P2-3，0.4.8）。
+ *
+ * 输入 `--condition` 原始串（`k=v;...` 分号分隔），自动识别：
+ *   - 键以 `con_`/`dom_`/`field`/`col` 开头 → 视为合法 domkey，原样透传（向后兼容）。
+ *   - 其它 → 视为中文 label，用 getCubeCondition 的 label→domkey 映射自动转换；
+ *     未匹配时返回 unresolved（含候选 label 列表），由调用方报错提示，不静默放空。
+ * 返回 { conditionValues, unresolved:[{label, candidates:[...]}] }。
+ */
+export async function resolveCubeCondition(cfg, opts = {}) {
+    const customid = String(opts.customid);
+    const rawStr = opts.condition ?? '';
+    const conditionValues = {};
+    const pairs = [];
+    if (rawStr)
+        for (const kv of String(rawStr).split(';')) {
+            const i = kv.indexOf('=');
+            if (i > 0)
+                pairs.push([kv.slice(0, i).trim(), kv.slice(i + 1).trim()]);
+        }
+    if (pairs.length === 0)
+        return { conditionValues, unresolved: [] };
+    // 判断是否含中文 label 键
+    const needsLabelMap = pairs.some(([k]) => !/^(con|dom|field|col)[-_]?/i.test(k));
+    let labelToDom = {};
+    let mappingFailed = false;
+    if (needsLabelMap) {
+        try {
+            const cond = await getCubeCondition(cfg, { customid });
+            for (const it of cond.items)
+                for (const dk of (it.domkey ?? []))
+                    if (it.label && !(it.label in labelToDom))
+                        labelToDom[it.label] = dk;
+        }
+        catch { mappingFailed = true; }
+    }
+    const unresolved = [];
+    for (const [k, v] of pairs) {
+        if (/^(con|dom|field|col)[-_]?/i.test(k)) {
+            conditionValues[k] = v;
+            continue;
+        }
+        const domkey = labelToDom[k];
+        if (domkey) {
+            conditionValues[domkey] = v;
+        }
+        else if (mappingFailed) {
+            // 映射接口本身失败（网络抖动/无权限）：按原样透传，不阻断（用户可能直接给了 domkey）
+            conditionValues[k] = v;
+        }
+        else {
+            // 映射成功但该 label 无对应 domkey：收集候选 label（包含关系），由调用方报错提示
+            const candidates = Object.keys(labelToDom).filter((l) => l.includes(k) || k.includes(l)).slice(0, 8);
+            unresolved.push({ label: k, candidates });
+        }
+    }
+    return { conditionValues, unresolved };
+}
+/**
+ * ★新 字段下拉选项全表。GET /api/cube/search/getSearchColumnInfo?customid=<id>。
+ * 返回 optionsMap：{ "<字段id>": [{key, showname}] }。
+ * 比 getCubeCondition 更全——condition 只给列表上方筛选项，本接口给台账所有字段（含状态/类型等）的下拉可选值。
+ * 实跑 1001：7974=状态 → 未开0/待开1/已开2/已结3…
+ */
+export async function getSearchColumnInfo(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/cube/search/getSearchColumnInfo', { customid: String(opts.customid) });
+    const j = r.json || {};
+    const om = pickByPaths(j, ['optionsMap', 'data.optionsMap']) ?? {};
+    const optionsMap = {};
+    for (const [fid, list] of Object.entries(om)) {
+        if (!Array.isArray(list))
+            continue;
+        const opts2 = list
+            .map((o) => ({ key: stringify(o.key), showname: stringify(o.showname) }))
+            .filter((o) => o.showname != null || o.key != null);
+        if (opts2.length)
+            optionsMap[fid] = opts2;
+    }
+    return { limitValue: pickByPaths(j, ['limitValue', 'data.limitValue']), optionsMap, raw: j };
+}
+/** 从 getList 响应提取 dataKey（`datas` 字段为 32 位 hex 字符串）。 */
+function extractCubeDataKey(resp) {
+    const direct = pickByPaths(resp, ['datas', 'data.datas', 'dataKey', 'sessionkey', 'sessionKey']);
+    if (typeof direct === 'string' && /^[0-9a-fA-F]{16,}$/.test(direct.trim()))
+        return direct.trim();
+    const scanned = scanHex(resp);
+    return scanned;
+}
+function scanHex(obj) {
+    if (obj == null)
+        return null;
+    if (typeof obj === 'string') {
+        const t = obj.trim();
+        if (/^[0-9a-fA-F]{16,}$/.test(t))
+            return t;
+        return null;
+    }
+    if (Array.isArray(obj)) {
+        for (const it of obj) {
+            const r = scanHex(it);
+            if (r)
+                return r;
+        }
+        return null;
+    }
+    if (typeof obj === 'object') {
+        for (const v of Object.values(obj)) {
+            const r = scanHex(v);
+            if (r)
+                return r;
+        }
+    }
+    return null;
+}
+/**
+ * 建模列表（普通视图）。链路：init → getList(取 dataKey) → table/datas(列+行) → table/counts(总数)。
+ * 行规范化：按 columns 的 title 输出可读值（优先 `<field>span` 去 HTML，其次原值）。
+ */
+export async function listCube(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const init = await getCubeInit(cfg, { customid });
+    const modeId = opts.modeId ?? init.modeId ?? '';
+    const formId = opts.formId ?? init.formId ?? '';
+    const pageSize = opts.pageSize ?? init.pageSize ?? 10;
+    const page = opts.page ?? 1;
+    const listBody = {
+        customid,
+        guid: 'search',
+        modeId,
+        formId,
+        current: String(page),
+        pageSize: String(pageSize),
+        isotype: '0',
+        displayType: 'list',
+        type: 'list',
+    };
+    if (opts.conditionValues && typeof opts.conditionValues === 'object') {
+        for (const [k, v] of Object.entries(opts.conditionValues))
+            listBody[k] = String(v);
+    }
+    if (opts.keyword)
+        listBody.quickSearchValue = opts.keyword;
+    const r1 = await api.post('/api/cube/search/getList', listBody);
+    const dataKey = extractCubeDataKey(r1.json);
+    if (!dataKey)
+        throw new Error(`cube list 未拿到 dataKey，getList 响应: ${(r1.text ?? '').slice(0, 200)}`);
+    const r2 = await api.post('/api/ec/dev/table/datas', {
+        dataKey,
+        current: String(page),
+        pageSize: String(pageSize),
+        sortParams: '[]',
+    });
+    const columns = extractColumns(r2.json);
+    let rows = extractRows(r2.json);
+    if (opts.keyword && rows.length) {
+        const kw = String(opts.keyword).toLowerCase();
+        rows = rows.filter((row) => JSON.stringify(row).toLowerCase().includes(kw));
+    }
+    const items = rows.map((row) => normalizeCubeRow(row, columns)).filter((it) => it.id || it.fields.length);
+    let total = null;
+    let countsResp = null;
+    try {
+        const r3 = await api.post('/api/ec/dev/table/counts', { dataKey });
+        countsResp = r3.json;
+        total = extractTotal(r3.json);
+    }
+    catch {
+        // counts 失败不阻断
+    }
+    return {
+        customid,
+        name: init.name,
+        modeId,
+        formId,
+        dataKey,
+        page,
+        pageSize,
+        total,
+        count: items.length,
+        columns,
+        items,
+        raw: { init: init.raw, getList: r1.json, datas: r2.json, counts: countsResp },
+    };
+}
+/**
+ * ★新 Excel 视图取数。链路：getList(displayType=excel 取 dataKey) → excelsearch/columns(列定义含 editable) →
+ *   excelsearch/getDataAndTime(数据+时间)。
+ * 比 listCube 多：列的 editable(可编辑标记)/htmltype/dbtype，用于判断哪些字段可在台账里直接编辑。
+ * menuIds：Excel 模式需要（HAR 用 3,-17，随台账菜单而定），由调用方传入。
+ */
+export async function listCubeExcel(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const init = await getCubeInit(cfg, { customid });
+    const modeId = opts.modeId ?? init.modeId ?? '';
+    const menuIds = opts.menuIds ?? '';
+    const menuPathIds = opts.menuPathIds ?? menuIds;
+    const page = opts.page ?? 1;
+    const listBody = {
+        customid,
+        menuIds,
+        menuPathIds,
+        guid: 'search',
+        displayType: 'excel',
+        groupValue: 'all',
+        isTempSearch: '',
+        windowWidth: '1912',
+        isTreeType: '',
+    };
+    const r1 = await api.post('/api/cube/search/getList', listBody);
+    const dataKey = extractCubeDataKey(r1.json);
+    if (!dataKey)
+        throw new Error(`cube excel list 未拿到 dataKey，getList 响应: ${(r1.text ?? '').slice(0, 200)}`);
+    // Excel 列定义（含 editable/htmltype/dbtype/column/text）
+    const rCols = await api.get('/api/cube/excelsearch/columns', {
+        customid, menuIds, menuPathIds, guid: 'search', displayType: 'excel',
+    });
+    const jCols = rCols.json || {};
+    const resultList = Array.isArray(jCols.resultList) ? jCols.resultList : [];
+    const columns = resultList.map((c) => ({
+        dataIndex: stringify(c.column) ?? stringify(c.id),
+        title: stringify(c.text),
+        htmltype: stringify(c.htmltype),
+        dbtype: stringify(c.dbtype),
+        editable: stringify(c.editable) === '1',
+        width: c.width,
+    }));
+    // Excel 数据行
+    const rData = await api.post('/api/cube/excelsearch/getDataAndTime', {
+        dataKey,
+        current: String(page),
+        sortParams: '',
+        customid, menuIds, menuPathIds, guid: 'search', displayType: 'excel',
+    });
+    const jData = rData.json?.data ?? rData.json ?? {};
+    const dataColumns = Array.isArray(jData.columns) ? jData.columns : [];
+    const rows = Array.isArray(jData.datas) ? jData.datas : [];
+    const items = rows.map((row) => normalizeCubeRow(row, dataColumns)).filter((it) => it.id || it.fields.length);
+    let total = null;
+    try {
+        const r3 = await api.post('/api/ec/dev/table/counts', { dataKey });
+        total = extractTotal(r3.json);
+    }
+    catch { /* 失败不阻断 */ }
+    return {
+        customid,
+        name: init.name,
+        modeId,
+        dataKey,
+        page,
+        total,
+        count: items.length,
+        columns, // Excel 列（含 editable 可编辑标记）
+        items,
+        time: stringify(pickByPaths(rData.json, ['time', 'data.time'])),
+        raw: { getList: r1.json, columns: jCols, data: jData },
+    };
+}
+/**
+ * ★新 单元格颜色。POST /api/cube/excelsearch/getCellColor。
+ * 取指定记录的单元格颜色（台账按状态标记行/单元格颜色，如未开=红、已开=绿）。
+ * randomIds: [{randomFieldId:<记录id>, randomFieldSubKeyd_id:'1'}]
+ */
+export async function getCubeCellColor(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const menuIds = opts.menuIds ?? '';
+    const menuPathIds = opts.menuPathIds ?? menuIds;
+    const recordIds = (opts.recordIds ?? []).map((id) => ({ randomFieldId: String(id), randomFieldSubKeyd_id: '1' }));
+    const r = await api.post('/api/cube/excelsearch/getCellColor', {
+        customid, menuIds, menuPathIds, guid: 'search', displayType: 'excel',
+        randomIds: JSON.stringify(recordIds),
+    });
+    const j = r.json || {};
+    return { colors: j.color ?? j.data?.color ?? [], time: stringify(j.time), raw: j };
+}
+/**
+ * ★新 聚合统计。POST /api/cube/search/getCountData。
+ * 返回 countData（按配置的聚合维度统计，如按状态/类型计数）。
+ */
+export async function getCubeCountData(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const menuIds = opts.menuIds ?? '';
+    const menuPathIds = opts.menuPathIds ?? menuIds;
+    const r = await api.post('/api/cube/search/getCountData', {
+        customid, menuIds, menuPathIds, guid: 'search', displayType: 'excel',
+        groupValue: opts.groupValue ?? 'all',
+        isTempSearch: '', windowWidth: '1912', isTreeType: '',
+        ...(opts.isfromTab != null ? { isfromTab: String(opts.isfromTab) } : {}),
+        ...(opts.isfromRight != null ? { isfromRight: String(opts.isfromRight) } : {}),
+    });
+    const j = r.json || {};
+    return { countData: j.countData ?? j.data?.countData ?? [], raw: j };
+}
+/**
+ * ★新 分组统计。POST /api/cube/search/getGroupData。
+ * 返回分组数据（按指定字段分组计数，用于台账分组视图）。
+ */
+export async function getCubeGroupData(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const menuIds = opts.menuIds ?? '';
+    const menuPathIds = opts.menuPathIds ?? menuIds;
+    const r = await api.post('/api/cube/search/getGroupData', {
+        customid, menuIds, menuPathIds, guid: 'search', displayType: 'excel',
+        groupValue: opts.groupValue ?? 'all',
+        isTempSearch: '', windowWidth: '1912', isTreeType: '',
+    });
+    const j = r.json || {};
+    return { groupData: j.data ?? j.datas ?? j, raw: j };
+}
+/**
+ * ★新 卡片导出配置。POST /api/cube/mode/mode/doExpCardConfig（action=getBacthExpList）。
+ * 返回可导出的格式（EXCEL列表文件等）、导出卡片名、是否可导出。
+ * 用于台账「导出单条卡片/批量卡片」前的配置探查。
+ */
+export async function getExpCardConfig(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const modeid = String(opts.modeId ?? opts.modeid ?? '');
+    const r = await api.post('/api/cube/mode/mode/doExpCardConfig', {
+        action: 'getBacthExpList',
+        customid,
+        modeid,
+    });
+    const j = r.json || {};
+    return {
+        isConfig: j.isConfig,
+        canExp: pickByPaths(j, ['canExpObj.canExp', 'canExp']),
+        batchExpList: j.BacthExplist ?? j.batchExplist ?? [],
+        expCardName: pickByPaths(j, ['expcardname.showname', 'expcardname']),
+        fields: j.feilds ?? j.fields ?? [],
+        raw: j,
+    };
+}
+/**
+ * cube 树浏览框（detailtype=256）取数：递归展开树，收集所有 canClick 节点。
+ * 流程域(wfform getBrowserOptions) 与 建模域(getModeBrowserOptions) 共用本函数，
+ *   仅 base 里带的域参数不同（流程 fromModule=workflow/wfid/billid/requestid；建模 isFromMode=1/modeId）。
+ *
+ * 接口 GET /api/public/browser/data/256：
+ *   根：treeid+cube_treeid+treetype=256+checkStrictly=false + 域参数 + pageSize/current/min/max
+ *       → datas:[{id,name,isParent,type,canClick}]，根节点 pid="0_0"
+ *   子：追加 type=2&id=<父节点id>&level=<层>&alllevel=1 → 同结构；靠 isParent 判断是否继续展开。
+ * treeid = cube_treeid = 字段 fielddbtype；treetype = 256。
+ * 返回 [{id, name, path}]（path 含祖先名，便于重名消歧）。
+ */
+export async function fetchCubeTreeBrowserOptions(api, base, opts = {}) {
+    const maxNodes = Number(opts.maxNodes ?? 300);
+    const maxDepth = Number(opts.maxDepth ?? 8);
+    const pageSize = String(opts.pageSize ?? 20);
+    const endpoint = '/api/public/browser/data/256';
+    const out = [];
+    const r0 = await api.get(endpoint, {
+        ...base, pageSize, current: '1', min: '1', max: pageSize,
+        alllevel: '1', virtualtype: '1', status: '8', cmd: opts.cmd ?? 'newly',
+        __random__: String(Date.now()),
+    });
+    const roots = Array.isArray(r0.json?.datas) ? r0.json.datas : [];
+    async function walk(nodes, parentPath, level) {
+        for (const n of nodes) {
+            if (out.length >= maxNodes)
+                return;
+            const nm = stripHtml(String(n.name ?? n.title ?? n.id ?? ''));
+            const path = parentPath ? `${parentPath} / ${nm}` : nm;
+            if ((n.canClick === true || String(n.canClick) === 'true') && n.id != null) {
+                out.push({ id: String(n.id), name: nm || String(n.id), path });
+            }
+            if ((n.isParent === true || String(n.isParent) === 'true') && level < maxDepth) {
+                try {
+                    const rc = await api.get(endpoint, {
+                        ...base, alllevel: '1', type: '2', id: String(n.id),
+                        isVirtual: '', level: String(level), __random__: String(Date.now()),
+                    });
+                    const kids = Array.isArray(rc.json?.datas) ? rc.json.datas : [];
+                    if (kids.length)
+                        await walk(kids, path, level + 1);
+                }
+                catch { /* 单节点展开失败不阻断 */ }
+            }
+        }
+    }
+    await walk(roots, '', 0);
+    return out;
+}
+/**
+ * ★新 建模浏览框选项。GET /api/public/browser/data/<detailtype>?isFromMode=1&modeId=&fieldid=...
+ * 新建台账记录时，选人员/部门/流程等浏览框字段的候选项。
+ * 与流程域 wfform.js getBrowserOptions 区别：建模用 isFromMode=1&modeId=&fieldid=（非 wfid/billid/fromModule=workflow）。
+ * detailtype：1=人员 17=多选人员 167=部门（树形，type=3）… 来自台账字段定义的 detailtype。
+ * detailtype=256（cube 树浏览框）：走 fetchCubeTreeBrowserOptions 递归取树，treeid=fielddbtype。
+ */
+export async function getModeBrowserOptions(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const detailtype = String(opts.detailtype);
+    // ★ cube 树浏览框（256）：走递归取树，不走普通分页；treeid = fielddbtype
+    if (detailtype === '256') {
+        const treeid = String(opts.fielddbtype ?? '');
+        if (!treeid)
+            throw new Error('detailtype=256（cube 树浏览框）需 fielddbtype 作 treeid：由 card-fields 提供，或 --field-db-type 指定');
+        const base = {
+            isFromMode: '1', modeId: String(opts.modeId ?? ''), fieldid: String(opts.fieldId ?? ''),
+            isbill: '1', viewtype: '0', secretLevel: '', companyId: '1', checkStrictly: 'false',
+            treeid, cube_treeid: treeid, treetype: '256',
+        };
+        const items = await fetchCubeTreeBrowserOptions(api, base, { pageSize: opts.pageSize, maxNodes: opts.maxNodes });
+        return { detailtype, modeId: opts.modeId, fieldId: opts.fieldId, items, total: items.length, raw: null };
+    }
+    const pageSize = String(opts.pageSize ?? 10);
+    const q = {
+        pageSize,
+        current: '1', min: '1', max: pageSize,
+        alllevel: '1', virtualtype: '1', status: '8',
+        isFromMode: '1',
+        modeId: String(opts.modeId ?? ''),
+        fieldid: String(opts.fieldId ?? ''),
+        isbill: '1', viewtype: '0',
+        secretLevel: '',
+        cmd: opts.cmd ?? 'newly',
+        __random__: String(Date.now()),
+    };
+    const r = await api.get(`/api/public/browser/data/${detailtype}`, q);
+    const j = r.json || {};
+    let flatDatas = [];
+    if (Array.isArray(j?.datas))
+        flatDatas = j.datas;
+    else if (j?.datas && typeof j.datas === 'object')
+        flatDatas = flattenTree(j.datas);
+    const cols = Array.isArray(j?.columns) ? j.columns : [];
+    let nameKey, pkKey;
+    if (cols.length > 0) {
+        const showCol = cols.find((c) => String(c.showType) === '1')
+            ?? cols.find((c) => /名称|名字|name/i.test(String(c.title ?? '')));
+        nameKey = showCol?.dataIndex ?? 'lastname';
+        const pkCol = cols.find((c) => c.isPrimarykey === 'true' || c.isPrimarykey === true);
+        pkKey = pkCol?.dataIndex;
+    }
+    else {
+        nameKey = flatDatas.length > 0 && flatDatas[0].lastname != null ? 'lastname' : 'name';
+        pkKey = null;
+    }
+    const items = flatDatas.filter((d) => d && d.id != null).map((d) => {
+        const pk = pkKey && d[pkKey] != null && String(d[pkKey]) !== '' ? String(d[pkKey]) : String(d.id);
+        const name = stripHtml(String(d[nameKey] ?? d.name ?? d.id));
+        return { id: pk, name: name || String(d.id) };
+    }).filter((o) => o.id);
+    return { detailtype, modeId: opts.modeId, fieldId: opts.fieldId, items, total: j?.count, raw: j };
+}
+/** 递归展平树形浏览数据（部门组织架构等），只取可点击节点。 */
+function flattenTree(node) {
+    const result = [];
+    if (!node || typeof node !== 'object')
+        return result;
+    if (node.canClick === true || String(node.canClick) === 'true' || node.type === '2' || node.type === 2) {
+        if (node.id != null)
+            result.push(node);
+    }
+    if (Array.isArray(node.subs))
+        for (const sub of node.subs)
+            result.push(...flattenTree(sub));
+    if (Array.isArray(node.children))
+        for (const sub of node.children)
+            result.push(...flattenTree(sub));
+    return result;
+}
+/** 把一行建模数据映射成 {id, name, fields:[{title, dataIndex, value}]}。 */
+export function normalizeCubeRow(row, columns = []) {
+    if (!row || typeof row !== 'object')
+        return { id: undefined, name: undefined, fields: [] };
+    const get = (keys) => pickByPaths(row, keys);
+    const spanOr = (dataIndex, extra = []) => stripHtml(get([`${dataIndex}span`, dataIndex, ...extra]));
+    const fields = columns
+        .filter((c) => c.dataIndex && c.dataIndex !== 'randomFieldId')
+        .map((c) => ({
+        dataIndex: c.dataIndex,
+        title: c.title || c.dataIndex,
+        value: spanOr(c.dataIndex) ?? '',
+    }));
+    const id = stringify(get(['id', 'randomFieldId']));
+    const nameCol = fields.find((f) => f.dataIndex !== 'id');
+    return {
+        id,
+        name: nameCol?.value ?? '',
+        fields,
+        raw: row,
+    };
+}
+/**
+ * ★新 按 billids 反查台账记录（P0-1/P0-2/P1-2，0.4.8）。
+ *
+ * 用途：delete dry-run 显示记录名、edit dry-run 显示改前值、view 命令显示完整值。
+ * 原理：循环调 listCube（pageSize 放大到 100），按行 `it.id` 精确匹配目标 billids。
+ * 返回 { rows:[{id,name,fields}], missing:[未找到的 billids] }。
+ * 找不到的记录（无权限/不存在/不在当前筛选视图）列入 missing，由调用方提示，不静默跳过。
+ */
+export async function fetchCubeRowsByIds(cfg, opts = {}) {
+    const customid = String(opts.customid);
+    const billids = (Array.isArray(opts.billids) ? opts.billids : String(opts.billids ?? '').split(','))
+        .map((s) => String(s).trim())
+        .filter(Boolean);
+    const targets = new Set(billids);
+    const rows = [];
+    const foundIds = new Set();
+    const pageSize = opts.pageSize ?? 100;
+    const maxPages = 20; // 2000 条封顶，防失控
+    for (let page = 1; page <= maxPages && foundIds.size < targets.size; page++) {
+        const r = await listCube(cfg, { customid, page, pageSize, modeId: opts.modeId, formId: opts.formId });
+        for (const it of r.items) {
+            const id = String(it.id ?? '');
+            if (!id || foundIds.has(id) || !targets.has(id))
+                continue;
+            foundIds.add(id);
+            rows.push({ id, name: it.name ?? '', fields: it.fields, raw: it.raw });
+        }
+        // 已找全目标；或本页已到末页（行数不足 pageSize）→ 停
+        if (foundIds.size >= targets.size || r.items.length < pageSize)
+            break;
+    }
+    const missing = billids.filter((b) => !foundIds.has(b));
+    return { rows, missing };
+}
+/**
+ * Excel 导出。链路：init→getList(取 dataKey) → doExcelExpost(取 key) → 轮询 getExcelExpProgress → FileDownload 下载。
+ * dry-run（!opts.yes）只打印 doExcelExpost 请求体与拟下载 URL，不真发起。
+ * 注：modeCustomid **必须 base64**（前端 WeaTools.Base64.encode，1001→"MTAwMQ=="）。
+ *   0.4.8 实测（.26 环境）：明文 modeCustomid → 服务端返回空壳 xlsx（有行无单元格）；
+ *   base64 才返回真实数据。默认 base64，opts.modeCustomidPlain=true 才用明文（逃生口）。
+ */
+export async function exportCubeExcel(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const customid = String(opts.customid);
+    const init = await getCubeInit(cfg, { customid });
+    const modeId = opts.modeId ?? init.modeId ?? '';
+    const formId = opts.formId ?? init.formId ?? '';
+    const filename = opts.filename || `${init.name ?? 'cube'}_${customid}.xlsx`;
+    const listBody = {
+        customid,
+        guid: 'search',
+        modeId,
+        formId,
+        current: '1',
+        pageSize: '10',
+        isotype: '0',
+        displayType: 'list',
+        type: 'list',
+    };
+    // P2-1：透传筛选条件（与 listCube 一致），支持 --condition / --keyword
+    if (opts.conditionValues && typeof opts.conditionValues === 'object') {
+        for (const [k, v] of Object.entries(opts.conditionValues))
+            listBody[k] = String(v);
+    }
+    if (opts.keyword)
+        listBody.quickSearchValue = opts.keyword;
+    const r1 = await api.post('/api/cube/search/getList', listBody);
+    const dataKey = extractCubeDataKey(r1.json);
+    if (!dataKey)
+        throw new Error(`cube export 未拿到 dataKey，getList 响应: ${(r1.text ?? '').slice(0, 200)}`);
+    const rCount = await api.post('/api/ec/dev/table/counts', { dataKey });
+    const sourceTotal = extractTotal(rCount.json) ?? extractTotal(r1.json) ?? extractRows(r1.json).length;
+    // modeCustomid：必须 base64（前端 WeaTools.Base64.encode(customId)，1001→"MTAwMQ=="）。
+    // 实测（0.4.8，.26 环境 customid=1001/4503）：明文 modeCustomid 服务端返回空壳 xlsx（有行无单元格）；
+    // base64 才返回真实数据（26 单元格 vs 0）。故默认 base64，明文仅作逃生口（--plain）。
+    const modeCustomid = opts.modeCustomidPlain
+        ? customid
+        : Buffer.from(customid).toString('base64');
+    const expBody = {
+        comefrom: 'frommode',
+        modeCustomid,
+        dataKey,
+        excelName: filename,
+        isexptree: 'false',
+        showOrder: 'all',
+        iscustomsearch: '1',
+        modeid: modeId,
+        ...(opts.isSelectGroup != null ? { isSelectGroup: String(opts.isSelectGroup) } : {}),
+        ...(opts.exptype ? { exptype: opts.exptype } : {}),
+    };
+    if (!opts.yes) {
+        return { dataKey, filename, downloaded: false, expBody, raw: { getList: r1.json } };
+    }
+    const rExp = await api.post('/api/cube/search/doExcelExpost', expBody);
+    const key = pickByPaths(rExp.json, ['key', 'data.key', 'exportkey', 'data.exportkey', 'datas', 'data.datas']);
+    if (!key || !/^[0-9a-fA-F]{16,}$/.test(String(key).trim())) {
+        throw new Error(`cube export 未拿到导出 key，doExcelExpost 响应: ${(rExp.text ?? '').slice(0, 300)}`);
+    }
+    const expKey = String(key).trim();
+    // 轮询进度，最多 ~60s
+    let progress = null;
+    for (let i = 0; i < 60; i++) {
+        await sleep(1000);
+        const rp = await api.get('/api/cube/search/getExcelExpProgress', { key: expKey });
+        progress = rp.json;
+        const done = pickByPaths(rp.json, ['isFinish', 'data.isFinish', 'finished', 'data.finished', 'status']);
+        if (String(done) === 'true' || String(done) === '1' || pickByPaths(rp.json, ['fileExists', 'data.fileExists']) === true) {
+            break;
+        }
+        const pct = pickByPaths(rp.json, ['progress', 'data.progress', 'percent', 'data.percent']);
+        if (pct != null)
+            process.stderr.write(`\r导出进度: ${pct}`);
+    }
+    if (progress)
+        process.stderr.write('\n');
+    // 下载文件流（/weaver/ servlet，走 cookie 头集合）
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    const cookie = endpointFor(cfg).cookie;
+    const dlUrl = `${baseUrl}/weaver/weaver.formmode.data.FileDownload?type=listExcelOut&key=${expKey}&filename=${encodeURIComponent(filename)}`;
+    const headers = {
+        'User-Agent': UA,
+        Referer: `${baseUrl}/spa/cube/index.html`,
+        Accept: '*/*',
+    };
+    if (cookie)
+        headers['Cookie'] = cookie;
+    if (baseUrl.startsWith('http://'))
+        headers['X-Requested-With'] = 'XMLHttpRequest';
+    const outPath = opts.outDir ? path.resolve(opts.outDir, filename) : path.resolve(process.cwd(), filename);
+    const res = await fetch(dlUrl, { headers });
+    if (!res.ok)
+        throw new Error(`下载失败: HTTP ${res.status} ${res.statusText}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    const validation = inspectXlsxBuffer(buf, sourceTotal);
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, buf);
+    return {
+        key: expKey,
+        filename,
+        outPath,
+        downloaded: true,
+        size: buf.length,
+        sourceTotal,
+        validation,
+        raw: { getList: r1.json, counts: rCount.json, doExcelExpost: rExp.json, progress },
+    };
+}
+
+/** 不依赖第三方库的最小 xlsx 结构检查；在落盘前拒绝 HTML、空响应和空壳工作簿。 */
+export function inspectXlsxBuffer(buf, sourceTotal = null) {
+    if (!Buffer.isBuffer(buf) || buf.length < 64 || buf.readUInt32LE(0) !== 0x04034b50)
+        throw new Error('导出响应不是有效的 xlsx(zip) 文件，已拒绝保存。');
+    let eocd = -1;
+    for (let i = buf.length - 22; i >= Math.max(0, buf.length - 65557); i--) {
+        if (buf.readUInt32LE(i) === 0x06054b50) { eocd = i; break; }
+    }
+    if (eocd < 0)
+        throw new Error('xlsx 缺少 ZIP 中央目录，文件不完整，已拒绝保存。');
+    const count = buf.readUInt16LE(eocd + 10);
+    let offset = buf.readUInt32LE(eocd + 16);
+    const entries = [];
+    for (let i = 0; i < count; i++) {
+        if (buf.readUInt32LE(offset) !== 0x02014b50)
+            throw new Error('xlsx ZIP 中央目录损坏，已拒绝保存。');
+        const method = buf.readUInt16LE(offset + 10);
+        const compressedSize = buf.readUInt32LE(offset + 20);
+        const nameLen = buf.readUInt16LE(offset + 28);
+        const extraLen = buf.readUInt16LE(offset + 30);
+        const commentLen = buf.readUInt16LE(offset + 32);
+        const localOffset = buf.readUInt32LE(offset + 42);
+        const name = buf.subarray(offset + 46, offset + 46 + nameLen).toString('utf8');
+        entries.push({ name, method, compressedSize, localOffset });
+        offset += 46 + nameLen + extraLen + commentLen;
+    }
+    const names = new Set(entries.map((entry) => entry.name));
+    if (!names.has('[Content_Types].xml') || !names.has('xl/workbook.xml'))
+        throw new Error('xlsx 缺少工作簿核心结构，已拒绝保存。');
+    const sheets = entries.filter((entry) => /^xl\/worksheets\/sheet\d+\.xml$/i.test(entry.name));
+    if (!sheets.length)
+        throw new Error('xlsx 中没有工作表，已拒绝保存。');
+    let cells = 0;
+    let rows = 0;
+    for (const entry of sheets) {
+        const local = entry.localOffset;
+        if (buf.readUInt32LE(local) !== 0x04034b50)
+            throw new Error(`xlsx 工作表 ${entry.name} 数据损坏。`);
+        const nameLen = buf.readUInt16LE(local + 26);
+        const extraLen = buf.readUInt16LE(local + 28);
+        const start = local + 30 + nameLen + extraLen;
+        const packed = buf.subarray(start, start + entry.compressedSize);
+        const xml = (entry.method === 0 ? packed : entry.method === 8 ? inflateRawSync(packed) : Buffer.alloc(0)).toString('utf8');
+        if (!xml)
+            throw new Error(`xlsx 工作表 ${entry.name} 使用了不支持的压缩格式。`);
+        cells += (xml.match(/<c(?:\s|\/?>)/g) || []).length;
+        rows += (xml.match(/<row(?:\s|\/?>)/g) || []).length;
+    }
+    if (cells === 0)
+        throw new Error('导出的 xlsx 是空壳（工作表中没有单元格），已拒绝保存。');
+    if (Number(sourceTotal) > 0 && rows < 2)
+        throw new Error(`源列表有 ${sourceTotal} 条数据，但导出的 xlsx 没有数据行，已拒绝保存。`);
+    return { valid: true, worksheetCount: sheets.length, rowCount: rows, cellCount: cells, sourceTotal: sourceTotal == null ? null : Number(sourceTotal) };
+}
+
+// ─── Excel 批量导入（抓包：batchimport_excel 完整链路）────────────
+export async function downloadCubeImportTemplate(cfg, opts = {}) {
+    const customid = String(opts.customid ?? '');
+    if (!customid)
+        throw new Error('cube import-template 需要 --customid。');
+    const init = await getCubeInit(cfg, { customid });
+    const modeId = String(opts.modeId ?? init.modeId ?? '');
+    if (!modeId)
+        throw new Error(`台账 ${customid} 未解析到 modeId。`);
+    const ep = endpointFor(cfg);
+    const baseUrl = ep.baseUrl.replace(/\/+$/, '');
+    const response = await fetch(`${baseUrl}/weaver/weaver.formmode.data.FileDownload?type=batchimport_excel&modeid=${encodeURIComponent(modeId)}`, {
+        headers: { Cookie: ep.cookie || '', Referer: `${baseUrl}/spa/cube/index.html`, 'User-Agent': UA, Accept: '*/*' },
+        signal: AbortSignal.timeout(30000),
+    });
+    if (!response.ok)
+        throw new Error(`台账导入模板下载失败：HTTP ${response.status}`);
+    const disposition = response.headers.get('content-disposition') || '';
+    const encodedName = disposition.match(/filename\*=UTF-8''([^;]+)/i)?.[1];
+    const plainName = disposition.match(/filename="?([^";]+)"?/i)?.[1];
+    let serverFilename = opts.filename || init.name || `cube_${customid}.xlsx`;
+    try { serverFilename = encodedName ? decodeURIComponent(encodedName) : (plainName || serverFilename); } catch { /* 保留回退名 */ }
+    if (!/\.xlsx?$/i.test(serverFilename)) serverFilename += '.xlsx';
+    const outDir = path.resolve(opts.outDir || path.join(os.homedir(), 'Downloads'));
+    const buf = Buffer.from(await response.arrayBuffer());
+    const validation = assertExcelLike(buf, '台账导入模板');
+    fs.mkdirSync(outDir, { recursive: true });
+    const outPath = nextAvailablePath(outDir, serverFilename);
+    fs.writeFileSync(outPath, buf);
+    let requiredFields = [];
+    try {
+        const fields = await getCardFields(cfg, { modeId, formId: init.formId, type: '1' });
+        requiredFields = (fields.fields || []).filter((field) => field.ismandatory === true || String(field.ismandatory) === '1').map((field) => field.label || field.fieldname).filter(Boolean);
+    }
+    catch { /* 必填字段获取失败不影响模板下载，但返回空数组，不能猜 */ }
+    return {
+        downloaded: true, outPath, size: buf.length, validation, customid, modeId,
+        requiredFields,
+        requiredFieldsKnown: requiredFields.length > 0,
+        fillRules: ['只能修改数据单元格值', '不得修改表头、格式、批注、必填提示、数据验证、公式、隐藏状态及工作表结构'],
+    };
+}
+
+export function parseCubeImportStatus(json) {
+    const status = json?.impStatus ?? json?.data?.impStatus ?? json?.data ?? json ?? {};
+    const message = stripHtml(status.msg ?? status.message ?? status.errmsg ?? json?.message ?? '').replace(/\s+/g, ' ').trim();
+    const done = String(status.status ?? '') === '-1' || Number(status.step) >= 5;
+    const success = done && String(status.s ?? '') === '1' && String(status.errorflag ?? '0') === '0';
+    const counts = [...message.matchAll(/(成功|失败)[^0-9]*(\d+)条/g)].reduce((acc, match) => ({ ...acc, [match[1] === '成功' ? 'successCount' : 'failureCount']: Number(match[2]) }), {});
+    return { done, success, message, successCount: counts.successCount ?? null, failureCount: counts.failureCount ?? null, raw: json };
+}
+
+export async function importCubeExcel(cfg, opts = {}) {
+    const customid = String(opts.customid ?? '');
+    const filePath = path.resolve(String(opts.file ?? ''));
+    if (!customid)
+        throw new Error('cube import 需要 --customid。');
+    if (!opts.yes)
+        return { imported: false, requiresConfirmation: true, operation: 'cube-import', customid, filePath };
+    if (!opts.file || !fs.existsSync(filePath) || !fs.statSync(filePath).isFile())
+        throw new Error(`找不到台账导入文件：${filePath}`);
+    if (!/\.xlsx?$/i.test(filePath))
+        throw new Error('台账导入文件必须是 .xls 或 .xlsx。');
+    const init = await getCubeInit(cfg, { customid });
+    const modeId = String(opts.modeId ?? init.modeId ?? '');
+    if (!modeId)
+        throw new Error(`台账 ${customid} 未解析到 modeId。`);
+    const ep = endpointFor(cfg);
+    const tempkey = String(Date.now());
+    const check = await e9Request(ep, { method: 'GET', path: '/api/cube/mode/mode/getBatchImportInfo', query: { operation: 'checkImp', modeid: modeId, isSinglePage: '1', customid } });
+    const token = pickByPaths(check.json, ['token', 'data.token']);
+    if (!check.ok || !token)
+        throw new Error(`台账导入初始化失败：${(check.text || '').slice(0, 300)}`);
+    const lock = await e9Request(ep, { method: 'POST', path: '/api/cube/mode/mode/lockUpload', body: { modeid: modeId, tempkey } });
+    if (!lock.ok || lock.json?.status === false)
+        throw new Error(`台账导入锁定失败：${(lock.text || '').slice(0, 300)}`);
+    const form = new FormData();
+    const filename = path.basename(filePath);
+    form.append('name', filename);
+    form.append('modeid', modeId);
+    form.append('secretLevel', String(opts.secretLevel ?? '4'));
+    form.append('ts', String(Date.now()));
+    form.append('file', new Blob([fs.readFileSync(filePath)], { type: /\.xlsx$/i.test(filePath) ? 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' : 'application/vnd.ms-excel' }), filename);
+    const upload = await fetch(`${ep.baseUrl.replace(/\/+$/, '')}/api/cube/mode/mode/uploadTempFile`, {
+        method: 'POST', headers: { Cookie: ep.cookie || '', Referer: `${ep.baseUrl}/spa/cube/index.html`, 'User-Agent': UA, Accept: '*/*' }, body: form, signal: AbortSignal.timeout(60000),
+    });
+    const uploadJson = await upload.json().catch(() => null);
+    const excelid = pickByPaths(uploadJson, ['data.fileid', 'fileid']);
+    if (!upload.ok || !excelid)
+        throw new Error(`台账文件上传失败：HTTP ${upload.status} ${JSON.stringify(uploadJson)?.slice(0, 300)}`);
+    const href = `modeid=${modeId}&customid=${customid}&_key=${Math.random().toString(36).slice(2, 8)}`;
+    const start = await e9Request(ep, { method: 'POST', path: '/api/cube/mode/mode/saveBatchImportInfo', body: {
+        modeid: modeId, href, excelid: String(excelid), importtype: opts.importtype ?? '1',
+        updateadddata: opts.updateadddata ?? '', keyfield: opts.keyfield ?? '', sourcetype: '0', tempkey,
+        conditionfield: opts.conditionfield ?? '', isprintlog: opts.isprintlog ?? '0',
+        isImportedWithIgnoringError: opts.ignoreErrors ?? '0', operation: 'startImport', token: String(token),
+    } });
+    if (!start.ok || start.json?.status === false)
+        throw new Error(`台账导入任务启动失败：${(start.text || '').slice(0, 300)}`);
+    let result = null;
+    const maxPolls = Number(opts.maxPolls ?? 120);
+    for (let i = 0; i < maxPolls; i++) {
+        await sleep(Number(opts.pollIntervalMs ?? 1000));
+        const poll = await e9Request(ep, { method: 'GET', path: '/api/cube/mode/mode/getBatchImportInfo', query: { modeid: modeId, tempkey, operation: 'getImpStatus' } });
+        result = parseCubeImportStatus(poll.json);
+        if (result.done)
+            break;
+    }
+    if (!result?.done)
+        throw new Error('台账导入状态轮询超时，不能判定成功；请在 E9 导入日志中核验，勿重复提交。');
+    return { imported: result.success, customid, modeId, filePath, excelid: String(excelid), tempkey, ...result };
+}
+/**
+ * ===== CRUD 写操作（来源：保存及保存新建.har + 删除.har）=====
+ * 建模台账的新建/编辑/删除记录能力，补全只读域的写操作缺口。
+ */
+/**
+ * 卡片字段定义 + 布局。GET mainFields + layoutBase。
+ * mainFields：字段 label/htmltype(1文本2多行3浏览4附件5选择框6复选)/fieldname/fieldtype。
+ * layoutBase：字段的 isedit/isview/ismandatory/fieldid + layoutid（提交体需要）。
+ * billid 空 + type=1 = 新建态；billid=id + type=0 = 查看态；type=1+billid=id = 编辑态。
+ */
+/**
+ * ===== CRUD 写操作（cookie 鉴权）=====
+ * 建模 doSubmit 要求 layoutBase 拿 token + doSubmit 提交全程同一 cookie session
+ * （token 鉴权会 repeat）。故卡片接口全部走 cookie（e9Request），不走 token。
+ * 完整链路：checkCardRight→getModeBase→mainFields→layoutBase→rightMenus→
+ *   cubeDataInput(trigger联动)→checkCardDataChange→cubeVerifyRepeat→checkCardDataChange(iscreate)→doSubmit。
+ * JSONStr 须含全部字段（mainFields/layoutBase 的所有 fieldid，未填给空），缺字段会 repeat。
+ * 附件字段先 docUpload 拿 fileid 填进 JSONStr。
+ */
+export async function getCardFields(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const modeId = String(opts.modeId);
+    const formId = String(opts.formId);
+    const billid = opts.billid ? String(opts.billid) : '';
+    const type = opts.type ?? (billid ? '0' : '1');
+    // 卡片会话标识：_key(随机6)/uuid(真随机32hex)/t(时间戳)，前端打开卡片时生成，所有卡片接口共用
+    const t = String(Date.now());
+    const _key = Math.random().toString(36).slice(2, 8);
+    const uuid = crypto.randomUUID().replace(/-/g, '').toUpperCase();
+    const q = { type: String(type), modeId, formId, guid: 'card', t, _key, uuid, billid };
+    const rMain = await e9Request(ep, { method: 'GET', path: '/api/cube/new/card/mainFields', query: q });
+    const rLay = await e9Request(ep, { method: 'GET', path: '/api/cube/new/card/layoutBase', query: { ...q, modedatastatus: '0' } });
+    const jMain = rMain.json ?? {};
+    const jLay = rLay.json ?? {};
+    // fail-loud：cookie 过期 / 无权限 → 报错而非静默返空。
+    // card 接口要求有效 WUI cookie 会话：cookie 过期返“登录信息超时”(002)；token 路径返 noRight（见校准要点）。
+    const _authFail = (j) => j && j.status === false && (j.errorCode === '002' || String(j.msg ?? '').includes('登录信息超时'));
+    const _noRight = (j) => j && (j.noRight === true || String(j.errorCode ?? '') === 'no-right');
+    if (_authFail(jMain) || _authFail(jLay)) {
+        throw new Error('卡片接口返回“登录信息超时”，cookie 可能已过期。请运行 `e9 auth token-login` 刷新 cookie 后重试。');
+    }
+    if (_noRight(jMain) || _noRight(jLay)) {
+        throw new Error('当前账号对该台账卡片无权限(noRight)。请换有权限账号或联系管理员开通该台账的卡片权限。');
+    }
+    const rawFields = pickByPaths(jMain, ['fields', 'data.fields']) ?? {};
+    const layoutFields = pickByPaths(jLay, ['fields', 'data.fields']) ?? {};
+    const layoutid = stringify(pickByPaths(jLay, ['layoutid', 'data.layoutid']));
+    const cardToken = stringify(pickByPaths(jLay, ['token', 'data.token']));
+    const fields = [];
+    for (const [fk, f] of Object.entries(rawFields)) {
+        const id = fk.replace(/^field/, '');
+        const lf = layoutFields[fk] ?? layoutFields[`field${id}`] ?? {};
+        fields.push({
+            id, label: stringify(f.fieldlabel), name: stringify(f.fieldname),
+            htmltype: stringify(f.fieldhtmltype), fieldtype: stringify(f.fieldtype),
+            fielddbtype: stringify(f.fielddbtype),
+            isdetail: f.isdetail,
+            isedit: stringify(lf.isedit) === '1',
+            isview: stringify(lf.isview) === '1',
+            ismandatory: stringify(lf.ismandatory) === '1',
+            // 查看态（billid）mainFields 通常带字段当前值：兼容 fieldvalue（对象/标量）/ value
+            value: fieldValueOf(f),
+        });
+    }
+    return { modeId, formId, billid, type, layoutid, cardToken, _key, uuid, fields };
+}
+/** 从 mainFields 的单个字段对象里提取当前值（兼容 fieldvalue 对象/标量、value、showvalue）。 */
+function fieldValueOf(f) {
+    if (!f || typeof f !== 'object')
+        return undefined;
+    const raw = f.fieldvalue !== undefined ? f.fieldvalue : (f.value !== undefined ? f.value : f.showvalue);
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw === 'object') {
+        if (raw.value !== undefined && raw.value !== null)
+            return stringify(raw.value);
+        if (raw.showvalue !== undefined && raw.showvalue !== null)
+            return stringify(raw.showvalue);
+        if (raw.showname !== undefined && raw.showname !== null)
+            return stringify(raw.showname);
+        return undefined;
+    }
+    return stringify(raw);
+}
+/** 上传附件（cookie）。POST /api/formmode/card/docUpload（multipart）→ fileid。 */
+async function uploadModeFile(ep, cookie, filePath) {
+    const buf = fs.readFileSync(filePath);
+    const filename = path.basename(filePath);
+    const fd = new FormData();
+    fd.append('name', filename);
+    fd.append('secretLevel', '');
+    fd.append('ts', String(Date.now()));
+    fd.append('file', new Blob([buf]), filename);
+    const base = ep.baseUrl.replace(/\/+$/, '');
+    const r = await fetch(`${base}/api/formmode/card/docUpload`, {
+        method: 'POST',
+        headers: { Cookie: cookie, 'X-Requested-With': 'XMLHttpRequest', Referer: `${base}/spa/cube/index.html` },
+        body: fd,
+    });
+    const j = await r.json();
+    return { fileid: String(j?.data?.fileid ?? ''), imagefileid: String(j?.data?.imagefileid ?? '') };
+}
+/**
+ * 建模卡片字段联动解析（0.4.2 修复 #3）。
+ *
+ * 背景：原 submitCubeCard 对 cubeDataInput 传空 trigger '{}'，未解析响应，导致建模域联动不生效
+ *   （如选经办人后经办部门不自动带出）。流程域 wfstart.js 用 reqDataInputResult 解析 changeValue；
+ *   建模域对应接口为 POST /api/cube/new/card/cubeDataInput，trigger 字段携带已填触发字段值。
+ *
+ * 本函数：
+ *   1. 从已填 values 构造 trigger JSON（把所有已填字段以 {field<id>: value} 形式打包）；
+ *   2. POST cubeDataInput（cookie，同卡片 session）；
+ *   3. 解析响应中的 changeValue/assignInfo（键名以实跑为准），把关联字段自动填值并入 values，
+ *      **不覆盖用户已填的值**；
+ *   4. 返回 { trigger, values(已并入联动), raw, applied }。
+ *
+ * ⚠ 待校准点（无建模卡片联动 HAR）：
+ *   - trigger 的精确 JSON 结构（这里用 {field<id>:value} 全量打包，服务端按配置取所需）；
+ *   - 响应中 changeValue 的键名（这里兼容 changeValue / assignInfo_* 多种）；
+ *   - 联动配置来源（建模卡片字段定义里是否含 linkageId/relatefields，目前未消费，靠服务端按
+ *     modeId/formId 自行匹配触发字段）。实跑后用 --raw 校准 trigger 结构与响应键名再细化。
+ *   失败不阻断提交（catch 返回原 values）。
+ */
+async function resolveCubeLinkage(ep, { modeId, formId, _key, uuid, layoutid, fields, values }) {
+    // 收集已填字段，构造 trigger（全量打包，服务端按联动配置自取触发字段）
+    const trigObj = {};
+    for (const f of fields) {
+        const id = String(f.id);
+        const v = values[id] ?? values[`field${id}`];
+        if (v !== undefined && v !== null && v !== '')
+            trigObj[`field${id}`] = String(v);
+    }
+    const trigger = JSON.stringify(trigObj);
+    let applied = {};
+    let raw = null;
+    try {
+        const r = await e9Request(ep, {
+            method: 'POST', path: '/api/cube/new/card/cubeDataInput',
+            body: { type: '1', modeId, formId, _key, guid: 'card', uuid, layoutid, modedatastatus: '', trigger },
+        });
+        raw = r.json ?? {};
+        // 兼容多种响应键名：changeValue / data.changeValue / assignInfo_*.changeValue
+        const cv = pickByPaths(raw, ['changeValue', 'data.changeValue', 'data.changeValue.changeValue'])
+            ?? scanChangeValue(raw);
+        if (cv && typeof cv === 'object') {
+            for (const [key, val] of Object.entries(cv)) {
+                if (!val || typeof val !== 'object')
+                    continue;
+                const targetId = String(key).replace(/^field/, '');
+                const cur = values[targetId] ?? values[`field${targetId}`];
+                if (cur !== undefined && cur !== null && cur !== '')
+                    continue; // 用户已填不覆盖
+                const fv = val.value !== undefined ? String(val.value) : '';
+                if (fv === '')
+                    continue;
+                values[targetId] = fv; // 并入（JSONStr 构造时按 field<id> 取）
+                applied[targetId] = { value: fv, specialobj: Array.isArray(val.specialobj) ? val.specialobj : undefined };
+            }
+        }
+    }
+    catch {
+        // 联动失败不阻断，返回原 trigger + 空 applied
+    }
+    return { trigger, values, applied, raw };
+}
+/** 在响应里递归找第一个形如 changeValue 的对象（键名固定为 changeValue）。 */
+function scanChangeValue(obj) {
+    if (obj == null)
+        return null;
+    if (typeof obj === 'object' && !Array.isArray(obj)) {
+        if (obj.changeValue && typeof obj.changeValue === 'object')
+            return obj.changeValue;
+        for (const v of Object.values(obj)) {
+            const r = scanChangeValue(v);
+            if (r)
+                return r;
+        }
+    }
+    return null;
+}
+/**
+ * 新建/编辑台账记录（cookie 鉴权 + 完整前置链路 + 附件 + 全字段 JSONStr）。
+ * billid 空=新建（返回新 billid）；billid=id=编辑。
+ * opts: { modeId, formId, billid?, values:{id:value}, files:[{fieldId,filePath}], trigger?, pageexpandid?, cf? }
+ *  ⚠ 必须全程 cookie 鉴权（layoutBase + doSubmit 同 session），否则 doSubmit 返 repeat。
+ */
+export async function submitCubeCard(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const cookie = ep.cookie;
+    const modeId = String(opts.modeId);
+    const formId = String(opts.formId);
+    const billid = opts.billid ? String(opts.billid) : '';
+    const iscreate = billid ? '0' : '1';
+    const cf = opts.cf ?? await getCardFields(cfg, { modeId, formId, billid });
+    const { layoutid, cardToken, _key, uuid, fields } = cf;
+    const t = String(Date.now());
+    const cq = (o = {}) => ({ type: '1', modeId, formId, guid: 'card', t, _key, uuid, billid, ...o });
+    // ① 卡片打开链路（cookie，同 session）
+    await e9Request(ep, { method: 'GET', path: '/api/cube/new/card/checkCardRight', query: cq() });
+    await e9Request(ep, { method: 'GET', path: '/api/cube/new/card/getModeBase', query: cq() });
+    const rMenus = await e9Request(ep, { method: 'GET', path: '/api/cube/new/card/rightMenus', query: cq({ layoutid, modedatastatus: '' }) });
+    const menus = rMenus.json?.rightMenus ?? [];
+    const pageexpandid = String(opts.pageexpandid ?? menus.find((m) => m.name === '保存')?.key ?? layoutid);
+    // ② 附件上传 → fileid，并入 values
+    const values = { ...(opts.values ?? {}) };
+    for (const f of (opts.files ?? [])) {
+        const up = await uploadModeFile(ep, cookie, f.filePath);
+        values[f.fieldId] = up.fileid;
+    }
+    // ③ 字段联动解析 + cubeDataInput（修复 #3：原传空 trigger 且不解析响应）
+    //   - opts.trigger 未给：调 resolveCubeLinkage（内部 POST cubeDataInput + 解析 changeValue 回填关联字段，不覆盖用户已填）
+    //   - opts.trigger 给定：直接用该 trigger 调 cubeDataInput（链路保留）
+    if (opts.trigger === undefined) {
+        const lk = await resolveCubeLinkage(ep, { modeId, formId, _key, uuid, layoutid, fields, values });
+        for (const fid of Object.keys(lk.applied ?? {})) {
+            const info = lk.applied[fid];
+            const so = info.specialobj?.[0];
+            console.log(`  🔗 建模联动: → field${fid}=${so?.name ?? info.value} (id=${info.value})`);
+        }
+    }
+    else {
+        await e9Request(ep, { method: 'POST', path: '/api/cube/new/card/cubeDataInput', body: { type: '1', modeId, formId, _key, guid: 'card', uuid, layoutid, modedatastatus: '', trigger: opts.trigger } });
+    }
+    const cdt = nowStr();
+    await e9Request(ep, { method: 'POST', path: '/api/cube/new/card/checkCardDataChange', body: { billid, type: '1', modeId, formId, _key, guid: 'card', changeDataTime: cdt } });
+    await e9Request(ep, { method: 'POST', path: '/api/cube/new/card/cubeVerifyRepeat', body: { billid, type: '1', modeId, formId, _key, guid: 'card', verifys: '{}' } });
+    await e9Request(ep, { method: 'POST', path: '/api/cube/new/card/checkCardDataChange', body: { billid, type: '1', modeId, formId, _key, guid: 'card', changeDataTime: cdt, iscreate } });
+    // ④ JSONStr 全字段（cf.fields 所有 id，values 覆盖，未填给空）
+    const jsonObj = {};
+    for (const f of fields)
+        jsonObj[`field${f.id}`] = String(values[f.id] ?? values[`field${f.id}`] ?? '');
+    // ⑤ doSubmit（cookie，同 session）
+    const body = {
+        billid, type: '1', modeId, formId, _key, guid: 'card', token: cardToken,
+        layoutid, isFormMode: '1', iscreate, src: 'submit', currentLayoutId: layoutid,
+        pageexpandid, JSONStr: JSON.stringify(jsonObj), btntype: '', issystemflag: '1', oldmodedatastatus: '0',
+    };
+    const r = await e9Request(ep, { method: 'POST', path: '/api/cube/new/card/doSubmit', body });
+    const j = r.json ?? {};
+    return { ok: j.status === '1' || j.status === 1, billid: stringify(j.billid) ?? billid, iscreate, raw: j };
+}
+/**
+ * ★新 新建/编辑 dry-run 联动预览（P1-1，0.4.8）。
+ *
+ * 目的：让 create/edit 的 dry-run 与真实提交**完全一致**——真实提交会调 resolveCubeLinkage
+ *   回填联动字段，而旧 dry-run 只展示用户传入 values，导致"确认的字段集 ≠ 最终提交字段集"。
+ *
+ * 行为：getCardFields → 附件路径解析（不实际上传，仅记录待传清单）→ resolveCubeLinkage（真实 POST
+ *   cubeDataInput，解析 changeValue 回填联动字段，不覆盖用户已填）→ 返回最终 values + 回填明细。
+ * **不调 doSubmit / 不上传附件**，无真实写副作用。
+ *
+ * 返回 { modeId, formId, billid, layoutid, fields, finalValues, linked: [{fieldId,label,value}], files }。
+ */
+export async function previewCubeCard(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const modeId = String(opts.modeId);
+    const formId = String(opts.formId);
+    const billid = opts.billid ? String(opts.billid) : '';
+    const cf = opts.cf ?? await getCardFields(cfg, { modeId, formId, billid });
+    const { layoutid, _key, uuid, fields } = cf;
+    const values = { ...(opts.values ?? {}) };
+    // 附件：只记录清单（dry-run 不上传），预览提示"--yes 时上传"
+    const files = (opts.files ?? []).map((f) => ({ fieldId: String(f.fieldId), filePath: f.filePath }));
+    // 联动解析（真实接口、无写副作用；失败不阻断——resolveCubeLinkage 内部 catch 返回原 values）
+    let linked = [];
+    if (opts.trigger === undefined) {
+        const lk = await resolveCubeLinkage(ep, { modeId, formId, _key, uuid, layoutid, fields, values });
+        linked = Object.entries(lk.applied ?? {}).map(([fid, info]) => {
+            const f = fields.find((x) => String(x.id) === String(fid));
+            const so = info.specialobj?.[0];
+            return { fieldId: String(fid), label: f?.label ?? `field${fid}`, value: so?.name ?? info.value };
+        });
+    }
+    return { modeId, formId, billid, layoutid, fields, finalValues: values, linked, files };
+}
+/** 删除台账记录（cookie）。GET /api/cube/expand/deleteData?operate=DeleteAction&billids=。 */
+export async function deleteCubeData(cfg, opts = {}) {
+    const ep = endpointFor(cfg);
+    const r = await e9Request(ep, {
+        method: 'GET', path: '/api/cube/expand/deleteData',
+        query: { customid: String(opts.customid), guid: 'search', operate: 'DeleteAction', billids: Array.isArray(opts.billids) ? opts.billids.join(',') : String(opts.billids ?? ''), pageexpandid: String(opts.pageexpandid ?? ''), modeId: String(opts.modeId ?? '') },
+    });
+    const j = r.json ?? {};
+    return { ok: j.status === '1' || j.status === 1, message: stringify(j.message), raw: j };
+}
+/**
+ * 打印台账卡片（有头浏览器打开卡片页面，用户自己点打印）。
+ * E9 打印是 window.print（前端 JS 生成打印预览含时间页眉），无法纯接口/page.pdf 复刻，
+ * 故直接弹出卡片详情页让用户自己点「打印」按钮（弹浏览器打印对话框，可另存 PDF）。
+ * 链路：有头浏览器加载 storageState（免登录）→ 导航卡片 → 保留浏览器 5 分钟供用户操作；
+ *   storageState 过期 → 弹登录页登录 → 保存 storageState → 导航卡片。
+ * opts: { customid, billid, modeId, formId }
+ */
+export async function printCubePdf(cfg, opts = {}) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    const profile = profileNameFromBaseUrl(baseUrl);
+    const os = await import('node:os');
+    const p = await import('node:path');
+    const fsMod = await import('node:fs');
+    const cfgDir = p.join(os.homedir(), '.e9');
+    const storagePath = p.join(cfgDir, `storageState_${profile}.json`);
+    const customid = String(opts.customid), billid = String(opts.billid);
+    const modeId = String(opts.modeId), formId = String(opts.formId);
+    const cardUrl = `${baseUrl}/spa/cube/index.html#/main/cube/card?modeId=${modeId}&formId=${formId}&billid=${billid}&customid=${customid}&type=0`;
+    let chromium;
+    try {
+        chromium = (await import('playwright')).chromium;
+    }
+    catch {
+        throw new Error('playwright 未安装，打印需要它：npm install playwright');
+    }
+    const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe';
+    // 有头浏览器（用户可见，自己点打印）
+    const browser = await chromium.launch({ executablePath: EDGE, headless: false });
+    const ctx = await browser.newContext({ viewport: { width: 1280, height: 800 } });
+    // 加载 storageState（免登录）
+    if (fsMod.existsSync(storagePath)) {
+        try {
+            await ctx.addCookies(JSON.parse(fsMod.readFileSync(storagePath, 'utf8')).cookies);
+        }
+        catch { }
+    }
+    const page = await ctx.newPage();
+    await page.goto(cardUrl, { waitUntil: 'networkidle', timeout: 60000 }).catch((e) => console.log('nav:', e.message));
+    await page.waitForTimeout(8000);
+    // 检查是否重定向登录页（storageState 失效）
+    const text = await page.evaluate(() => document.body.innerText.slice(0, 200));
+    if (/请使用e-mobile|登录名|登录密码/.test(text)) {
+        console.log('storageState 过期，请在浏览器登录...');
+        await page.goto(baseUrl, { waitUntil: 'domcontentloaded', timeout: 60000 }).catch(() => { });
+        await page.waitForURL(/#\/main\//, { timeout: 600000 }).catch(() => console.log('等待登录超时'));
+        await ctx.storageState({ path: storagePath }).catch(() => { });
+        await page.goto(cardUrl, { waitUntil: 'networkidle', timeout: 60000 });
+        await page.waitForTimeout(8000);
+    }
+    console.log(`已在浏览器打开合同详情页（customid=${customid} billid=${billid}），请点击页面「打印」按钮，在弹出的打印对话框中选「另存为 PDF」。浏览器保留 5 分钟供操作。`);
+    await page.waitForTimeout(300000);
+    await browser.close();
+    return { ok: true, mode: 'browser' };
+}
+/** 当前时间 YYYY-MM-DD HH:mm:ss（doSubmit 的 changeDataTime 用）。 */
+function nowStr() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+function stringify(v) {
+    if (v === undefined || v === null || v === '')
+        return undefined;
+    return String(v);
+}
+/* =========================================================================
+ * 台账发现与查询（0.4.0-14 新增）
+ *
+ * 缺口背景：原 cube 命令全部要求 --customid 已知，无"列全部台账/按名找"能力；
+ *   cube.md 文档虽写了"调菜单接口找台账"，但未落地成命令。
+ *
+ * 三条路径（查询时按 3→1→2 顺序）：
+ *   1. 目录接口（主源）：GET /api/ai/cube/mode/getCubeSearchList → sessionkey
+ *      → POST /api/ec/dev/table/datas（pageSize=100 翻页）→ /counts。
+ *      返回建模台账后台注册表全量（id=customid + list_name + mode_id + form_id + app_name），
+ *      比菜单全（菜单只含挂出的，目录含未挂出的）。/api/ai 命名空间 = E9 专为 AI 暴露的发现接口。
+ *   2. 菜单接口（低权限账号 / 目录接口失败时兜底）：GET /api/portal/menu/getFrontEndMenu
+ *      递归扫菜单树找 linkAddress 含 /main/cube/search?customid=N 的节点。
+ *      只给挂出的台账（目录的子集），无 mode_id/form_id。
+ *   3. 本地缓存（首查即预热全量）：~/.e9/cube_catalog_<envkey>.json，按环境隔离
+ *      （customid 不跨环境通用），TTL 7 天，--refresh 强制重拉、--no-cache 实时查。
+ *
+ * 设计要点：
+ *   - 缓存"全量预热"而非"按查询懒存"：一次目录调用拿全 → 后续按名查找全本地毫秒级。
+ *   - 按名匹配必须列候选消歧（"合同"相关台账 30+ 个、近似名多），不得自动取首条。
+ *   - 目录里 mode_id 为空的是只读查询视图，card-fields/create/print 等写操作跑不了。
+ * ========================================================================= */
+/** 目录缓存 TTL（天）。 */
+const CUBE_CATALOG_TTL_DAYS = 7;
+/** 目录缓存文件路径：~/.e9/cube_catalog_<envkey>.json（按环境隔离）。 */
+export function cubeCachePath(cfg) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    const envkey = profileNameFromBaseUrl(baseUrl);
+    return path.join(os.homedir(), '.e9', `cube_catalog_${envkey}.json`);
+}
+/** 读缓存；返回 {entries, fetchedAt, source, baseUrl} 或 null。 */
+function readCubeCache(cfg) {
+    const p = cubeCachePath(cfg);
+    try {
+        if (!fs.existsSync(p))
+            return null;
+        const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
+        if (!raw || !Array.isArray(raw.entries))
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+/** 写缓存（全量预热）。写入失败不阻断查询。 */
+function writeCubeCache(cfg, entries, source) {
+    const p = cubeCachePath(cfg);
+    try {
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        const raw = {
+            envkey: profileNameFromBaseUrl(baseUrl),
+            baseUrl,
+            fetchedAt: new Date().toISOString(),
+            source,
+            count: entries.length,
+            entries,
+        };
+        fs.writeFileSync(p, JSON.stringify(raw, null, 2) + '\n', 'utf8');
+    }
+    catch (e) {
+        console.error('[cube cache] 写入失败:', e.message);
+    }
+}
+/** 缓存是否过期（超 TTL 或无 fetchedAt）。 */
+function isCacheStale(cache) {
+    if (!cache || !cache.fetchedAt)
+        return true;
+    const ageMs = Date.now() - new Date(cache.fetchedAt).getTime();
+    return ageMs > CUBE_CATALOG_TTL_DAYS * 24 * 3600 * 1000;
+}
+/**
+ * 路径1：调目录接口拉全量台账。
+ * GET /api/ai/cube/mode/getCubeSearchList → sessionkey
+ * → POST /api/ec/dev/table/datas（pageSize=100 翻页）→ /counts。
+ * 返回 {entries:[{id,list_name,list_desc,mode_id,form_id,app_name,app_id,mode_name,table_name}], total, source:'catalog'}。
+ */
+export async function fetchCubeCatalog(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r1 = await api.get('/api/ai/cube/mode/getCubeSearchList');
+    const j1 = r1.json || {};
+    const sessionkey = pickByPaths(j1, ['data.sessionkey', 'sessionkey', 'data.sessionKey']);
+    if (!sessionkey)
+        throw new Error(`目录接口未返回 sessionkey：${(r1.text || '').slice(0, 200)}`);
+    const entries = [];
+    let page = 1;
+    let total = null;
+    while (page < 50) { // 上限 50 页 = 5000 条，足够
+        const r = await api.post('/api/ec/dev/table/datas', {
+            dataKey: sessionkey, current: String(page), pageSize: '100', sortParams: '[]',
+        });
+        const rows = extractRows(r.json);
+        if (!Array.isArray(rows) || rows.length === 0)
+            break;
+        for (const row of rows) {
+            const e = {
+                id: stringify(row.id) ?? stringify(row.randomFieldId),
+                list_name: stringify(row.list_name) ?? stringify(row.list_namespan),
+                list_desc: stringify(row.list_desc),
+                mode_id: stringify(row.mode_id),
+                form_id: stringify(row.form_id),
+                app_name: stringify(row.app_name) ?? stringify(row.app_namespan),
+                app_id: stringify(row.app_id),
+                mode_name: stringify(row.mode_name) ?? stringify(row.mode_namespan),
+                table_name: stringify(row.table_name),
+            };
+            if (e.id)
+                entries.push(e);
+        }
+        if (rows.length < 100)
+            break;
+        page++;
+    }
+    try {
+        const r3 = await api.post('/api/ec/dev/table/counts', { dataKey: sessionkey });
+        total = extractTotal(r3.json);
+    }
+    catch { /* counts 失败不阻断 */ }
+    return { entries, total: total ?? entries.length, source: 'catalog' };
+}
+/**
+ * 拉门户菜单树，建「菜单名索引」：customid → 菜单挂载点 [{name, path}]。
+ * GET /api/portal/menu/getFrontEndMenu?withPortal=1&isLoadAll=1 → 递归扫菜单树，两类挂载点：
+ *   ① 普通台账菜单：linkAddress 含 /main/cube/search?customid=N
+ *   ② cube 树形菜单：linkAddress 含 /main/cube/tree?id=<treeId>，其叶子台账挂在 cube 树节点数据中，
+ *      需另调 /api/cube/tree/datas（递归 pid）+ /api/cube/tree/href（节点→customid）解析后并入 byId。
+ * 一个台账可被多菜单挂载，byId[id] 是数组。best-effort：失败返空，不阻断查询。
+ *
+ * 解决：目录接口(getCubeSearchList)只给台账 list_name，不给门户菜单节点名；用户按前台菜单名找台账，
+ *   菜单名可能与台账名不符（如菜单「tree测试」挂 cube 树→台账 1354/1355/1356）。建索引合并进 entry.menus，find 即可按菜单名搜。
+ */
+export async function fetchMenuMounts(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/portal/menu/getFrontEndMenu', { withPortal: '1', isLoadAll: '1' });
+    if (!r.ok)
+        return { byId: {}, menuNodes: [], count: 0, error: `菜单接口失败: ${r.status} ${(r.text || '').slice(0, 150)}` };
+    const j = r.json;
+    const byId = {};
+    const menuNodes = []; // ★ #7 所有有名字+链接的菜单节点（台账/树/CRM/SPA 全收），供 e9 search 统一搜
+    const treeMenus = []; // { treeId, menuName, menuPath }
+    const stack = [];
+    function walk(node) {
+        if (!node || typeof node !== 'object')
+            return;
+        const name = String(node.fname || node.name || node.menuname || node.title || '');
+        if (name)
+            stack.push(name);
+        const link = String(node.linkAddress || node.linkaddress || node.url || '');
+        const m = link.match(/\/main\/cube\/search\?(?:[^#]*&)?customid=(\d+)/);
+        // ★ #7 收录所有菜单节点（不只 cube 台账菜单），让"客户监控"这类 CRM/SPA 菜单也能按名搜到
+        if (name && link) {
+            menuNodes.push({ name, path: stack.join(' / '), url: link, customid: m ? m[1] : undefined });
+        }
+        // ① 普通台账菜单挂载 → byId
+        if (m) {
+            const id = m[1];
+            const path = stack.join(' / ');
+            (byId[id] = byId[id] || []).push({ name, path, url: link });
+        }
+        // ② cube 树形菜单：url /main/cube/tree?id=<treeId>，叶子台账待解析
+        const tm = link.match(/\/main\/cube\/tree\?(?:[^#]*&)?id=(\d+)/);
+        if (tm) {
+            treeMenus.push({ treeId: tm[1], menuName: name, menuPath: stack.join(' / ') });
+        }
+        for (const k of ['children', 'child', 'subMenus', 'submenus', 'menuList', 'menus', 'data', 'list']) {
+            const v = node[k];
+            if (Array.isArray(v))
+                v.forEach(walk);
+        }
+        if (name)
+            stack.pop();
+    }
+    walk(j);
+    if (treeMenus.length === 0 && Object.keys(byId).length === 0 && Array.isArray(j))
+        j.forEach(walk);
+    // 解析 cube 树形菜单 → 叶子台账 customid，并入 byId
+    for (const tm of treeMenus) {
+        try {
+            await resolveCubeTreeMenu(api, tm.treeId, tm.menuPath, byId);
+        }
+        catch { /* 单棵树解析失败不阻断 */ }
+    }
+    return { byId, menuNodes, count: Object.keys(byId).length };
+}
+/**
+ * 解析 cube 树形菜单（portal 菜单节点 url /main/cube/tree?id=<treeId>）的叶子台账。
+ * GET /api/cube/tree/datas?id=<treeId>&guid=tree（根，&pid=<domid> 取子）→ [{domid,name,haschild}]
+ * GET /api/cube/tree/href?id=<treeId>&guid=tree&pid=<domid> → {href:".../main/cube/search?customid=N..."}
+ * 对每个树节点取 href 解析 customid，并入 byId（path = 菜单路径 / 树节点名链）。
+ * maxTreeNodes/maxTreeDepth 防止大树失控；domid 去重防环。
+ */
+async function resolveCubeTreeMenu(api, treeId, menuPath, byId) {
+    const maxNodes = 200;
+    const maxDepth = 6;
+    const seen = new Set();
+    let n = 0;
+    async function expand(nodes, parentPath, depth) {
+        for (const node of nodes) {
+            if (n >= maxNodes)
+                return;
+            const nm = String(node.name || node.title || '');
+            const fullPath = parentPath ? `${parentPath} / ${nm}` : (menuPath ? `${menuPath} / ${nm}` : nm);
+            // href → customid（每个节点都可能指向一个台账）
+            try {
+                const rh = await api.get('/api/cube/tree/href', { id: treeId, guid: 'tree', pid: node.domid, isRefreshTree: '0' });
+                const href = rh.json?.href || '';
+                const cm = href.match(/\/main\/cube\/search\?(?:[^#]*&)?customid=(\d+)/);
+                if (cm) {
+                    (byId[cm[1]] = byId[cm[1]] || []).push({ name: nm, path: fullPath, url: href });
+                    n++;
+                }
+            }
+            catch { /* 单节点 href 失败跳过 */ }
+            // 递归子节点
+            if (node.haschild && depth < maxDepth && !seen.has(node.domid)) {
+                seen.add(node.domid);
+                try {
+                    const rc = await api.get('/api/cube/tree/datas', { id: treeId, guid: 'tree', pid: node.domid });
+                    const kids = Array.isArray(rc.json?.datas) ? rc.json.datas : [];
+                    if (kids.length)
+                        await expand(kids, fullPath, depth + 1);
+                }
+                catch { /* 子节点展开失败跳过 */ }
+            }
+        }
+    }
+    const r0 = await api.get('/api/cube/tree/datas', { id: treeId, guid: 'tree' });
+    const roots = Array.isArray(r0.json?.datas) ? r0.json.datas : [];
+    if (roots.length)
+        await expand(roots, '', 0);
+}
+/**
+ * 路径2：调菜单接口兜底（低权限账号 / 目录接口失败时）。
+ * 复用 fetchMenuMounts：把菜单挂载点转成台账 entry（list_name 取菜单节点名，
+ *   因菜单兜底时台账实际名未知；menus 保留全部挂载点，listCubeMenus 第4步据此跳过重复请求）。
+ * 返回 {entries:[{id,list_name,app_name,menuPath,menus}], source:'menu'}（无 mode_id/form_id）。
+ */
+export async function fetchCubeMenusFromMenu(cfg) {
+    const mm = await fetchMenuMounts(cfg);
+    if (mm.error)
+        throw new Error(mm.error);
+    const entries = [];
+    for (const [id, mounts] of Object.entries(mm.byId)) {
+        const first = mounts[0];
+        entries.push({
+            id,
+            list_name: first.name,
+            list_desc: '',
+            mode_id: '',
+            form_id: '',
+            app_name: first.path.split(' / ').slice(0, -1).join('/') || '',
+            menuPath: first.path,
+            menus: mounts,
+        });
+    }
+    return { entries, source: 'menu' };
+}
+/**
+ * 台账目录发现（主入口）：缓存优先 → 目录接口（路径1）→ 菜单兜底（路径2）→ 菜单名索引（第4步）。
+ * opts: { refresh?:bool, noCache?:bool }
+ * 返回 { entries, source, count, fetchedAt, fromCache, total?, error? }。
+ * - 缓存命中且未过期 → 直接返回（fromCache:true，menus 已随缓存持久化）。
+ * - refresh/noCache 或缓存过期 → 拉目录；目录空/失败 → 菜单兜底；命中即合并菜单名索引后回写缓存。
+ * - 第4步菜单名索引：catalog 来源的 entry 缺菜单节点名，best-effort 拉门户菜单树补 menus 字段；
+ *   menu 来源已自带 menus，跳过避免重复请求。
+ */
+export async function listCubeMenus(cfg, opts = {}) {
+    // 1. 缓存命中
+    if (!opts.refresh && !opts.noCache) {
+        const cache = readCubeCache(cfg);
+        if (cache && !isCacheStale(cache) && Array.isArray(cache.entries) && cache.entries.length > 0) {
+            return { entries: cache.entries, source: cache.source || 'catalog', count: cache.entries.length, fetchedAt: cache.fetchedAt, fromCache: true };
+        }
+    }
+    // 2. 路径1：目录接口（主源，台账 list_name）
+    let entries = [];
+    let source = 'none';
+    let total = null;
+    let error = null;
+    try {
+        const catalog = await fetchCubeCatalog(cfg);
+        if (catalog.entries && catalog.entries.length > 0) {
+            entries = catalog.entries;
+            source = 'catalog';
+            total = catalog.total;
+        }
+    }
+    catch (e) {
+        error = e.message;
+    }
+    // 3. 路径2：菜单兜底（目录空/失败时；其 entry 已自带 menus）
+    if (entries.length === 0) {
+        try {
+            const menu = await fetchCubeMenusFromMenu(cfg);
+            if (menu.entries && menu.entries.length > 0) {
+                entries = menu.entries;
+                source = 'menu';
+            }
+        }
+        catch (e) {
+            error = [error, e.message].filter(Boolean).join('；');
+        }
+    }
+    if (entries.length === 0) {
+        return { entries: [], source: 'none', count: 0, fetchedAt: null, fromCache: false, error: error || '目录与菜单均返回空，账号可能无台账权限' };
+    }
+    // 4. ★菜单名索引：catalog 来源缺菜单节点名，best-effort 拉门户菜单树补 menus（menu 来源已自带，跳过避免重复请求）
+    if (source !== 'menu') {
+        try {
+            const mm = await fetchMenuMounts(cfg);
+            if (mm && mm.byId) {
+                for (const e of entries) {
+                    e.menus = mm.byId[e.id] || [];
+                }
+            }
+        }
+        catch { /* 菜单名索引失败不阻断，entries 照常返回（无 menus） */ }
+    }
+    // 5. 回写缓存 + 返回
+    writeCubeCache(cfg, entries, source);
+    return { entries, source, count: entries.length, fetchedAt: new Date().toISOString(), fromCache: false, total };
+}
+/**
+ * 按名模糊匹配台账（列候选，按相关度排序，不自动取首条）。
+ * 匹配源：台账 list_name 为主、mode_name/app_name 为辅；菜单名索引(entry.menus)另路匹配——
+ *   菜单节点名可能与台账名不符（如菜单「评级项」挂台账「供应商分类定义-评级项定义」），按菜单名也能搜到。
+ * 返回候选数组，每项含 score 与 matchNote（台账：精确/前缀/包含/名称被包含/模块·应用；菜单：菜单名·精确/前缀/包含、菜单路径·包含）。
+ */
+export function findCubeByName(entries, query) {
+    const q = String(query || '').trim().toLowerCase();
+    if (!q || !Array.isArray(entries))
+        return [];
+    const qNorm = q.replace(/台账$/, '').trim() || q;
+    const cands = [];
+    for (const e of entries) {
+        const name = String(e.list_name || '').trim().toLowerCase();
+        const mode = String(e.mode_name || '').trim().toLowerCase();
+        const app = String(e.app_name || '').trim().toLowerCase();
+        let score = 0;
+        let note = '';
+        // 台账名 / 模块·应用 匹配
+        if (name === q || name === qNorm) {
+            score = 100;
+            note = '精确';
+        }
+        else if (name.startsWith(qNorm)) {
+            score = 80;
+            note = '前缀';
+        }
+        else if (name.includes(qNorm)) {
+            score = 60;
+            note = '包含';
+        }
+        else if (qNorm.includes(name)) {
+            score = 40;
+            note = '名称被包含';
+        }
+        else if ((mode && mode.includes(qNorm)) || (app && app.includes(qNorm))) {
+            score = 20;
+            note = '模块·应用';
+        }
+        // ★菜单名 / 菜单路径 匹配（用户按门户菜单名找台账：菜单节点名可能与台账名不同）
+        const menus = Array.isArray(e.menus) ? e.menus : [];
+        for (const mu of menus) {
+            const mname = String(mu.name || '').trim().toLowerCase();
+            const mpath = String(mu.path || '').trim().toLowerCase();
+            let ms = 0;
+            let mn = '';
+            if (mname && (mname === q || mname === qNorm)) {
+                ms = 90;
+                mn = '菜单名·精确';
+            }
+            else if (mname && mname.startsWith(qNorm)) {
+                ms = 70;
+                mn = '菜单名·前缀';
+            }
+            else if (mname && mname.includes(qNorm)) {
+                ms = 50;
+                mn = '菜单名·包含';
+            }
+            else if (mpath && mpath.includes(qNorm)) {
+                ms = 30;
+                mn = '菜单路径·包含';
+            }
+            if (ms > score) {
+                score = ms;
+                note = mn;
+            }
+        }
+        if (score > 0)
+            cands.push({ ...e, score, matchNote: note });
+    }
+    cands.sort((a, b) => b.score - a.score);
+    return cands;
+}