lan-low-code-cli 2.4.0 → 2.6.0

package/dist/commands/operation.js

@@ -0,0 +1,730 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerOperationCommand = registerOperationCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const operation_1 = require("../api/operation");
+const view_1 = require("../api/view");
+const client_1 = require("../client");
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+function createClient(opts) {
+    return new client_1.LcodeClient((0, config_1.resolveRuntime)({ baseUrl: opts.baseUrl, token: opts.token }));
+}
+const KIND_ALIAS = {
+    link: 'link',
+    url: 'link',
+    script: 'script',
+    js: 'script',
+    dialog: 'dialog',
+    modal: 'dialog',
+};
+const KIND_META = {
+    link: { fdType: 2, fdViewType: 4, label: '打开链接' },
+    script: { fdType: 3, fdViewType: 5, label: '执行脚本' },
+    dialog: { fdType: 3, fdViewType: 1, label: '执行业务操作（对话框）' },
+};
+/** 解析 fdConfig（后端实体不一定有顶层 fdViewType，视图类型存在 fdConfig 中） */
+function readOperationConfig(op) {
+    if (!op.fdConfig)
+        return {};
+    try {
+        const parsed = typeof op.fdConfig === 'string' ? JSON.parse(op.fdConfig) : op.fdConfig;
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function operationTypeLabel(op) {
+    if (op.fdType === 1)
+        return '内置';
+    if (op.fdType === 4)
+        return '对话框';
+    if (op.fdType === 6)
+        return 'AI 能力';
+    const viewType = Number(readOperationConfig(op).fdViewType ?? op.fdViewType);
+    if (op.fdType === 3)
+        return viewType === 5 ? '脚本' : '无视图';
+    return '有视图';
+}
+function positionLabel(position) {
+    if (position === 2)
+        return '查看视图';
+    if (position === 3)
+        return '新建/编辑视图';
+    return '列表视图';
+}
+/** `@file` 读取文件内容，其余按字面量返回 */
+function readScriptValue(input) {
+    if (!input.startsWith('@'))
+        return input;
+    const file = (0, path_1.isAbsolute)(input.slice(1)) ? input.slice(1) : (0, path_1.resolve)(process.cwd(), input.slice(1));
+    if (!(0, fs_1.existsSync)(file))
+        throw new Error(`脚本文件不存在：${file}`);
+    return (0, fs_1.readFileSync)(file, 'utf8');
+}
+const TARGET_LABEL = { list: '列表视图', view: '查看视图' };
+const ATTACH_POSITIONS = ['top', 'rightHand', 'rightSide'];
+function toObject(input) {
+    if (!input)
+        return {};
+    if (typeof input === 'object')
+        return input;
+    try {
+        const parsed = JSON.parse(String(input));
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function platformConfig(config, platform) {
+    const current = config[platform];
+    if (current && typeof current === 'object')
+        return current;
+    const next = {};
+    config[platform] = next;
+    return next;
+}
+function readViewConfig(vo, target) {
+    if (target === 'list')
+        return toObject(vo.fdExtendConfig);
+    const view = vo;
+    return view.fdConfigVO
+        ? view.fdConfigVO
+        : toObject(view.fdConfig);
+}
+async function saveViewConfig(client, target, vo, config, formId) {
+    if (target === 'list') {
+        await view_1.listViewApi.update(client, { ...vo, fdExtendConfig: JSON.stringify(config) });
+        return;
+    }
+    const { fdConfigVO: _ignored, ...rest } = vo;
+    await view_1.formViewApi.update(client, {
+        ...rest,
+        fdXForm: vo.fdXForm ?? { fdId: formId },
+        fdConfig: JSON.stringify(config),
+    });
+}
+function assertSameForm(actual, expected, label) {
+    if (actual && actual !== expected) {
+        throw new Error(`${label}不属于该表单（表单 ${actual}，期望 ${expected}）`);
+    }
+}
+async function loadListView(client, formId, viewId) {
+    if (viewId) {
+        const vo = await view_1.listViewApi.get(client, viewId);
+        if (!vo?.fdId)
+            throw new Error(`列表视图不存在：${viewId}`);
+        assertSameForm(vo.fdXForm?.fdId, formId, '列表视图');
+        return vo;
+    }
+    const res = await view_1.listViewApi.list(client, {
+        conditions: { fdXForm: formId },
+        pageNo: 1,
+        pageSize: 50,
+        columns: ['fdId', 'fdName'],
+    });
+    const views = res?.content ?? [];
+    if (!views.length)
+        throw new Error('该表单没有列表视图');
+    if (views.length > 1) {
+        const names = views.map((v, i) => `  ${i + 1}. ${v.fdId}  ${v.fdName ?? ''}`).join('\n');
+        throw new Error(`该表单有 ${views.length} 个列表视图，请用 --view-id 指定：\n${names}`);
+    }
+    return view_1.listViewApi.get(client, views[0].fdId);
+}
+async function loadFormView(client, formId, viewId) {
+    if (viewId) {
+        const vo = await view_1.formViewApi.get(client, viewId);
+        if (!vo?.fdId)
+            throw new Error(`查看视图不存在：${viewId}`);
+        assertSameForm(vo.fdXForm?.fdId, formId, '查看视图');
+        return vo;
+    }
+    let res = await view_1.formViewApi.list(client, {
+        conditions: { 'fdXForm.fdId': formId },
+        pageNo: 1,
+        pageSize: 50,
+        columns: ['fdId', 'fdName'],
+    });
+    if (!res?.content?.length) {
+        res = await view_1.formViewApi.list(client, {
+            conditions: { fdXForm: formId },
+            pageNo: 1,
+            pageSize: 50,
+            columns: ['fdId', 'fdName'],
+        });
+    }
+    const views = res?.content ?? [];
+    if (!views.length)
+        throw new Error('该表单没有查看视图');
+    if (views.length > 1) {
+        const names = views.map((v, i) => `  ${i + 1}. ${v.fdId}  ${v.fdName ?? ''}`).join('\n');
+        throw new Error(`该表单有 ${views.length} 个查看视图，请用 --view-id 指定：\n${names}`);
+    }
+    return view_1.formViewApi.get(client, views[0].fdId);
+}
+function normalizePlatform(input) {
+    const value = String(input ?? 'desktop').trim().toLowerCase();
+    if (value !== 'desktop' && value !== 'mobile') {
+        throw new Error(`未知 --platform：${input}（可选 desktop | mobile）`);
+    }
+    return value;
+}
+function upsertOperationItem(list, opId, position, extra = {}) {
+    const index = list.findIndex((item) => item.id === opId);
+    if (index < 0) {
+        list.push({ id: opId, position, ...extra });
+        return 'added';
+    }
+    if (list[index].position === position)
+        return 'unchanged';
+    list[index] = { ...list[index], position };
+    return 'updated';
+}
+/** 查看视图的 operationList 项带有展示条件等字段，补全可减少运行时差异 */
+function operationItemExtra(op) {
+    return {
+        fdId: op.fdId,
+        fdName: op.fdName,
+        name: op.fdName,
+        code: op.fdType === 1 ? op.fdCode : op.fdUniqueCode || op.fdCode,
+        fdType: op.fdType,
+        fdPosition: op.fdPosition,
+        logic: 'none',
+        ...(op.isModal ? { isModal: true } : {}),
+    };
+}
+function assertOperationName(name) {
+    if (!name)
+        throw new Error('--name 不能为空');
+    if (name.length > 30)
+        throw new Error('--name 最长 30 个字符');
+}
+function assertOperationCode(code) {
+    if (!code)
+        throw new Error('--code 不能为空（自定义操作编码，最长 15）');
+    if (code.length > 15)
+        throw new Error('--code 最长 15 个字符');
+    if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(code)) {
+        throw new Error('--code 需以字母开头，仅允许字母、数字、下划线、连字符');
+    }
+}
+/** 从已有操作推导类型（fdType=2 为链接；fdType=3 + fdViewType=5 为脚本，其余按对话框） */
+function detectKind(op) {
+    if (op.fdType === 2)
+        return 'link';
+    const viewType = Number(readOperationConfig(op).fdViewType ?? op.fdViewType);
+    return op.fdType === 3 && viewType === 5 ? 'script' : 'dialog';
+}
+function buildCreatePayload(opts) {
+    const formId = String(opts.formId ?? '').trim();
+    const name = String(opts.name ?? '').trim();
+    const code = String(opts.code ?? '').trim();
+    const rawKind = String(opts.type ?? '').trim().toLowerCase();
+    const kind = KIND_ALIAS[rawKind];
+    const positionRaw = String(opts.position ?? 'list').trim().toLowerCase();
+    const fdPosition = positionRaw === 'view' ? 2 : positionRaw === 'list' ? 1 : 0;
+    if (!formId)
+        throw new Error('--form-id 不能为空');
+    assertOperationName(name);
+    assertOperationCode(code);
+    if (!kind)
+        throw new Error(`未知 --type：${opts.type}（可选 link | script | dialog）`);
+    if (!fdPosition)
+        throw new Error(`未知 --position：${opts.position}（可选 list | view）`);
+    const desc = opts.desc === undefined ? '' : String(opts.desc);
+    if (desc.length > 500)
+        throw new Error('--desc 最长 500 个字符');
+    const meta = KIND_META[kind];
+    const config = {
+        authFieldList: [],
+        createInitDataFieldList: [],
+        listViewInitDataFieldList: [],
+        fdViewFormModel: { fdId: '', fdName: '' },
+        fdViewModel: { fdId: '', fdName: '', fdModelName: '' },
+        fdViewType: meta.fdViewType,
+        fdIdField: null,
+        // 「勾选数据」：仅列表视图的自定义操作可配置；默认不要求勾选
+        fdListViewIdValid: fdPosition === 1 && opts.needSelect === true,
+    };
+    if (kind === 'link') {
+        const url = String(opts.url ?? '').trim();
+        if (!url)
+            throw new Error('--type link 需指定 --url');
+        // 勾选数据时，链接按接口调用（与平台弹窗的推导一致）
+        config.fdUrlType = config.fdListViewIdValid ? '2' : '1';
+        config.fdLinkAddress = url;
+    }
+    else if (kind === 'script') {
+        const script = String(opts.script ?? '');
+        if (!script.trim())
+            throw new Error('--type script 需指定 --script <代码|@文件>');
+        config.fdJavaScript = readScriptValue(script);
+    }
+    else {
+        const dialogId = String(opts.dialogId ?? '').trim();
+        if (!dialogId)
+            throw new Error('--type dialog 需指定 --dialog-id');
+        config.fdModal = { fdId: dialogId };
+        config.fdModalType = 1;
+        config.fdModalSizeType = 2;
+        config.fdModalDetail = { modalId: dialogId };
+    }
+    const payload = {
+        fdName: name,
+        fdUniqueCode: code,
+        fdDesc: desc,
+        fdType: meta.fdType,
+        fdPosition,
+        fdXForm: { fdId: formId },
+        fdConfig: JSON.stringify(config),
+    };
+    if (opts.mobileIcon)
+        payload.fdMobileIcon = String(opts.mobileIcon);
+    if (kind === 'dialog')
+        payload.isModal = true;
+    return { payload, kind };
+}
+/**
+ * 基于现有操作构造 update 请求体。
+ * 显式切换类型（--type）时会重建 fdConfig 的类型相关字段，
+ * 但保留权限、默认值等与类型无关的配置。
+ */
+function buildUpdatePayload(current, opts) {
+    if (current.fdType !== 2 && current.fdType !== 3) {
+        throw new Error(`该操作类型为「${operationTypeLabel(current)}」，仅支持修改自定义的链接 / 脚本 / 对话框操作`);
+    }
+    const currentKind = detectKind(current);
+    const rawKind = String(opts.type ?? '').trim().toLowerCase();
+    let kind = currentKind;
+    if (rawKind) {
+        const resolved = KIND_ALIAS[rawKind];
+        if (!resolved)
+            throw new Error(`未知 --type：${opts.type}（可选 link | script | dialog）`);
+        kind = resolved;
+    }
+    else {
+        // 未指定 --type 时，不允许通过其它类型的参数隐式换类型
+        const conflicts = [
+            [opts.script !== undefined, 'script'],
+            [opts.url !== undefined, 'link'],
+            [opts.dialogId !== undefined, 'dialog'],
+        ];
+        conflicts.forEach(([given, expected]) => {
+            if (given && expected !== currentKind) {
+                throw new Error(`该操作当前是「${KIND_META[currentKind].label}」，改成「${KIND_META[expected].label}」请加 --type ${expected}`);
+            }
+        });
+    }
+    const oldConfig = readOperationConfig(current);
+    const switching = kind !== currentKind;
+    const config = switching
+        ? {
+            authFieldList: oldConfig.authFieldList ?? [],
+            createInitDataFieldList: oldConfig.createInitDataFieldList ?? [],
+            listViewInitDataFieldList: oldConfig.listViewInitDataFieldList ?? [],
+            fdViewFormModel: oldConfig.fdViewFormModel ?? { fdId: '', fdName: '' },
+            fdViewModel: oldConfig.fdViewModel ?? { fdId: '', fdName: '', fdModelName: '' },
+            fdViewType: KIND_META[kind].fdViewType,
+            fdIdField: null,
+            fdListViewIdValid: oldConfig.fdListViewIdValid === true,
+        }
+        : { ...oldConfig };
+    if (config.fdViewType === undefined)
+        config.fdViewType = KIND_META[kind].fdViewType;
+    const needSelect = opts.needSelect;
+    if (needSelect !== undefined)
+        config.fdListViewIdValid = needSelect;
+    if (kind === 'link') {
+        const url = opts.url !== undefined ? String(opts.url).trim() : String(config.fdLinkAddress ?? '');
+        if (!url)
+            throw new Error('链接操作需指定 --url');
+        config.fdUrlType = config.fdListViewIdValid === true ? '2' : '1';
+        config.fdLinkAddress = url;
+    }
+    else if (kind === 'script') {
+        const script = opts.script !== undefined
+            ? readScriptValue(String(opts.script))
+            : String(config.fdJavaScript ?? '');
+        if (!script.trim())
+            throw new Error('脚本操作需指定 --script <代码|@文件>');
+        config.fdJavaScript = script;
+    }
+    else {
+        const dialogId = opts.dialogId !== undefined
+            ? String(opts.dialogId).trim()
+            : String(config.fdModal?.fdId ?? '');
+        if (!dialogId)
+            throw new Error('对话框操作需指定 --dialog-id');
+        config.fdModal = { fdId: dialogId };
+        config.fdModalType = 1;
+        config.fdModalSizeType = 2;
+        config.fdModalDetail = { modalId: dialogId };
+    }
+    const name = opts.name !== undefined ? String(opts.name).trim() : current.fdName;
+    assertOperationName(name);
+    const code = opts.code !== undefined
+        ? String(opts.code).trim()
+        : String(current.fdUniqueCode || current.fdCode || '');
+    if (opts.code !== undefined)
+        assertOperationCode(code);
+    let fdPosition = current.fdPosition;
+    if (opts.position !== undefined) {
+        const positionRaw = String(opts.position).trim().toLowerCase();
+        if (positionRaw !== 'list' && positionRaw !== 'view') {
+            throw new Error(`未知 --position：${opts.position}（可选 list | view）`);
+        }
+        fdPosition = positionRaw === 'view' ? 2 : 1;
+    }
+    const desc = opts.desc !== undefined ? String(opts.desc) : String(current.fdDesc ?? '');
+    if (desc.length > 500)
+        throw new Error('--desc 最长 500 个字符');
+    const payload = {
+        ...current,
+        fdName: name,
+        fdUniqueCode: code,
+        fdDesc: desc,
+        fdType: KIND_META[kind].fdType,
+        fdPosition,
+        fdConfig: JSON.stringify(config),
+    };
+    // 只读视图字段，回传可能导致更新失败
+    delete payload.fdConfigVO;
+    if (kind === 'dialog')
+        payload.isModal = true;
+    else
+        delete payload.isModal;
+    if (opts.mobileIcon !== undefined)
+        payload.fdMobileIcon = String(opts.mobileIcon);
+    if (opts.enable === true)
+        payload.fdEnabled = true;
+    if (opts.disable === true)
+        payload.fdEnabled = false;
+    return { payload, kind };
+}
+function registerOperationCommand(program) {
+    const operation = program
+        .command('operation')
+        .description('表单业务操作（列表页/查看页按钮）：list | get | create | update | delete | attach | detach');
+    // ------------------------------------------------------------------ list
+    operation
+        .command('list')
+        .description('列出表单的业务操作')
+        .requiredOption('--form-id <fdId>', '表单 id')
+        .option('--keyword <keyword>', '按名称模糊搜索')
+        .option('--page-no <n>', '页码', (v) => Number(v), 1)
+        .option('--page-size <n>', '每页数量', (v) => Number(v), 100)
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const formId = String(opts.formId ?? '').trim();
+        if (!formId)
+            throw new Error('表单 id 不能为空');
+        const client = createClient(opts);
+        const conditions = { fdXForm: formId };
+        if (opts.keyword)
+            conditions.fdName = { $contains: String(opts.keyword).trim() };
+        const result = await operation_1.operationApi.list(client, {
+            pageNo: opts.pageNo,
+            pageSize: opts.pageSize,
+            conditions,
+            fdXFormId: formId,
+            sorts: { fdCreateTime: 'desc' },
+            // 仅请求平台实体确认存在的列（fdViewType 在 fdConfig 内，不是顶层字段）
+            columns: [
+                'fdId',
+                'fdName',
+                'fdCode',
+                'fdUniqueCode',
+                'fdType',
+                'fdPosition',
+                'fdConfig',
+                'fdEnabled',
+                'fdMobileIcon',
+                'fdDesc',
+                'fdCreateTime',
+            ],
+        });
+        const content = result?.content ?? [];
+        if (opts.json) {
+            logger_1.logger.json(result);
+            return;
+        }
+        logger_1.logger.table(content.map((item) => ({
+            fdId: item.fdId,
+            名称: item.fdName ?? '',
+            // 自定义操作的 fdCode 统一为 other，真正的编码在 fdUniqueCode
+            编码: (item.fdType === 1 ? item.fdCode : item.fdUniqueCode || item.fdCode) || '',
+            类型: operationTypeLabel(item),
+            位置: positionLabel(item.fdPosition),
+            状态: item.fdEnabled === false ? '未启用' : '启用',
+        })));
+        logger_1.logger.info(logger_1.color.gray(`共 ${content.length} 条`));
+    });
+    // ------------------------------------------------------------------- get
+    operation
+        .command('get')
+        .description('查看业务操作详情（含 fdConfig）')
+        .requiredOption('--id <fdId>', '业务操作 id')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const fdId = String(opts.id ?? '').trim();
+        if (!fdId)
+            throw new Error('业务操作 id 不能为空');
+        const client = createClient(opts);
+        const vo = await operation_1.operationApi.get(client, fdId);
+        if (opts.json) {
+            logger_1.logger.json(vo);
+            return;
+        }
+        const displayCode = vo.fdType === 1 ? vo.fdCode : vo.fdUniqueCode || vo.fdCode;
+        logger_1.logger.title(`\n${vo.fdName}  (${displayCode || vo.fdId})`);
+        logger_1.logger.info(`  fdId     ${vo.fdId}`);
+        logger_1.logger.info(`  类型     ${operationTypeLabel(vo)}`);
+        logger_1.logger.info(`  位置     ${positionLabel(vo.fdPosition)}`);
+        logger_1.logger.info(`  视图类型 ${String(readOperationConfig(vo).fdViewType ?? '')}`);
+        logger_1.logger.info(`  状态     ${vo.fdEnabled === false ? '未启用' : '启用'}`);
+        logger_1.logger.info(`  描述     ${vo.fdDesc ?? ''}`);
+        if (vo.fdConfig) {
+            logger_1.logger.info('\nfdConfig:');
+            try {
+                logger_1.logger.json(JSON.parse(vo.fdConfig));
+            }
+            catch {
+                logger_1.logger.info(vo.fdConfig);
+            }
+        }
+    });
+    // ---------------------------------------------------------------- create
+    operation
+        .command('create')
+        .description('新建业务操作（支持打开链接 / 执行脚本 / 执行对话框）')
+        .requiredOption('--form-id <fdId>', '表单 id')
+        .requiredOption('--name <name>', '操作名称（≤30）')
+        .requiredOption('--code <code>', '自定义操作编码（≤15，字母开头，可含数字/下划线/连字符）')
+        .requiredOption('--type <type>', '类型：link | script | dialog')
+        .option('--position <position>', '使用位置：list（列表视图）| view（查看视图）', 'list')
+        .option('--need-select', '点击前需勾选数据（默认否；仅列表视图的自定义操作有效）')
+        .option('--url <url>', '打开链接地址（--type link 必填）')
+        .option('--script <code|@file>', '脚本内容或 @文件（--type script 必填）')
+        .option('--dialog-id <fdId>', '对话框 id（--type dialog 必填，可在平台对话框设计中获取）')
+        .option('--desc <text>', '描述（≤500）')
+        .option('--mobile-icon <name>', '移动端图标名')
+        .option('--dry-run', '只打印请求体，不提交')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出结果')
+        .action(async (opts) => {
+        const { payload, kind } = buildCreatePayload(opts);
+        if (opts.dryRun) {
+            logger_1.logger.info(logger_1.color.gray(`# ${KIND_META[kind].label} · 表单 ${String(opts.formId)}（dry-run）`));
+            logger_1.logger.json(payload);
+            return;
+        }
+        const client = createClient(opts);
+        logger_1.logger.step(`新建业务操作：${String(opts.name)}（${KIND_META[kind].label}）`);
+        const result = await operation_1.operationApi.add(client, payload);
+        const fdId = typeof result === 'string' ? result : result?.fdId;
+        if (opts.json) {
+            logger_1.logger.json({ fdId: fdId ?? null });
+            return;
+        }
+        logger_1.logger.success(fdId ? `已创建：${fdId}` : '已创建');
+        logger_1.logger.info(logger_1.color.gray('默认仅管理员可用；需要授权请到平台「业务操作」中设置可访问者。'));
+    });
+    // ---------------------------------------------------------------- update
+    operation
+        .command('update')
+        .description('修改业务操作（可把已有按钮切换为脚本模式并替换脚本）')
+        .requiredOption('--id <fdId>', '业务操作 id')
+        .option('--name <name>', '操作名称（≤30）')
+        .option('--code <code>', '自定义操作编码（≤15）')
+        .option('--desc <text>', '描述（≤500）')
+        .option('--position <position>', '使用位置：list（列表视图）| view（查看视图）')
+        .option('--type <type>', '切换类型：link | script | dialog（省略时保持现有类型）')
+        .option('--url <url>', '打开链接地址（link）')
+        .option('--script <code|@file>', '脚本内容或 @文件（script）')
+        .option('--dialog-id <fdId>', '对话框 id（dialog）')
+        .option('--need-select', '点击前需勾选数据')
+        .option('--no-need-select', '不需要勾选数据')
+        .option('--enable', '启用该操作')
+        .option('--disable', '停用该操作')
+        .option('--mobile-icon <name>', '移动端图标名')
+        .option('--dry-run', '只打印请求体，不提交')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出结果')
+        .action(async (opts) => {
+        const fdId = String(opts.id ?? '').trim();
+        if (!fdId)
+            throw new Error('业务操作 id 不能为空');
+        if (opts.enable && opts.disable)
+            throw new Error('--enable 与 --disable 不能同时使用');
+        const client = createClient(opts);
+        const current = await operation_1.operationApi.get(client, fdId);
+        if (!current?.fdId)
+            throw new Error(`业务操作不存在：${fdId}`);
+        const { payload, kind } = buildUpdatePayload(current, opts);
+        if (opts.dryRun) {
+            logger_1.logger.info(logger_1.color.gray(`# ${KIND_META[kind].label} · ${current.fdName}（dry-run）`));
+            logger_1.logger.json(payload);
+            return;
+        }
+        logger_1.logger.step(`修改业务操作：${String(payload.fdName)}（${KIND_META[kind].label}）`);
+        await operation_1.operationApi.update(client, payload);
+        if (opts.json) {
+            logger_1.logger.json({ fdId, type: kind });
+            return;
+        }
+        logger_1.logger.success(`已更新：${fdId}`);
+        logger_1.logger.info(logger_1.color.gray('切换到脚本模式后，需在视图中挂载该操作（llc operation attach）才会显示为按钮。'));
+    });
+    // ---------------------------------------------------------------- delete
+    operation
+        .command('delete')
+        .description('删除业务操作（被页面引用时会拒绝；需 --yes 确认）')
+        .requiredOption('--id <fdId>', '业务操作 id')
+        .option('--yes', '确认执行删除')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const fdId = String(opts.id ?? '').trim();
+        if (!fdId)
+            throw new Error('业务操作 id 不能为空');
+        if (!opts.yes) {
+            logger_1.logger.warn('已取消：删除业务操作不可恢复，请追加 --yes 确认执行');
+            return;
+        }
+        const client = createClient(opts);
+        logger_1.logger.step(`检查引用：${fdId}`);
+        let referContent = [];
+        try {
+            const refer = await operation_1.operationApi.listByRefer(client, fdId);
+            referContent = refer?.content ?? [];
+        }
+        catch (err) {
+            logger_1.logger.warn(`引用检查失败，继续删除：${err.message}`);
+        }
+        if (referContent.length > 0) {
+            referContent.forEach((item, index) => {
+                const vo = item;
+                logger_1.logger.info(`  ${index + 1}. ${String(vo.fdEntityLabel ?? '')} -- ${String(vo.fdEntitySubject ?? '')}`);
+            });
+            throw new Error('该业务操作已被页面引用，请先在对应视图中移除后再删除');
+        }
+        await operation_1.operationApi.remove(client, fdId);
+        logger_1.logger.success(`业务操作 ${fdId} 已删除`);
+    });
+    // ---------------------------------------------------------------- attach
+    operation
+        .command('attach')
+        .description('把业务操作挂到列表视图/查看视图（写入 operationList）')
+        .requiredOption('--form-id <fdId>', '表单 id')
+        .requiredOption('--operation-id <fdId>', '业务操作 id')
+        .option('--target <target>', '挂载目标：list（列表视图）| view（查看视图）', 'list')
+        .option('--view-id <fdId>', '视图 id（省略时自动定位该表单唯一的列表/查看视图）')
+        .option('--platform <platform>', 'desktop | mobile', 'desktop')
+        .option('--position <position>', 'top | rightHand | rightSide', 'top')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const formId = String(opts.formId ?? '').trim();
+        const opId = String(opts.operationId ?? '').trim();
+        if (!formId)
+            throw new Error('--form-id 不能为空');
+        if (!opId)
+            throw new Error('--operation-id 不能为空');
+        const target = String(opts.target ?? 'list').trim().toLowerCase();
+        if (target !== 'list' && target !== 'view') {
+            throw new Error(`未知 --target：${opts.target}（可选 list | view）`);
+        }
+        const position = String(opts.position ?? 'top').trim();
+        if (!ATTACH_POSITIONS.includes(position)) {
+            throw new Error(`未知 --position：${position}（可选 ${ATTACH_POSITIONS.join(' | ')}）`);
+        }
+        const platform = normalizePlatform(opts.platform);
+        const client = createClient(opts);
+        const op = await operation_1.operationApi.get(client, opId);
+        assertSameForm(op.fdXForm?.fdId, formId, '业务操作');
+        if (target === 'list' && op.fdPosition === 2) {
+            logger_1.logger.warn('该操作的使用位置是「查看视图」，挂到列表视图后可能不会显示');
+        }
+        if (target === 'view' && op.fdPosition === 1) {
+            logger_1.logger.warn('该操作的使用位置是「列表视图」，挂到查看视图后可能不会显示');
+        }
+        const vo = target === 'list'
+            ? await loadListView(client, formId, opts.viewId)
+            : await loadFormView(client, formId, opts.viewId);
+        const config = readViewConfig(vo, target);
+        const platformCfg = platformConfig(config, platform);
+        const list = Array.isArray(platformCfg.operationList) ? platformCfg.operationList : [];
+        const change = upsertOperationItem(list, opId, position, target === 'view' ? operationItemExtra(op) : {});
+        if (change === 'unchanged') {
+            logger_1.logger.info(`已挂载，无需修改：${TARGET_LABEL[target]} / ${platform} / ${position}`);
+            return;
+        }
+        platformCfg.operationList = list;
+        logger_1.logger.step(`保存${TARGET_LABEL[target]}配置：${vo.fdName ?? vo.fdId}`);
+        await saveViewConfig(client, target, vo, config, formId);
+        const saved = target === 'list'
+            ? await view_1.listViewApi.get(client, vo.fdId)
+            : await view_1.formViewApi.get(client, vo.fdId);
+        const items = platformConfig(readViewConfig(saved, target), platform).operationList ?? [];
+        if (!items.some((item) => item.id === opId)) {
+            throw new Error('保存后校验失败：视图中未找到该操作');
+        }
+        logger_1.logger.success(`${change === 'added' ? '已挂载' : '已更新位置'}：${op.fdName} → ${TARGET_LABEL[target]}（${platform} / ${position}）`);
+        logger_1.logger.info(logger_1.color.gray(`视图 ${vo.fdId}，operationList 共 ${items.length} 个按钮`));
+    });
+    // ---------------------------------------------------------------- detach
+    operation
+        .command('detach')
+        .description('从视图中移除业务操作按钮（不删除操作定义）')
+        .requiredOption('--form-id <fdId>', '表单 id')
+        .requiredOption('--operation-id <fdId>', '业务操作 id')
+        .option('--target <target>', '目标视图：list | view', 'list')
+        .option('--view-id <fdId>', '视图 id（省略时自动定位）')
+        .option('--platform <platform>', 'desktop | mobile', 'desktop')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const formId = String(opts.formId ?? '').trim();
+        const opId = String(opts.operationId ?? '').trim();
+        if (!formId)
+            throw new Error('--form-id 不能为空');
+        if (!opId)
+            throw new Error('--operation-id 不能为空');
+        const target = String(opts.target ?? 'list').trim().toLowerCase();
+        if (target !== 'list' && target !== 'view') {
+            throw new Error(`未知 --target：${opts.target}（可选 list | view）`);
+        }
+        const platform = normalizePlatform(opts.platform);
+        const client = createClient(opts);
+        const vo = target === 'list'
+            ? await loadListView(client, formId, opts.viewId)
+            : await loadFormView(client, formId, opts.viewId);
+        const config = readViewConfig(vo, target);
+        const platformCfg = platformConfig(config, platform);
+        const list = Array.isArray(platformCfg.operationList) ? platformCfg.operationList : [];
+        let removed = list.length - list.filter((item) => item.id !== opId).length;
+        platformCfg.operationList = list.filter((item) => item.id !== opId);
+        if (Array.isArray(platformCfg.shortcutOperation)) {
+            const shortcuts = platformCfg.shortcutOperation;
+            removed += shortcuts.length - shortcuts.filter((item) => item.id !== opId).length;
+            platformCfg.shortcutOperation = shortcuts.filter((item) => item.id !== opId);
+        }
+        if (!removed) {
+            logger_1.logger.warn(`该视图未挂载此操作：${TARGET_LABEL[target]} / ${platform}`);
+            return;
+        }
+        logger_1.logger.step(`保存${TARGET_LABEL[target]}配置：${vo.fdName ?? vo.fdId}`);
+        await saveViewConfig(client, target, vo, config, formId);
+        logger_1.logger.success(`已移除：${opId}（${TARGET_LABEL[target]} / ${platform}）`);
+    });
+}