weaver-e10-builder 1.0.2-beta

package/dist/commands/form-list.js

@@ -0,0 +1,624 @@
+import { AuthSession } from '../core/auth.js';
+import { ApiClient } from '../core/client.js';
+import { fetchFields, loadMobileConfig } from './form-list-utils.js';
+import { registerListStatsCommand } from './form-list-stats.js';
+import { registerListFilterCommand } from './form-list-filter.js';
+import { registerListEventCommand } from './form-list-event.js';
+import { registerListGroupCommand } from './form-list-group.js';
+import { registerListPermissionCommand } from './form-list-permission.js';
+import { registerListSearchGroupCommand } from './form-list-search-group.js';
+/** Generate a 32-char hex UUID for tableuid */
+function uuid32() {
+    const hex = '0123456789abcdef';
+    let s = '';
+    for (let i = 0; i < 32; i++)
+        s += hex[Math.floor(Math.random() * 16)];
+    return s;
+}
+/** LZW-encode a JSON config to comma-separated numbers */
+function encodeCustomConfig(obj) {
+    const source = JSON.stringify(obj);
+    if (!source)
+        return '';
+    const dict = {};
+    const output = [];
+    let nextCode = 1 << 16;
+    let current = source[0];
+    const codeFor = (token) => {
+        if (token in dict)
+            return dict[token];
+        if (token.length === 1) {
+            dict[token] = token.charCodeAt(0);
+            return dict[token];
+        }
+        throw new Error(`Cannot encode: ${token}`);
+    };
+    for (let i = 1; i < source.length; i++) {
+        const combined = current + source[i];
+        if (combined in dict) {
+            current = combined;
+            continue;
+        }
+        output.push(codeFor(current));
+        dict[combined] = nextCode++;
+        current = source[i];
+    }
+    output.push(codeFor(current));
+    return output.join(',');
+}
+/** Build a field-id → display-name map from tableField config */
+function buildFieldLabelMap(cfg) {
+    const map = {};
+    const tf = cfg.tableField || [];
+    for (const f of tf) {
+        if (f.id && f.text)
+            map[String(f.id)] = f.text;
+        // Also map the field_xxx form used in API row data
+        if (f.name && f.text)
+            map[String(f.name)] = f.text;
+    }
+    return map;
+}
+/** Resolve a row key to a display label using the field map */
+function resolveLabel(key, labelMap) {
+    // Direct ID match
+    if (labelMap[key])
+        return labelMap[key];
+    // field_xxx → xxx → text
+    const m = key.match(/^field_(\d+)$/);
+    if (m && labelMap[m[1]])
+        return labelMap[m[1]];
+    // Known system keys
+    if (key === 'id')
+        return '数据ID';
+    if (key === 'form_data_id')
+        return '表单数据ID';
+    if (key === 'unique_key')
+        return '唯一键';
+    if (key === 'sub_obj_id')
+        return '子表ID';
+    if (key === 'is_flow')
+        return '流程标记';
+    return key;
+}
+export function registerFormListCommands(form, program) {
+    // ======== list-columns ========
+    form.command('list-columns')
+        .description('查看/调整台账显示列')
+        .argument('<objId>', '表单 objId')
+        .argument('<appId>', '应用 ID')
+        .argument('<listId>', '台账列表 ID')
+        .option('--add <fieldId>', '追加字段到显示列')
+        .option('--remove <fieldId>', '移除显示列字段')
+        .option('--pc-only', '目标明确只使用 PC；移动端配置不存在时允许继续')
+        .option('--json', 'JSON 格式输出当前配置')
+        .action(async (objId, appId, listId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const isJson = cmdOpts.json || opts.json;
+        const getRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/list/getNListConfig/${listId}?apid=${appId}&tpaid=${listId}&terminalType=PC`);
+        if (getRes?.code !== 200 || !getRes?.status) {
+            console.error(`查询配置失败: ${getRes?.msg}`);
+            process.exit(1);
+        }
+        const cfg = getRes?.data || {};
+        const tableField = cfg.tableField || [];
+        if (!cmdOpts.add && !cmdOpts.remove) {
+            if (isJson) {
+                console.log(JSON.stringify(tableField, null, 2));
+                return;
+            }
+            console.log(`台账 ${listId} 显示列 (${tableField.length}):`);
+            for (const f of tableField) {
+                const flag = f.hidden ? '[隐藏]' : f.mainPrimaryKey ? '[主键]' : '';
+                console.log(`  ${f.id}  ${f.text || f.name || '(无名称)'}  ${f.type || ''}  ${flag}`);
+            }
+            return;
+        }
+        if (cmdOpts.add) {
+            const fields = await fetchFields(client, baseUrl, objId);
+            let target = fields.find((f) => String(f.id) === String(cmdOpts.add));
+            let isDetail = false;
+            if (!target) {
+                // 明细子字段在 ds/fields(enableMerge) 里被合并成占位、不展开，按 fieldId 用 getFormField
+                // 单独取元数据（实测 sjr：明细数量/明细名称 都能取到 title/type/componentKey/subFormId/dataKey）。
+                // 明细列 = 普通 tableField 条目（mainField:false），浏览器抓包确认非"双层明细展开"。
+                const info = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getInfoById/${objId}?apid=${appId}`, { ebbusinessid: appId });
+                const formId = info?.data?.formId || '';
+                if (formId) {
+                    const gf = await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/getFormField`, { module: 'ebuilderform', formTableField: { formField: { id: cmdOpts.add, form: { id: formId } } } }, { ebbusinessid: formId });
+                    const d = gf?.data;
+                    if (d && d.fieldId) {
+                        target = {
+                            id: d.fieldId, text: d.title, name: `field_${d.fieldId}`, objId,
+                            type: d.type, compType: d.componentKey, uid: '',
+                            subFormId: d.subFormId, dataKey: d.dataKey,
+                            physicalField: d.physicalField || d.dataKey,
+                            isDetailtable: d.isDetailtable ?? !!d.subFormId,
+                        };
+                        isDetail = !!d.subFormId;
+                    }
+                }
+            }
+            if (!target) {
+                console.error(`字段 ${cmdOpts.add} 在表单 ${objId} 中不存在`);
+                process.exit(1);
+            }
+            const mainField = !isDetail && !target.subFormId; // 明细子字段 mainField:false
+            // 完整克隆字段对象（平台要求完整字段对象：physicalField/dataKey/isDetailtable/subFormId 等，
+            // 手写 sparse 对象会被平台丢弃/重排 → 显示列时而出来时而没有）。对齐 form-table-view
+            // populateListDisplayFields 的 structuredClone 写法，再补平台台账列必备属性。
+            const newField = structuredClone(target);
+            newField.name = target.name || `field_${target.id}`;
+            newField.objId = target.objId || objId;
+            newField.mainField = mainField;
+            newField.mainPrimaryKey = false;
+            newField.uid = target.uid || uuid32();
+            newField.width = 150;
+            newField.fieldVersion = 1;
+            if (!tableField.find((f) => String(f.id) === String(target.id))) {
+                tableField.push(newField);
+                console.error(`  已加列: ${target.text} (mainField=${mainField}${isDetail ? ' 明细' : ''})`);
+            }
+            else {
+                console.error(`字段 ${target.id} 已在显示列中`);
+            }
+        }
+        if (cmdOpts.remove) {
+            const idx = tableField.findIndex((f) => String(f.id) === String(cmdOpts.remove));
+            if (idx >= 0)
+                tableField.splice(idx, 1);
+            else {
+                console.error(`字段 ${cmdOpts.remove} 不在当前显示列中`);
+                process.exit(1);
+            }
+        }
+        // 保存前读回真实移动端 mConfig 原样回传，避免把移动端台账列清空（抓包确认同接口 config→PC/mConfig→移动端）
+        const { mobileConfig, mobilePreserved } = await loadMobileConfig(client, baseUrl, appId, listId, cmdOpts.pcOnly);
+        const saveCfg = { ...cfg, tableField };
+        const saveRes = await client.post(`${baseUrl}/api/bs/ebuilder/form/list/saveNListConfig?apid=${appId}`, {
+            listId, appId, terminalType: 'PC', config: saveCfg, mConfig: mobileConfig,
+        });
+        if (saveRes?.code === 200 && saveRes?.status) {
+            console.log(isJson ? JSON.stringify({ success: true, listId }) : '显示列已保存');
+            console.log(`  移动端配置: ${mobilePreserved ? '保持原样' : '目标为 PC-only'}`);
+        }
+        else {
+            console.error(`保存失败: ${saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    // ======== list-format ========
+    form.command('list-format')
+        .description('查看/设置台账列显示格式（千分位/小数位）')
+        .argument('<objId>', '表单 objId')
+        .argument('<appId>', '应用 ID')
+        .argument('<listId>', '台账列表 ID')
+        .argument('<fieldId>', '列对应字段 ID')
+        .option('--thousandths', '开千分位（format=THOUSANDS）')
+        .option('--no-thousandths', '关千分位')
+        .option('--decimal <n>', '小数位数（decimalLength）')
+        .option('--clear', '清除千分位+小数位（恢复默认）')
+        .option('--pc-only', '目标明确只使用 PC；移动端配置不存在时允许继续')
+        .option('--json', 'JSON 格式输出当前列格式')
+        .action(async (objId, appId, listId, fieldId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const isJson = cmdOpts.json || opts.json;
+        const getRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/list/getNListConfig/${listId}?apid=${appId}&tpaid=${listId}&terminalType=PC`);
+        if (getRes?.code !== 200 || !getRes?.status) {
+            console.error(`查询配置失败: ${getRes?.msg}`);
+            process.exit(1);
+        }
+        const cfg = getRes?.data || {};
+        const tableField = cfg.tableField || [];
+        const col = tableField.find((f) => String(f.id) === String(fieldId));
+        if (!col) {
+            console.error(`未找到列 fieldId=${fieldId}。可用列: ${tableField.map((f) => `${f.id}(${f.text || f.name})`).join(', ')}`);
+            process.exit(1);
+        }
+        const hasThousandths = col.format === 'THOUSANDS';
+        if (cmdOpts.thousandths === undefined && cmdOpts.decimal === undefined && !cmdOpts.clear) {
+            if (isJson) {
+                console.log(JSON.stringify({ fieldId, format: col.format || null, decimalLength: col.decimalLength ?? null }, null, 2));
+                return;
+            }
+            console.log(`列 ${fieldId}（${col.text || col.name}）：千分位 ${hasThousandths ? '开' : '关'}${col.decimalLength != null ? `、小数位 ${col.decimalLength}` : ''}`);
+            return;
+        }
+        // 列级千分位/小数位直接写列对象：format:"THOUSANDS" 开千分位、decimalLength:N 小数位
+        // （非 showTrans.ruleConfig 也非 conversionSet——抓包坐实）。开千分位时补 hiddenColumn:0/widthUnit:"px" 对齐设计器。
+        if (cmdOpts.clear) {
+            delete col.format;
+            delete col.decimalLength;
+        }
+        else {
+            if (cmdOpts.thousandths === true) {
+                col.format = 'THOUSANDS';
+                col.hiddenColumn = 0;
+                col.widthUnit = 'px';
+            }
+            else if (cmdOpts.thousandths === false) {
+                delete col.format;
+            }
+            if (cmdOpts.decimal != null)
+                col.decimalLength = Number(cmdOpts.decimal);
+        }
+        const { mobileConfig, mobilePreserved } = await loadMobileConfig(client, baseUrl, appId, listId, cmdOpts.pcOnly);
+        const saveCfg = { ...cfg };
+        const saveRes = await client.post(`${baseUrl}/api/bs/ebuilder/form/list/saveNListConfig?apid=${appId}`, {
+            listId, appId, terminalType: 'PC', config: saveCfg, mConfig: mobileConfig,
+        });
+        if (saveRes?.code === 200 && saveRes?.status) {
+            const on = col.format === 'THOUSANDS';
+            console.log(isJson ? JSON.stringify({ success: true, listId, fieldId, format: col.format || null, decimalLength: col.decimalLength ?? null }) : `列 ${fieldId} 格式已保存：千分位 ${on ? '开' : '关'}${col.decimalLength != null ? `、小数位 ${col.decimalLength}` : ''}`);
+            console.log(`  移动端配置: ${mobilePreserved ? '保持原样' : '目标为 PC-only'}`);
+        }
+        else {
+            console.error(`保存失败: ${saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    // ======== list-search ========
+    form.command('list-search')
+        .description('查看/配置台账搜索条件')
+        .argument('<objId>', '表单 objId')
+        .argument('<appId>', '应用 ID')
+        .argument('<listId>', '台账列表 ID')
+        .option('--add <fieldIds...>', '添加搜索字段（进搜索面板，可多个）')
+        .option('--quick <fieldIds...>', '添加顶部快捷筛选字段（可多个）')
+        .option('--remove <fieldId>', '移除搜索字段')
+        .option('--pc-only', '目标明确只使用 PC；移动端配置不存在时允许继续')
+        .option('--json', 'JSON 格式输出当前搜索配置')
+        .action(async (objId, appId, listId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const isJson = cmdOpts.json || opts.json;
+        const getRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/list/getNListConfig/${listId}?apid=${appId}&tpaid=${listId}&terminalType=PC`);
+        if (getRes?.code !== 200 || !getRes?.status) {
+            console.error(`查询配置失败: ${getRes?.msg}`);
+            process.exit(1);
+        }
+        const cfg = getRes?.data || {};
+        const sc = cfg.searchConditions || {};
+        const commonFilters = sc.commonFilters || [];
+        const quickFilters = sc.quickFilters || [];
+        if (!cmdOpts.add && !cmdOpts.quick && !cmdOpts.remove) {
+            if (isJson) {
+                console.log(JSON.stringify(sc, null, 2));
+                return;
+            }
+            console.log(`搜索模式: ${sc.commonSearchType === '1' ? '高级搜索' : '常用搜索'}`);
+            if (quickFilters.length > 0) {
+                console.log(`快捷筛选 (${quickFilters.length}):`);
+                for (const f of quickFilters)
+                    console.log(`  ${f.fieldId || f.id}  ${f.text || f.showName || '(无名称)'}`);
+            }
+            if (commonFilters.length > 0) {
+                console.log(`搜索面板 (${commonFilters.length}):`);
+                for (const f of commonFilters)
+                    console.log(`  ${f.fieldId || f.id}  ${f.text || f.showName || '(无名称)'}  [${f.conditionTypeValue || f.type}]`);
+            }
+            return;
+        }
+        const addFilter = (target, dest, isQuick) => {
+            if (dest.find((f) => String(f.fieldId || f.id) === String(target.id)))
+                return false;
+            dest.push({
+                id: target.id, fieldId: target.id,
+                name: target.name || `field_${target.id}`, fieldName: target.name || `field_${target.id}`,
+                conditionTypeValue: 'like', showName: target.text, text: target.text,
+                type: target.type, compType: target.compType, objId: target.objId || objId,
+                subFormId: target.subFormId || '',
+                subTableId: target.subTableId || target.subFormId || '',
+                dataKey: target.dataKey || '',
+                physicalField: target.physicalField || target.dataKey || '',
+                isDetailtable: target.isDetailtable ?? !!target.subFormId,
+                isQuick: isQuick ? '1' : '0',
+                listFilterDefaultSets: { multiSelect: true },
+            });
+            return true;
+        };
+        if (cmdOpts.add || cmdOpts.quick) {
+            const fields = await fetchFields(client, baseUrl, objId);
+            let formId = '';
+            const resolveField = async (fid) => {
+                const t = fields.find((f) => String(f.id) === String(fid));
+                if (t)
+                    return t;
+                // 明细子字段在 ds/fields(enableMerge) 里被合并成占位、不展开，按 fieldId 用 getFormField
+                // 单独取元数据（与 list-columns 同款 fallback）。
+                if (!formId) {
+                    const info = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getInfoById/${objId}?apid=${appId}`, { ebbusinessid: appId });
+                    formId = info?.data?.formId || '';
+                }
+                if (formId) {
+                    const gf = await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/getFormField`, { module: 'ebuilderform', formTableField: { formField: { id: fid, form: { id: formId } } } }, { ebbusinessid: formId });
+                    const d = gf?.data;
+                    if (d && d.fieldId) {
+                        return { id: d.fieldId, text: d.title, name: `field_${d.fieldId}`, objId,
+                            type: d.type, compType: d.componentKey, uid: '',
+                            subFormId: d.subFormId, dataKey: d.dataKey,
+                            physicalField: d.physicalField || d.dataKey,
+                            isDetailtable: d.isDetailtable ?? !!d.subFormId };
+                    }
+                }
+                return null;
+            };
+            const addIds = Array.isArray(cmdOpts.add) ? cmdOpts.add : (cmdOpts.add ? [cmdOpts.add] : []);
+            const quickIds = Array.isArray(cmdOpts.quick) ? cmdOpts.quick : (cmdOpts.quick ? [cmdOpts.quick] : []);
+            for (const fid of addIds) {
+                const target = await resolveField(fid);
+                if (!target) {
+                    console.error(`字段 ${fid} 在表单 ${objId} 中不存在`);
+                    process.exit(1);
+                }
+                if (addFilter(target, commonFilters, false))
+                    sc.commonSearchType = '0';
+            }
+            for (const fid of quickIds) {
+                const target = await resolveField(fid);
+                if (!target) {
+                    console.error(`字段 ${fid} 在表单 ${objId} 中不存在`);
+                    process.exit(1);
+                }
+                addFilter(target, quickFilters, true);
+            }
+        }
+        if (cmdOpts.remove) {
+            let idx = commonFilters.findIndex((f) => String(f.fieldId || f.id) === String(cmdOpts.remove));
+            if (idx >= 0) {
+                commonFilters.splice(idx, 1);
+            }
+            else {
+                idx = quickFilters.findIndex((f) => String(f.fieldId || f.id) === String(cmdOpts.remove));
+                if (idx >= 0)
+                    quickFilters.splice(idx, 1);
+                else {
+                    console.error(`搜索字段 ${cmdOpts.remove} 不在当前配置中`);
+                    process.exit(1);
+                }
+            }
+        }
+        sc.commonFilters = commonFilters;
+        sc.quickFilters = quickFilters;
+        // 保存前读回真实移动端 mConfig 原样回传，避免把移动端台账搜索配置清空
+        const { mobileConfig, mobilePreserved } = await loadMobileConfig(client, baseUrl, appId, listId, cmdOpts.pcOnly);
+        const saveCfg = { ...cfg, searchConditions: sc };
+        const saveRes = await client.post(`${baseUrl}/api/bs/ebuilder/form/list/saveNListConfig?apid=${appId}`, {
+            listId, appId, terminalType: 'PC', config: saveCfg, mConfig: mobileConfig,
+        });
+        if (saveRes?.code === 200 && saveRes?.status) {
+            console.log(isJson ? JSON.stringify({ success: true, listId }) : '搜索条件已保存');
+            console.log(`  移动端配置: ${mobilePreserved ? '保持原样' : '目标为 PC-only'}`);
+        }
+        else {
+            console.error(`保存失败: ${saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    // ======== list-sort ========
+    form.command('list-sort')
+        .description('查看/配置台账排序')
+        .argument('<objId>', '表单 objId')
+        .argument('<appId>', '应用 ID')
+        .argument('<listId>', '台账列表 ID')
+        .option('--field <fieldIds...>', '排序字段（可多个，按传入顺序多级排序）')
+        .option('--order <ASC|DESC>', '排序方向（对所有 --field 生效）', 'ASC')
+        .option('--clear', '清除排序规则')
+        .option('--pc-only', '目标明确只使用 PC；移动端配置不存在时允许继续')
+        .option('--json', 'JSON 格式输出当前排序')
+        .action(async (objId, appId, listId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const isJson = cmdOpts.json || opts.json;
+        const getRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/list/getNListConfig/${listId}?apid=${appId}&tpaid=${listId}&terminalType=PC`);
+        if (getRes?.code !== 200 || !getRes?.status) {
+            console.error(`查询配置失败: ${getRes?.msg}`);
+            process.exit(1);
+        }
+        const cfg = getRes?.data || {};
+        if (!cmdOpts.field && !cmdOpts.clear) {
+            const order = cfg.order || [];
+            if (isJson) {
+                console.log(JSON.stringify(order, null, 2));
+                return;
+            }
+            if (order.length === 0) {
+                console.log('当前无排序规则');
+                return;
+            }
+            console.log('当前排序:');
+            for (const o of order)
+                console.log(`  ${o.id}  ${o.text || o.name || o.id}  ${o.orderType}`);
+            return;
+        }
+        if (cmdOpts.clear) {
+            cfg.order = [];
+        }
+        else if (cmdOpts.field && cmdOpts.field.length) {
+            const fields = await fetchFields(client, baseUrl, objId);
+            const fieldIds = Array.isArray(cmdOpts.field) ? cmdOpts.field : [cmdOpts.field];
+            const orderType = cmdOpts.order === 'DESC' ? 'DESC' : 'ASC';
+            // 多字段排序：cfg.order 是数组，平台支持多级排序。完整克隆字段对象避免被平台丢弃/重排。
+            cfg.order = fieldIds.map((fid) => {
+                const target = fields.find((f) => String(f.id) === String(fid));
+                if (!target) {
+                    console.error(`字段 ${fid} 在表单 ${objId} 中不存在`);
+                    process.exit(1);
+                }
+                const o = structuredClone(target);
+                o.name = target.name || `field_${target.id}`;
+                o.objId = target.objId || objId;
+                o.orderType = orderType;
+                o.text = target.text;
+                o.mainField = target.isDetailtable ? false : !target.subFormId;
+                return o;
+            });
+        }
+        // 保存前读回真实移动端 mConfig 原样回传，避免把移动端台账排序配置清空
+        const { mobileConfig, mobilePreserved } = await loadMobileConfig(client, baseUrl, appId, listId, cmdOpts.pcOnly);
+        const saveCfg = { ...cfg };
+        const saveRes = await client.post(`${baseUrl}/api/bs/ebuilder/form/list/saveNListConfig?apid=${appId}`, {
+            listId, appId, terminalType: 'PC', config: saveCfg, mConfig: mobileConfig,
+        });
+        if (saveRes?.code === 200 && saveRes?.status) {
+            console.log(isJson ? JSON.stringify({ success: true, listId }) : '排序规则已保存');
+            console.log(`  移动端配置: ${mobilePreserved ? '保持原样' : '目标为 PC-only'}`);
+        }
+        else {
+            console.error(`保存失败: ${saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    registerListStatsCommand(form, program);
+    registerListFilterCommand(form, program);
+    registerListEventCommand(form, program);
+    registerListGroupCommand(form, program);
+    registerListPermissionCommand(form, program);
+    registerListSearchGroupCommand(form, program);
+    // ======== list-data ========
+    form.command('list-data')
+        .description('查询台账数据')
+        .argument('<objId>', '表单 objId')
+        .argument('<appId>', '应用 ID')
+        .argument('<listId>', '台账列表 ID (nListViewId)')
+        .option('--page <n>', '页码', '1')
+        .option('--size <n>', '每页条数', '20')
+        .option('--search <keyword>', '全文搜索关键词')
+        .option('--json', 'JSON 格式输出')
+        .action(async (objId, appId, listId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const isJson = cmdOpts.json || opts.json;
+        // Read tableField config to build field-id → name map for display
+        let labelMap = {};
+        try {
+            const cfgRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/list/getNListConfig/${listId}?apid=${appId}&tpaid=${listId}&terminalType=PC`);
+            if (cfgRes?.code === 200 && cfgRes?.data)
+                labelMap = buildFieldLabelMap(cfgRes.data);
+        }
+        catch { /* proceed without labels */ }
+        const hostPageId = listId;
+        // Get pageAppId
+        const pageInfo = await client.get(`${baseUrl}/api/ebuilder/form/viewdesigner/viewPageInfo?pageId=${hostPageId}&terminalType=PC&entranceType=RUN&runType=`);
+        const pageAppId = pageInfo?.data?.page?.appId || appId;
+        // Get compId from page layout
+        let compId = '';
+        let refPluginPackageId = '933846626099339271';
+        try {
+            const layoutRes = await client.get(`${baseUrl}/api/bs/ebuilder/designer/layout/list?pageId=${hostPageId}&returnCusComp=true`);
+            const layouts = layoutRes?.data || [];
+            const pcLayout = Array.isArray(layouts) ? layouts.find((l) => l.terminalType === 'PC') : null;
+            if (pcLayout?.comps) {
+                const listComp = pcLayout.comps.find((c) => c.component === 'NList' || c.type === 'NList' || (c.config?.ebListId === listId));
+                if (listComp) {
+                    compId = listComp.id || '';
+                    refPluginPackageId = listComp.refPluginPackageId || listComp.config?.refPluginPackageId || refPluginPackageId;
+                }
+            }
+        }
+        catch { /* use defaults */ }
+        if (!compId)
+            compId = hostPageId;
+        const tableuid = uuid32();
+        const pageNo = parseInt(cmdOpts.page || '1', 10);
+        const pageSize = parseInt(cmdOpts.size || '20', 10);
+        const conditionId = `${compId}_filter_EXCLUDECACHE`;
+        const filter = [{
+                conditionComId: conditionId, conditionType: 'and',
+                dataType: 'classification', id: conditionId, useConfig: true,
+            }];
+        if (cmdOpts.search) {
+            filter[0].dataType = 'field';
+            filter[0].filterFields = [{ id: '-1', fieldName: 'search', type: 'text' }];
+            filter[0].funcType = 'like';
+            filter[0].value = cmdOpts.search;
+        }
+        const customConfigObj = { superiorField: { enable: false } };
+        const formData = {
+            pageAppId: String(pageAppId), pageId: String(hostPageId), compId: String(compId),
+            pageNo: String(pageNo), pageSize: String(pageSize), tableuid,
+            filter: JSON.stringify(filter), fieldFilter: '{}',
+            pageFilter: JSON.stringify({ filter: {}, filterIsNull: true, esbFilter: [] }),
+            refPluginPackageId: String(refPluginPackageId),
+            customConfig: encodeCustomConfig(customConfigObj),
+        };
+        const urlEncoded = new URLSearchParams(formData).toString();
+        const data = await client.postForm(`${baseUrl}/api/ebuilder/form/eblist/getData`, urlEncoded);
+        if (data?.code !== 200 || !data?.status) {
+            console.error(`查询失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const list = data?.data?.list || [];
+        let total = list.length;
+        try {
+            const countForm = new URLSearchParams({
+                tableuid, pageId: String(hostPageId), compId: String(compId),
+                refPluginPackageId: String(refPluginPackageId),
+            }).toString();
+            const countRes = await client.postForm(`${baseUrl}/api/ebuilder/form/eblist/getCount?passid=${objId}`, countForm);
+            total = countRes?.data?.total || total;
+        }
+        catch { /* use list length as fallback */ }
+        if (isJson) {
+            console.log(JSON.stringify({ total, pageNo, pageSize, list }, null, 2));
+            return;
+        }
+        console.log(`共 ${total} 条，第 ${pageNo} 页 / 每页 ${pageSize} 条\n`);
+        if (list.length === 0) {
+            console.log('(无数据)');
+            return;
+        }
+        // Build display columns: prefer tableField order, then remaining keys
+        const firstRow = list[0];
+        const rawKeys = Object.keys(firstRow);
+        const used = new Set();
+        // First pass: keys that match tableField IDs or field_xxx patterns
+        const displayCols = [];
+        for (const k of rawKeys) {
+            if (used.has(k))
+                continue;
+            const label = resolveLabel(k, labelMap);
+            // Skip pure-ID system columns that have no labels
+            if (label === k && /^\d+$/.test(k) && k !== 'id')
+                continue;
+            displayCols.push({ key: k, label });
+            used.add(k);
+        }
+        if (displayCols.length === 0) {
+            // Fallback: just show first few keys
+            for (const k of rawKeys.slice(0, 6))
+                displayCols.push({ key: k, label: resolveLabel(k, labelMap) });
+        }
+        // Print header
+        const header = displayCols.map(c => c.label).join('\t');
+        console.log(header);
+        console.log('-'.repeat(Math.min(header.length + 20, 120)));
+        // Print rows
+        for (const row of list) {
+            console.log(displayCols.map(c => String(row[c.key] ?? '')).join('\t'));
+        }
+    });
+}
+//# sourceMappingURL=form-list.js.map