weaver-e10-builder 1.5.11 → 1.5.13

package/dist/commands/form.js

@@ -1,6 +1,7 @@
 import { writeFileSync, existsSync, readFileSync } from 'fs';
 import { AuthSession } from '../core/auth.js';
 import { ApiClient } from '../core/client.js';
+import { parseLayoutJson } from '../services/form-layout-source/json.js';
 import { toColumnName, toTableName, resolveFieldKeys } from '../utils/column-name.js';
 import { createCustomPhysicalForm, applyInitialFieldsToNewForm, placeholderFromFormat, reapplyGroupLayout, queryFormStorageSetting } from '../services/form-create.js';
 import { getRichType, richIdUnits, BROWSER_KINDS } from '../services/rich-types.js';
@@ -22,6 +23,8 @@ import { FIELD_TYPE_CHOICES, canonComponentKey, assertFieldType, normalizeFieldD
 import { listFormTables, readFieldRecords, mapFieldsToTables } from '../services/form-physical-table.js';
 import { buildFormulaParameters, defaultReturnType } from '../services/formula-detail.js';
 import { registerOptionTemplateCommand } from './form-option-template.js';
+import { registerFormObjMetaCommands } from './form-obj-meta.js';
+import { prepareSourceLayoutInputs, restoreSourceLayoutAfterCreate } from '../services/form-layout-source/creation.js';
 /**
  * 字段类型归一 / 校验 / 校验清单已抽到 `services/form-field-validate.ts` ——
  * 「标准建表」与「专项建表」两个入口共用同一份，避免两处真相。
@@ -99,6 +102,7 @@ async function fetchFieldPageRecords(client, baseUrl, appId, formId, subFormId)
 export function registerFormCommands(program) {
     const form = program.command('form').description('表单管理');
     registerOptionTemplateCommand(form, program);
+    registerFormObjMetaCommands(form, program);
     form.command('read')
         .description('读取表单字段结构')
         .argument('<objId>', '表单 objId')
@@ -316,14 +320,18 @@ export function registerFormCommands(program) {
         + 'valueKey 须为数字、省略则平台生成）')
         .option('--menu', '建表后添加台账菜单（默认不加；漏加可用 `e10-cli menu add-table` 补）')
         .option('--layout <type>', '表单布局类型：FLOW(流式)/EXCEL(表格，缺省)。布局类型建表后不可切换', 'EXCEL')
+        .option('--layout-source <json>', 'extract 输出的源证据；搭配 layout-spec 和 layout-artifact-out')
+        .option('--layout-spec <json>', '字段位置描述；字段创建和归组结束后还原源样式')
+        .option('--layout-artifact-out <file>', '保存源布局编译产物及原生前置快照，用于验收和重试')
         .option('--table-name <name>', '自定义数据库表名。平台前缀（如 uf_）由 CLI 自动补，传 uf_xxx 或只传自定义部分都可以；'
         + '须字母开头、只含字母数字下划线。缺省按表单名拼音首字母 + 随机数生成')
         .action(async (appId, name, cmdOpts) => {
+        const sourceLayout = await prepareSourceLayoutInputs(cmdOpts);
         const opts = program.opts();
         const auth = await AuthSession.fromOptions(opts);
         if (!auth)
             process.exit(1);
-        const client = new ApiClient(auth);
+        const client = new ApiClient(auth, 3, sourceLayout ? parseLayoutJson : undefined);
         const baseUrl = auth.getBaseUrl();
         const { randomUUID } = await import('crypto');
         // Fields are required — parse from file (must start with @)
@@ -1736,21 +1744,137 @@ export function registerFormCommands(program) {
         catch (e) {
             console.error(`  显示列兜底失败: ${e.message}（可用 \`e10-cli form table-view ensure ${objId} ${appId}\` 手动补加）`);
         }
+        let layoutRestoration;
+        if (sourceLayout) {
+            try {
+                // 独立单次提交客户端：不能让默认重试把结果未知的布局写入重复发送。
+                layoutRestoration = await restoreSourceLayoutAfterCreate(new ApiClient(auth, 1, parseLayoutJson), baseUrl, { module: 'ebuilderform', formId, objId, appId, routeKind: 'default' }, sourceLayout);
+                if (!layoutRestoration.saved || layoutRestoration.reportWriteError)
+                    process.exitCode = 1;
+            }
+            catch (e) {
+                layoutRestoration = { saved: false, partial: true, error: e.message, artifactOut: sourceLayout.artifactOut };
+                process.exitCode = 1;
+            }
+            console.error(layoutRestoration.saved ? `  源布局结构回读通过，产物: ${sourceLayout.artifactOut}` : `  表单 ${objId} 已创建，源布局还原未通过: ${layoutRestoration.error || '请查看差异报告'}；重试只处理此已有表单`);
+            if (layoutRestoration.reportWriteError)
+                console.error(`  业务保存已回读通过，但报告落盘失败: ${layoutRestoration.reportWriteError}`);
+        }
         if (opts.json) {
-            console.log(JSON.stringify({ objId, name, menuId, skippedSys }));
+            console.log(JSON.stringify({ objId, name, menuId, skippedSys, ...(sourceLayout ? { formId, layoutRestoration } : {}) }));
         }
         else {
             console.log(`完成: ${objId}${skippedSys.length ? `（跳过系统字段重名: ${skippedSys.map((s) => s.name).join('、')}）` : ''}`);
         }
     });
     const linkageCmd = form.command('linkage').description('表单字段显隐联动管理');
+    const linkageBase = '/api/ebuilder/form/form/setting/viewlinkage';
+    async function readLinkage(client, baseUrl, appId, objId, formId, id) {
+        const res = await client.get(`${baseUrl}${linkageBase}/id?${new URLSearchParams({ id, formId, module: 'ebuilderform', apid: appId })}`);
+        if (res?.code !== 200 || !res?.status || !res?.data || String(res.data.id) !== id) {
+            throw new Error(`读取显示属性联动 ${id} 失败: ${res?.msg || '未找到规则'}`);
+        }
+        if (String(res.data.formId) !== formId)
+            throw new Error(`规则 ${id} 不属于表单 ${objId}`);
+        return res.data;
+    }
+    async function readLinkageLayoutTargets(client, baseUrl, appId, objId, formId) {
+        const res = await client.post(`${baseUrl}/api/ebuilder/form/common/browser/complete/form_dataDrivenColumn?apid=${appId}`, {
+            browserMultiple: true, formId, module: 'ebuilderform', groupId: 'layoutComponent',
+            makeComplexField: true, openTab: false, scenarioType: 'VIEW_LINKAGE_TARGET',
+            notComponentKeyList: ['DividingLine', 'ColumnPanel', 'MultiTypeField', 'WPSEditor'],
+            needI18n: true, newly: 1, searchValue: '', customParam: { appId, objId },
+        });
+        if (res?.code !== 200 || !res?.status || !Array.isArray(res?.data?.data)) {
+            throw new Error(`查询布局组件失败: ${res?.msg || '未返回组件列表'}`);
+        }
+        return res.data.data;
+    }
+    async function resolveLayoutActions(client, baseUrl, appId, objId, formId, actions) {
+        if (!actions.some((action) => action.linkageObj === 'layout'))
+            return actions;
+        const targets = await readLinkageLayoutTargets(client, baseUrl, appId, objId, formId);
+        return actions.map((action) => action.linkageObj !== 'layout' ? action : {
+            ...action,
+            fields: action.fields.map((field) => {
+                const target = targets.find((item) => String(item.id) === String(field.id));
+                if (!target)
+                    throw new Error(`布局组件 ${field.id} 不在当前表单的可选列表中`);
+                return target;
+            }),
+        });
+    }
+    function checkLinkageActions(actions) {
+        if (!Array.isArray(actions) || actions.length === 0)
+            throw new Error('至少配置一项联动变更对象 actions[]');
+        const props = {
+            field: ['hide', 'show', 'edit', 'readonly', 'required', 'hideLine', 'hideRow'],
+            option: ['hide', 'disabled'],
+            detail: ['hide', 'show', 'edit', 'readonly', 'hideLine', 'hideRow'],
+            layout: ['hide', 'show', 'hideLine'],
+        };
+        for (const action of actions) {
+            const obj = action.linkageObj || 'field';
+            if (!props[obj])
+                throw new Error(`联动对象 ${obj} 暂无已确认的保存结构；支持 field / option / detail / layout`);
+            if (!props[obj].includes(action.prop))
+                throw new Error(`${obj} 不支持效果 ${action.prop}；可用 ${props[obj].join('/')}`);
+            if (!Array.isArray(action.fields) || !action.fields.length)
+                throw new Error(`${obj} 效果需指定 fields[]`);
+            if (obj === 'layout' && action.fields.some((field) => !field.id)) {
+                throw new Error('布局组件目标需在 fields[] 中提供可选列表返回的 id');
+            }
+            if (obj === 'option' && (!Array.isArray(action.options) || !action.options.length)) {
+                throw new Error('选项目标需指定 options[]（fieldId、optionId、optionName）');
+            }
+            for (const option of action.options || []) {
+                if (!option.fieldId || !option.optionId || !option.optionName) {
+                    throw new Error('options[] 每项需包含 fieldId、optionId、optionName');
+                }
+            }
+        }
+    }
+    async function resolveLinkageFormula(client, baseUrl, appId, objId, formId, config) {
+        if (config.formulaId) {
+            if (!config.formulaName)
+                throw new Error('引用已有公式需同时提供 formulaName');
+            return { id: String(config.formulaId), name: String(config.formulaName) };
+        }
+        if (!config.formula)
+            return undefined;
+        const expression = String(config.formula).trim();
+        const parsed = await buildFormulaParameters(client, baseUrl, objId, appId, formId, expression);
+        if (parsed.errors.length)
+            throw new Error(`公式引用无效: ${parsed.errors.join('; ')}`);
+        for (const warning of parsed.warnings)
+            console.error(`  ⚠ ${warning}`);
+        const name = String(config.formulaName || `显示属性联动公式_${Date.now()}`);
+        const res = await client.post(`${baseUrl}/api/excel/formula/save`, {
+            expressSql: parsed.normalizedExpression, name, parameters: parsed.parameters,
+            returnType: 'Boolean', validateType: 'normal', referenceType: 'check',
+            extendParam: JSON.stringify({ isFormViewLinkage: true }), formulaId: null,
+            dataSources: [], formulaType: 'normal', mainDataSource: [null],
+            tempVariableList: [], nameAuto: false, module: 'ebuilderform', multiFuncSepType: 1,
+        });
+        if (res?.returnInfo?.state === 'VERIFY_REQUIRED' || res?.securityCheckResult === false) {
+            throw new Error('公式保存需要二次验证，联动规则尚未保存；请完成平台验证后再试');
+        }
+        if (!res?.resultJson?.excute || !res?.resultJson?.id || res?.resultJson?.returnType !== 'Boolean') {
+            throw new Error(`布尔公式保存失败: ${res?.resultJson?.error || res?.msg || '未返回有效 Boolean 公式'}`);
+        }
+        console.error(`  布尔公式已保存: ${res.resultJson.id}（若后续联动保存失败，请用 formulaId/formulaName 复用）`);
+        return { id: String(res.resultJson.id), name };
+    }
     linkageCmd.command('add')
         .description('添加字段显隐联动规则')
         .argument('<appId>', '应用 ID')
         .argument('<objId>', '表单 objId')
         .argument('<name>', '联动规则名称')
         .requiredOption('--config <json>', '联动配置 JSON（@文件路径），格式见文档')
+        .option('--disabled', '新建时停用（默认启用）')
         .action(async (appId, objId, name, cmdOpts) => {
+        if (name.length > 200)
+            throw new Error('联动名称不能超过 200 字');
         const opts = program.opts();
         const auth = await AuthSession.fromOptions(opts);
         if (!auth)
@@ -1766,23 +1890,15 @@ export function registerFormCommands(program) {
             console.error(e.message);
             process.exit(1);
         }
-        // 校验联动 prop：必填且平台支持 hide/show/edit/readonly/required/hideLine（隐藏行，抓包实测平台枚举是 hideLine；
-        // hideRow 保留兼容旧写法）
-        const SUPPORTED_PROPS = ['hide', 'show', 'edit', 'readonly', 'required', 'hideLine', 'hideRow'];
-        const missingProps = (config.actions || []).filter((a) => !a.prop);
-        const invalidProps = (config.actions || [])
-            .filter((a) => a.prop)
-            .map((a) => a.prop)
-            .filter((p) => !SUPPORTED_PROPS.includes(String(p)));
-        if (missingProps.length > 0 || invalidProps.length > 0) {
-            if (missingProps.length > 0) {
-                console.error(`联动 action 缺少 prop（联动效果类型必填）`);
-            }
-            if (invalidProps.length > 0) {
-                console.error(`联动 prop 不支持: ${[...new Set(invalidProps)].join(', ')}`);
-                console.error(`  平台支持: ${SUPPORTED_PROPS.join(', ')}`);
-            }
-            process.exit(1);
+        checkLinkageActions(config.actions || []);
+        if (config.conditions !== undefined && (config.formula || config.formulaId)) {
+            throw new Error('简易条件 conditions 与函数条件 formula/formulaId 不能同时指定');
+        }
+        if (!config.formula && !config.formulaId && !Array.isArray(config.conditions)) {
+            throw new Error('请提供 conditions[] 或 Boolean 公式');
+        }
+        if (Array.isArray(config.conditions) && config.conditions.length === 0) {
+            throw new Error('简易条件 conditions[] 至少包含一项');
         }
         // Get formId from appId
         const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
@@ -1796,27 +1912,231 @@ export function registerFormCommands(program) {
         // 不看设计器实际报文就想不到的约束。
         const formName = formInfo?.formName || formInfo?.objName || '表单';
         const effect = await resolveEffect(client, baseUrl, formId, formName, config.effect);
+        const formula = await resolveLinkageFormula(client, baseUrl, appId, objId, formId, config);
+        const actions = await resolveLayoutActions(client, baseUrl, appId, objId, formId, config.actions || []);
         const { payload, warnings } = buildLinkageAddPayload({
             appId, objId, formId, formName, name,
             conditions: config.conditions || [],
             detailType: config.detailType,
-            actions: config.actions || [],
-            effect,
+            actions,
+            effect, formula, enableState: cmdOpts.disabled ? '0' : '1',
         });
         for (const w of warnings)
             console.error(`  ⚠ ${w}`);
         const data = await addLinkage(client, baseUrl, appId, formId, payload);
         if (data?.code === 200 && data?.status) {
-            const linkageId = data?.data || '';
+            // add 的 data 在部分环境是成功标记 1，并非规则 ID；从列表按名称回查唯一记录。
+            const listed = await client.post(`${baseUrl}${linkageBase}/queryByPages?apid=${appId}`, {
+                formId, module: 'ebuilderform', linkageTypeList: ['template', 'sql'],
+                customParam: { appId, objId }, pageNo: 1, pageSize: 50,
+            }, { ebbusinessid: appId });
+            const matches = listed?.code === 200 && listed?.status
+                ? (listed?.data?.result || []).filter((item) => item.linkageName === name) : [];
+            const linkageId = matches.length === 1 ? String(matches[0].id) : '';
             console.log(opts.json
                 ? JSON.stringify({ success: true, linkageId, name })
-                : `联动规则已添加: ${name}` + (linkageId ? ` (id: ${linkageId})` : ''));
+                : `联动规则已添加: ${name}` + (linkageId ? ` (id: ${linkageId})` : '；请用 linkage list 核对 ID'));
         }
         else {
             console.error(`添加失败: ${data?.msg || '未知错误'}`);
             process.exit(1);
         }
     });
+    linkageCmd.command('get')
+        .description('读取单条显示属性联动规则详情')
+        .argument('<appId>').argument('<objId>').argument('<id>')
+        .action(async (appId, objId, id) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const form = await resolveFormRecord(client, auth.getBaseUrl(), appId, objId);
+            const formId = String(form?.formId || '');
+            if (!formId)
+                throw new Error('无法获取 formId');
+            const record = await readLinkage(client, auth.getBaseUrl(), appId, objId, formId, id);
+            console.log(opts.json ? JSON.stringify(record, null, 2)
+                : `${record.linkageName} (${id}) ${record.enableState === '1' ? '启用' : '停用'}；条件=${record.condition?.conditionType || '未知'}；目标=${(record.linkageDetails || []).length} 项`);
+        }
+        catch (e) {
+            console.error(`读取显示属性联动失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    linkageCmd.command('layout-targets')
+        .description('查询当前表单可作为显示属性联动目标的布局组件')
+        .argument('<appId>').argument('<objId>')
+        .action(async (appId, objId) => {
+        try {
+            const auth = await AuthSession.fromOptions(program.opts());
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const form = await resolveFormRecord(client, baseUrl, appId, objId);
+            const formId = String(form?.formId || '');
+            if (!formId)
+                throw new Error('无法获取 formId');
+            const targets = await readLinkageLayoutTargets(client, baseUrl, appId, objId, formId);
+            console.log(JSON.stringify(targets, null, 2));
+        }
+        catch (e) {
+            console.error(`查询布局联动目标失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    linkageCmd.command('state')
+        .description('启用或停用显示属性联动规则')
+        .argument('<appId>').argument('<objId>').argument('<id>')
+        .requiredOption('--set <on|off>', 'on=启用，off=停用')
+        .action(async (appId, objId, id, cmdOpts) => {
+        try {
+            const state = cmdOpts.set === 'on' ? '1' : cmdOpts.set === 'off' ? '0' : '';
+            if (!state)
+                throw new Error('--set 只能为 on 或 off');
+            const auth = await AuthSession.fromOptions(program.opts());
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const form = await resolveFormRecord(client, baseUrl, appId, objId);
+            const formId = String(form?.formId || '');
+            if (!formId)
+                throw new Error('无法获取 formId');
+            await readLinkage(client, baseUrl, appId, objId, formId, id);
+            const res = await client.post(`${baseUrl}${linkageBase}/updateEnableStateByEntity?apid=${appId}`, { formId, id, enableState: state, customParam: { appId, objId } }, { ebbusinessid: formId });
+            if (res?.code !== 200 || !res?.status)
+                throw new Error(res?.msg || '保存失败');
+            const saved = await readLinkage(client, baseUrl, appId, objId, formId, id);
+            if (String(saved.enableState) !== state)
+                throw new Error('启停状态保存后读回不一致');
+            console.log(`显示属性联动已${state === '1' ? '启用' : '停用'}: ${saved.linkageName} (${id})`);
+        }
+        catch (e) {
+            console.error(`切换显示属性联动失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    linkageCmd.command('update')
+        .description('读取并修改已有显示属性联动；未指定内容保持原样')
+        .argument('<appId>').argument('<objId>').argument('<id>')
+        .option('--name <text>', '新名称')
+        .option('--config <json>', '需替换的条件、目标或生效范围 JSON（@文件或内联）')
+        .action(async (appId, objId, id, cmdOpts) => {
+        try {
+            if (!cmdOpts.name && !cmdOpts.config)
+                throw new Error('至少提供 --name 或 --config');
+            if (cmdOpts.name && cmdOpts.name.length > 200)
+                throw new Error('联动名称不能超过 200 字');
+            const auth = await AuthSession.fromOptions(program.opts());
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const form = await resolveFormRecord(client, baseUrl, appId, objId);
+            const formId = String(form?.formId || '');
+            if (!formId)
+                throw new Error('无法获取 formId');
+            const old = await readLinkage(client, baseUrl, appId, objId, formId, id);
+            // 详情响应还含展示/统计字段；更新接口只接收设计器提交的规则主体。
+            const payload = JSON.parse(JSON.stringify({
+                fdEffect: old.fdEffect, condition: old.condition, linkageDetails: old.linkageDetails,
+                module: 'ebuilderform', formId, refId: formId, id,
+                enableState: old.enableState, linkageName: old.linkageName,
+                customParam: { appId, objId },
+            }));
+            const config = cmdOpts.config ? readLinkageConfig(cmdOpts.config) : {};
+            if (config.actions !== undefined)
+                checkLinkageActions(config.actions);
+            if (config.conditions !== undefined && (config.formula || config.formulaId)) {
+                throw new Error('简易条件 conditions 与函数条件 formula/formulaId 不能同时指定');
+            }
+            if (config.conditions !== undefined && (!Array.isArray(config.conditions) || config.conditions.length === 0)) {
+                throw new Error('简易条件 conditions[] 至少包含一项');
+            }
+            const formula = config.formula || config.formulaId
+                ? await resolveLinkageFormula(client, baseUrl, appId, objId, formId, config) : undefined;
+            const actions = config.actions === undefined ? []
+                : await resolveLayoutActions(client, baseUrl, appId, objId, formId, config.actions);
+            const generated = buildLinkageAddPayload({
+                appId, objId, formId, formName: String(form?.formName || form?.objName || '表单'),
+                name: cmdOpts.name || old.linkageName, conditions: config.conditions || [],
+                actions, detailType: config.detailType, formula,
+            });
+            for (const warning of generated.warnings)
+                console.error(`  ⚠ ${warning}`);
+            if (cmdOpts.name)
+                payload.linkageName = cmdOpts.name;
+            if (config.effect !== undefined)
+                payload.fdEffect = await resolveEffect(client, baseUrl, formId, String(form?.formName || form?.objName || '表单'), config.effect).then((effect) => ({
+                    ...generated.payload.fdEffect, effectType: effect.effectType, effectName: effect.effectName,
+                    optionList: [{ effectValue: effect.effectValue, effectName: effect.optionName || effect.effectName }],
+                }));
+            if (config.conditions !== undefined || formula) {
+                payload.condition = { ...old.condition, ...generated.payload.condition };
+            }
+            else if (config.detailType !== undefined) {
+                payload.condition.detailType = config.detailType;
+            }
+            if (config.actions !== undefined)
+                payload.linkageDetails = generated.payload.linkageDetails;
+            payload.id = id;
+            payload.formId = formId;
+            payload.refId = formId;
+            payload.module = 'ebuilderform';
+            payload.customParam = { appId, objId };
+            const res = await client.post(`${baseUrl}${linkageBase}/update?apid=${appId}`, payload, { ebbusinessid: formId });
+            if (res?.code !== 200 || !res?.status)
+                throw new Error(res?.msg || '保存失败');
+            const saved = await readLinkage(client, baseUrl, appId, objId, formId, id);
+            if (cmdOpts.name && saved.linkageName !== cmdOpts.name)
+                throw new Error('规则名称保存后读回不一致');
+            if (formula && String(saved.condition?.formulaId || '') !== formula.id)
+                throw new Error('函数条件保存后读回不一致');
+            if (config.detailType && saved.condition?.detailType !== config.detailType)
+                throw new Error('条件关系保存后读回不一致');
+            if (config.actions && (saved.linkageDetails || []).length !== config.actions.length)
+                throw new Error('变更对象数量保存后读回不一致');
+            console.log(`显示属性联动已修改: ${saved.linkageName} (${id})`);
+        }
+        catch (e) {
+            console.error(`修改显示属性联动失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    linkageCmd.command('delete')
+        .description('删除当前表单的一条显示属性联动规则')
+        .argument('<appId>').argument('<objId>').argument('<id>')
+        .action(async (appId, objId, id) => {
+        try {
+            const auth = await AuthSession.fromOptions(program.opts());
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const form = await resolveFormRecord(client, baseUrl, appId, objId);
+            const formId = String(form?.formId || '');
+            if (!formId)
+                throw new Error('无法获取 formId');
+            await readLinkage(client, baseUrl, appId, objId, formId, id);
+            const query = new URLSearchParams({ ids: id, formId, module: 'ebuilderform', apid: appId });
+            const res = await client.get(`${baseUrl}${linkageBase}/deleteByIds?${query}`);
+            if (res?.code !== 200 || !res?.status || res?.data === 0)
+                throw new Error(res?.msg || '删除失败');
+            const check = await client.get(`${baseUrl}${linkageBase}/id?${new URLSearchParams({ id, formId, module: 'ebuilderform', apid: appId })}`);
+            if (check?.code === 200 && check?.status && String(check?.data?.id || '') === id
+                && check.data.deleteType !== '1' && check.data.deleteType !== 1 && check.data.deleteType !== true) {
+                throw new Error(`规则 ${id} 删除后仍可读到，请核查`);
+            }
+            console.log(`显示属性联动规则已删除: ${id}`);
+        }
+        catch (e) {
+            console.error(`删除显示属性联动失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
     linkageCmd.command('list')
         .description('查看显隐联动规则列表（回读条件/动作/启用状态）')
         .argument('<appId>', '应用 ID')
@@ -1841,19 +2161,31 @@ export function registerFormCommands(program) {
             formId, module: 'ebuilderform', linkageTypeList: ['template', 'sql'],
             customParam: { appId, objId }, pageNo: 1, pageSize: 50,
         };
-        if (cmdOpts.keyword)
-            body.keyword = cmdOpts.keyword;
         const res = await client.post(`${baseUrl}/api/ebuilder/form/form/setting/viewlinkage/queryByPages?apid=${appId}`, body, { ebbusinessid: appId });
         if (res?.code !== 200 || !res?.status) {
             console.error(`查询失败: ${res?.msg || '未知错误'}`);
             process.exit(1);
         }
-        const list = res?.data?.result || [];
+        // 该接口的 keyword 不是字符串 DTO，直接传文本会触发反序列化错误；按名称在读回结果中过滤。
+        let list = res?.data?.result || [];
+        if (cmdOpts.keyword) {
+            const total = Number(res?.data?.totalCount || list.length);
+            for (let pageNo = 2; pageNo <= Math.ceil(total / body.pageSize); pageNo++) {
+                const page = await client.post(`${baseUrl}${linkageBase}/queryByPages?apid=${appId}`, { ...body, pageNo }, { ebbusinessid: appId });
+                if (page?.code !== 200 || !page?.status) {
+                    console.error(`第 ${pageNo} 页查询失败: ${page?.msg || '未知错误'}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                list = list.concat(page?.data?.result || []);
+            }
+            list = list.filter((item) => String(item.linkageName || '').includes(cmdOpts.keyword));
+        }
         if (opts.json) {
             console.log(JSON.stringify(list, null, 2));
         }
         else {
-            console.log(`共 ${res?.data?.totalCount ?? list.length} 条联动规则:`);
+            console.log(`共 ${cmdOpts.keyword ? list.length : (res?.data?.totalCount ?? list.length)} 条联动规则:`);
             for (const x of list) {
                 const en = x.enableState === '1' ? '启用' : '停用';
                 console.log(`  [${x.id}] ${x.linkageName} (${en})`);