lan-low-code-cli 2.5.0 → 2.6.0

package/dist/commands/template.js

@@ -0,0 +1,541 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTemplateCommand = registerTemplateCommand;
+const formDefine_1 = require("../api/formDefine");
+const template_1 = require("../api/template");
+const client_1 = require("../client");
+const config_1 = require("../config");
+const constants_1 = require("../constants");
+const generator_1 = require("../generator");
+const types_1 = require("../types");
+const logger_1 = require("../utils/logger");
+const widgets_1 = require("../widgets");
+const form_1 = require("./form");
+function createClient(opts) {
+    return new client_1.LcodeClient((0, config_1.resolveRuntime)({ baseUrl: opts.baseUrl, token: opts.token }));
+}
+/** 控件元数据注册表（站点根不变时复用磁盘缓存） */
+function createRegistry(opts) {
+    const runtime = (0, config_1.resolveRuntime)({ baseUrl: opts.baseUrl, token: opts.token });
+    return new widgets_1.WidgetRegistry({ baseUrl: runtime.baseUrl, token: runtime.token });
+}
+/** commander 可重复选项收集器 */
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+/** 生成 34 位字母数字 id（与平台 fdId 形态一致） */
+function genId() {
+    const ts = Date.now().toString(36);
+    let rand = '';
+    while (rand.length < 26)
+        rand += Math.random().toString(36).slice(2);
+    return `1k6g${ts}${rand}`.slice(0, 34);
+}
+function deepClone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function toList(result) {
+    if (Array.isArray(result))
+        return result;
+    const content = result?.content;
+    return Array.isArray(content) ? content : [];
+}
+/** 把源表单的业务字段复制到模板模型（重生成字段 id，改归属模型） */
+function cloneFields(srcMain, tplMain, keepNames) {
+    const keep = keepNames && keepNames.length ? new Set(keepNames) : undefined;
+    return (srcMain.fdFields || [])
+        .filter((f) => !f.fdIsSystem)
+        .filter((f) => !keep || keep.has(f.fdName))
+        .map((f) => ({
+        ...deepClone(f),
+        fdId: genId(),
+        fdDataModel: { fdId: tplMain.fdId, fdName: tplMain.fdName },
+    }));
+}
+/**
+ * 克隆源表单视图：替换表名、剔除明细节点与未保留字段。
+ * 返回可直接写入模板 fdConfig 的 viewModel 数组。
+ */
+function cloneViewModel(srcCfg, options) {
+    const source = deepClone((srcCfg.viewModel || [])[0] || null);
+    if (!source)
+        return [];
+    const dropFields = new Set(options.dropFieldNames || []);
+    const viewCfg = typeof source.fdConfig === 'string' ? JSON.parse(source.fdConfig) : source.fdConfig;
+    const desktop = viewCfg?.view?.render?.desktop;
+    if (!Array.isArray(desktop))
+        return [];
+    const clean = (node) => {
+        if (!node)
+            return null;
+        if (options.detailTable && node.key === options.detailTable)
+            return null;
+        if (dropFields.has(String(node.key)))
+            return null;
+        const props = node.controlProps;
+        if (props) {
+            if (props.$$tableName === options.srcTable)
+                props.$$tableName = options.tplTable;
+            if (props.tableName === options.srcTable)
+                props.tableName = options.tplTable;
+        }
+        if (Array.isArray(node.children)) {
+            node.children = node.children.map(clean).filter(Boolean);
+        }
+        return node;
+    };
+    viewCfg.view.render.desktop = desktop.map(clean).filter(Boolean);
+    source.fdConfig = typeof source.fdConfig === 'string' ? JSON.stringify(viewCfg) : viewCfg;
+    source.fdId = genId();
+    source.fdName = options.tplName;
+    source.fdXForm = { fdId: options.tplId, fdName: options.tplName };
+    return [source];
+}
+/** 克隆权限配置：替换表名，剔除明细表相关配置 */
+function cloneAuth(srcCfg, srcTable, tplTable, detailTable) {
+    let text = JSON.stringify(srcCfg.auth || []).split(srcTable).join(tplTable);
+    if (detailTable) {
+        const replaced = detailTable.split(srcTable).join(tplTable);
+        text = text.split(replaced).join(`${tplTable}__DETAIL_REMOVED`);
+    }
+    const prune = (value) => {
+        if (Array.isArray(value))
+            return value.map(prune);
+        if (value && typeof value === 'object') {
+            const out = {};
+            Object.keys(value).forEach((key) => {
+                if (key.indexOf('__DETAIL_REMOVED') > -1)
+                    return;
+                out[key] = prune(value[key]);
+            });
+            return out;
+        }
+        return value;
+    };
+    return prune(JSON.parse(text));
+}
+/**
+ * 克隆源表单 fdConfig 中「数据模型 / 视图 / 权限」以外的配置（attribute / sign / authFilter / extendMap 等）。
+ *
+ * 设计器加载时会读取 `sign.formula`、`attribute.formAttr` 等结构，缺失会直接抛
+ * `Cannot read properties of undefined (reading 'formula')`，因此不能只写 dataModel/viewModel/auth。
+ */
+function cloneBaseConfig(srcCfg, srcTable, tplTable, detailTable) {
+    const clone = deepClone(srcCfg || {});
+    let text = JSON.stringify(clone).split(srcTable).join(tplTable);
+    if (detailTable) {
+        const replaced = detailTable.split(srcTable).join(tplTable);
+        text = text.split(replaced).join(`${tplTable}__DETAIL_REMOVED`);
+    }
+    const prune = (value) => {
+        if (Array.isArray(value))
+            return value.map(prune);
+        if (value && typeof value === 'object') {
+            const out = {};
+            Object.keys(value).forEach((key) => {
+                if (key.indexOf('__DETAIL_REMOVED') > -1)
+                    return;
+                out[key] = prune(value[key]);
+            });
+            return out;
+        }
+        return value;
+    };
+    return prune(JSON.parse(text));
+}
+/**
+ * 分类表单的「发布配置」若缺 `sign` 等结构，模板设计器合并数据时会报
+ * `Cannot read properties of undefined (reading 'formula')`（mergeNewData 里 `sign: { formula }` 解构）。
+ *
+ * 这里用分类表单自身设计重新保存并发布一次，把发布配置补齐。返回是否执行了补齐。
+ */
+async function ensureCategoryDesignPublished(client, categoryId, categoryCode, opts) {
+    try {
+        const rel = await client.post('sys-modeling/categoryModel/getReleaseConfig', { sourceFormCode: categoryCode, currentFormId: categoryId });
+        const source = JSON.parse(rel?.sourceDesignConfig || '{}');
+        if (source.sign)
+            return false;
+        logger_1.logger.step('分类表单发布配置缺少 sign，自动补齐（saveDesignAndPublish）');
+        const design = await template_1.templateApi.loadDesign(client, categoryId);
+        const cfg = JSON.parse(String(design.fdConfig || '{}'));
+        const models = cfg.dataModel || [];
+        if (!models.length)
+            return false;
+        const payload = await (0, generator_1.buildFormDefinePayload)(models, {
+            base: { ...design, fdId: categoryId },
+            formId: categoryId,
+            formName: String(design.fdName ?? ''),
+            formDefineType: types_1.EFormDefineType.Common,
+            entityName: constants_1.MODELING_ENTITY_NAME,
+            entityCode: constants_1.MODELING_ENTITY_CODE,
+            controlMap: (0, config_1.resolveControlMap)(),
+            registry: createRegistry(opts),
+            includeSystem: false,
+            prevViewModel: cfg.viewModel,
+            prevLang: cfg.lang,
+            prevAttribute: cfg.attribute,
+        });
+        await client.post('sys-modeling/sysModelingXForm/saveDesignAndPublish', payload);
+        logger_1.logger.success('分类表单发布配置已补齐');
+        return true;
+    }
+    catch (err) {
+        logger_1.logger.warn(`补齐分类表单发布配置失败：${err.message}`);
+        return false;
+    }
+}
+function registerTemplateCommand(program) {
+    const template = program
+        .command('template')
+        .description('分类表单模板（发起页模板）：list | create | add-fields | delete');
+    // -------------------------------------------------------------------- list
+    template
+        .command('list')
+        .description('列出分类表单下的模板（运行时分类树）')
+        .requiredOption('--category-code <code>', '分类表单编码')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const code = String(opts.categoryCode ?? '').trim();
+        if (!code)
+            throw new Error('--category-code 不能为空');
+        const result = await template_1.templateApi.tree(client, code);
+        const list = result?.categoryList ?? [];
+        if (opts.json) {
+            logger_1.logger.json(list);
+            return;
+        }
+        logger_1.logger.table(list.map((item) => ({
+            fdId: String(item.fdId ?? ''),
+            名称: String(item.fdName ?? ''),
+            允许选择: item.allowSelect === false ? '否' : '是',
+        })));
+        logger_1.logger.info(logger_1.color.gray(`共 ${list.length} 个模板`));
+    });
+    // ------------------------------------------------------------------ create
+    template
+        .command('create')
+        .description('在分类表单下创建模板，并可把既有表单的字段/视图/权限移植进来')
+        .requiredOption('--category-code <code>', '分类表单编码（categoryModel 的 fdCode）')
+        .requiredOption('--name <name>', '模板名称')
+        .option('--code <code>', '模板编码，默认自动生成')
+        .option('--from-form <fdId>', '来源表单 id：克隆其业务字段、视图布局、字段权限')
+        .option('--fields <names>', '仅移植指定业务字段（逗号分隔，配合 --from-form）')
+        .option('--table-name <name>', '模板表名（默认取分类表单的模板表/聚合表）')
+        .option('--category-node <fdId>', '挂载到已有分类节点 id（分类表单；不传则自动新建）')
+        .option('--category-name <name>', '自动新建的分类节点名称（默认取模板名）')
+        .option('--publish', '创建后发布模板')
+        .option('--dry-run', '只打印将要提交的数据，不实际请求')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出结果')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const categoryCode = String(opts.categoryCode ?? '').trim();
+        const name = String(opts.name ?? '').trim();
+        if (!categoryCode)
+            throw new Error('--category-code 不能为空');
+        if (!name)
+            throw new Error('--name 不能为空');
+        // 1. 分类表单
+        logger_1.logger.step(`查询分类表单：${categoryCode}`);
+        const category = toList(await template_1.templateApi.findCategoryByCode(client, categoryCode))[0];
+        if (!category?.fdId)
+            throw new Error(`分类表单不存在：${categoryCode}`);
+        // 模板编辑器会合并分类表单的发布配置，缺 sign 会直接报 "reading 'formula'"，先确保配置完整
+        await ensureCategoryDesignPublished(client, String(category.fdId), categoryCode, opts);
+        const isSimple = Number(category.fdType) === 2;
+        const tableName = String(opts.tableName ?? '').trim() ||
+            String(isSimple ? category.fdPolymersTableName : category.fdTemplateTableName || '').trim();
+        if (!tableName)
+            throw new Error('未能确定模板表名，请用 --table-name 指定');
+        // 2. 应用 id（模板创建需要 fdAppId）
+        let appId = '';
+        const appCode = String(category.fdAppCode ?? '').trim();
+        if (appCode) {
+            const apps = toList(await formDefine_1.modelingAppApi.list(client, { conditions: { fdAppCode: appCode }, pageSize: 1 }));
+            appId = String(apps[0]?.fdId ?? '');
+        }
+        logger_1.logger.info(logger_1.color.gray(`分类表单：${category.fdName}（${isSimple ? '简单分类表单' : '分类表单'}）　` +
+            `模板表：${tableName}${appCode ? `　应用：${appCode}` : ''}`));
+        // 3. 分类表单：模板必须挂在分类节点下才会出现在发起页（简单分类的聚合表本身就是节点）
+        let nodeId = '';
+        if (!isSimple) {
+            nodeId = String(opts.categoryNode ?? '').trim();
+            if (!nodeId) {
+                logger_1.logger.step('创建分类节点');
+                const node = await template_1.templateApi.addCategoryNode(client, {
+                    fdCategoryModelCode: categoryCode,
+                    fdName: String(opts.categoryName ?? name).trim() || name,
+                });
+                nodeId = String(node?.fdId ?? '');
+            }
+            if (!nodeId)
+                throw new Error('分类节点创建失败，请用 --category-node 指定已有节点');
+        }
+        // 4. 模板创建 payload（跳过 init，直接 add + fdBuildNew）
+        const payload = {
+            fdCategoryModelCode: categoryCode,
+            ...(nodeId ? { fdCategory: { fdId: nodeId } } : {}),
+            ...(appId ? { fdAppId: appId } : {}),
+            fdName: name,
+            fdSimpleName: name,
+            fdCode: String(opts.code ?? '').trim() || `tpl_${Date.now().toString(36).slice(-6)}`,
+            fdStatus: 'draft',
+            fdEnable: true,
+            fdBuildNew: true,
+            mechanisms: {
+                load: '*',
+                'sys-xform': {
+                    fdName: name,
+                    fdTableName: tableName,
+                    fdStatus: 'draft',
+                    fdBuildNew: true,
+                    fdEntityName: `sys-modeling-tmpl#${categoryCode}`,
+                    fdEntityId: '',
+                    fdEntityKey: 'sys-xform',
+                },
+            },
+        };
+        if (opts.dryRun) {
+            logger_1.logger.title('【dry-run】将提交（模板 add）');
+            logger_1.logger.json(payload);
+            return;
+        }
+        logger_1.logger.step(`创建模板：${name}`);
+        const created = await template_1.templateApi.create(client, isSimple ? 'simple' : 'category', payload);
+        const fdId = String(created?.fdId ?? '');
+        if (!fdId)
+            throw new Error('模板创建失败：接口未返回 fdId');
+        logger_1.logger.success(`模板创建成功，fdId = ${fdId}`);
+        // 分类节点挂载放在设计就绪之后（见发布前）
+        // 5. 从来源表单移植字段 / 视图 / 权限
+        let fieldCount = 0;
+        let viewCount = 0;
+        if (opts.fromForm) {
+            const fromForm = String(opts.fromForm).trim();
+            logger_1.logger.step(`加载来源表单设计：${fromForm}`);
+            const src = await template_1.templateApi.loadDesign(client, fromForm);
+            const srcCfg = JSON.parse(String(src.fdConfig || '{}'));
+            const srcMain = (srcCfg.dataModel || []).find((m) => m.fdType === 'main');
+            const srcDetail = (srcCfg.dataModel || []).find((m) => m.fdType === 'detail');
+            if (!srcMain)
+                throw new Error(`来源表单缺少主模型：${fromForm}`);
+            logger_1.logger.step(`加载模板设计：${fdId}`);
+            const tpl = await template_1.templateApi.loadDesign(client, fdId);
+            const tplCfg = JSON.parse(String(tpl.fdConfig || '{}'));
+            const tplMain = (tplCfg.dataModel || []).find((m) => m.fdType === 'main');
+            if (!tplMain)
+                throw new Error('模板缺少主模型，无法移植字段');
+            const keepNames = opts.fields
+                ? String(opts.fields)
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter(Boolean)
+                : undefined;
+            const fields = cloneFields(srcMain, tplMain, keepNames);
+            if (!fields.length)
+                throw new Error('来源表单没有可移植的业务字段');
+            tplMain.fdFields = [...(tplMain.fdFields || []), ...fields];
+            fieldCount = fields.length;
+            const srcBizNames = (srcMain.fdFields || [])
+                .filter((f) => !f.fdIsSystem)
+                .map((f) => f.fdName);
+            const keptNames = new Set(fields.map((f) => f.fdName));
+            const viewModel = cloneViewModel(srcCfg, {
+                srcTable: srcMain.fdTableName,
+                tplTable: tplMain.fdTableName,
+                detailTable: srcDetail?.fdTableName,
+                tplId: fdId,
+                tplName: name,
+                dropFieldNames: srcBizNames.filter((n) => !keptNames.has(n)),
+            });
+            viewCount = viewModel.length;
+            const auth = cloneAuth(srcCfg, srcMain.fdTableName, tplMain.fdTableName, srcDetail?.fdTableName);
+            const baseCfg = cloneBaseConfig(srcCfg, srcMain.fdTableName, tplMain.fdTableName, srcDetail?.fdTableName);
+            const newCfg = {
+                ...baseCfg,
+                dataModel: tplCfg.dataModel,
+                viewModel,
+                auth,
+                lang: srcCfg.lang || '{}',
+                error: srcCfg.error || '{}',
+            };
+            // 设计器加载/合并时需要的结构，缺失会报 "reading 'formula'"
+            if (!newCfg.sign)
+                newCfg.sign = { formula: {} };
+            if (!newCfg.attribute)
+                newCfg.attribute = { formAttr: '{}' };
+            if (!newCfg.authFilter)
+                newCfg.authFilter = { detailAuthDefine: {} };
+            if (!newCfg.extendMap)
+                newCfg.extendMap = {};
+            await template_1.templateApi.saveDesign(client, {
+                ...tpl,
+                // 模板设计的实体 id 必须指向模板自身，为空会导致设计器合并数据时取不到元数据
+                fdEntityId: fdId,
+                fdEntityKey: 'sys-xform',
+                fdEntityName: `sys-modeling-tmpl#${categoryCode}`,
+                fdConfig: JSON.stringify(newCfg),
+            });
+            logger_1.logger.success(`已移植 ${fieldCount} 个业务字段、${viewCount} 个视图`);
+        }
+        // 6. 兜底挂载分类节点（add 时后端可能忽略 fdCategory，设计就绪后再 update 一次）
+        if (nodeId) {
+            try {
+                const current = await template_1.templateApi.get(client, fdId, categoryCode);
+                await template_1.templateApi.update(client, { ...current, fdCategory: { fdId: nodeId } });
+                logger_1.logger.info(logger_1.color.gray(`模板已挂到分类节点：${nodeId}`));
+            }
+            catch (err) {
+                logger_1.logger.warn(`挂载分类节点失败（不影响模板本身）：${err.message}`);
+            }
+        }
+        // 7. 发布
+        if (opts.publish) {
+            logger_1.logger.step('发布模板');
+            const detail = await template_1.templateApi.get(client, fdId, categoryCode);
+            await template_1.templateApi.publish(client, { ...detail, fdStatus: 'official' });
+            logger_1.logger.success('模板已发布');
+        }
+        if (opts.json) {
+            logger_1.logger.json({ fdId, categoryCode, tableName, fields: fieldCount, views: viewCount });
+            return;
+        }
+        logger_1.logger.info(logger_1.color.gray(`完成。模板 id：${fdId}　可在平台「${category.fdName}」发起页看到该模板；` +
+            `后续加字段可用 llc form autofill --id <来源表单> 生成后再移植。`));
+    });
+    // -------------------------------------------------------------- add-fields
+    template
+        .command('add-fields')
+        .description('向已有模板追加字段（默认重建栅格布局让字段可见，--keep-layout 保留原布局）')
+        .requiredOption('--template-id <fdId>', '模板 id（可用 llc template list 查询）')
+        .option('--category-code <code>', '分类表单编码（--publish 时必填）')
+        .option('--add-field <spec>', '新增字段，格式 name:label[:dataType|controlType[:controlType]]，可重复', collect, [])
+        .option('--per-row <n>', '每行控件数（重建布局时生效，默认 2）', (v) => Number(v), 2)
+        .option('--keep-layout', '保留现有布局（新字段可能不在画布上，需到设计器拖入）')
+        .option('--publish', '保存后发布模板')
+        .option('--dry-run', '只打印将新增的字段，不提交')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出结果')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const fdId = String(opts.templateId ?? '').trim();
+        const specs = opts.addField ?? [];
+        if (!fdId)
+            throw new Error('--template-id 不能为空');
+        if (!specs.length)
+            throw new Error('请用 --add-field 指定要新增的字段');
+        logger_1.logger.step(`加载模板设计：${fdId}`);
+        const tpl = await template_1.templateApi.loadDesign(client, fdId);
+        const cfg = JSON.parse(String(tpl.fdConfig || '{}'));
+        const models = cfg.dataModel || [];
+        if (!models.length)
+            throw new Error('模板数据模型为空，无法新增字段');
+        const controlMap = (0, config_1.resolveControlMap)();
+        const registry = createRegistry(opts);
+        const withNew = await (0, form_1.injectNewFields)(models, specs, controlMap, registry);
+        const mainBefore = (models.find((m) => m.fdType === 'main')?.fdFields) || [];
+        const beforeNames = new Set(mainBefore.map((f) => f.fdName));
+        const mainAfter = (withNew.find((m) => m.fdType === 'main')?.fdFields) || [];
+        const added = mainAfter
+            .filter((f) => !beforeNames.has(f.fdName))
+            .map((f) => f.fdName);
+        if (!added.length)
+            throw new Error('没有新增字段（--add-field 指定的字段可能已存在）');
+        const payload = await (0, generator_1.buildFormDefinePayload)(withNew, {
+            base: { ...tpl, fdId },
+            formId: fdId,
+            formName: String(tpl.fdName ?? ''),
+            formDefineType: types_1.EFormDefineType.Common,
+            entityName: constants_1.MODELING_ENTITY_NAME,
+            entityCode: constants_1.MODELING_ENTITY_CODE,
+            controlMap,
+            registry,
+            perRow: opts.perRow,
+            includeSystem: false,
+            layout: opts.keepLayout ? undefined : 'grid',
+            prevViewModel: cfg.viewModel,
+            prevLang: cfg.lang,
+            prevAttribute: cfg.attribute,
+        });
+        const nextCfg = JSON.parse(String(payload.fdConfig || '{}'));
+        // 保留模板已有的字段权限（重建布局时 buildAuth 会生成新权限配置）
+        if (cfg.auth)
+            nextCfg.auth = cfg.auth;
+        logger_1.logger.info(logger_1.color.gray(`新增字段：${added.join('、')}　重建布局：${opts.keepLayout ? '否' : '是'}`));
+        if (opts.dryRun) {
+            logger_1.logger.json({ fdId, added, keepLayout: Boolean(opts.keepLayout) });
+            return;
+        }
+        await template_1.templateApi.saveDesign(client, { ...tpl, fdConfig: JSON.stringify(nextCfg) });
+        logger_1.logger.success(`模板设计已保存（新增 ${added.length} 个字段）`);
+        if (opts.publish) {
+            const categoryCode = String(opts.categoryCode ?? '').trim();
+            if (!categoryCode)
+                throw new Error('--publish 需要同时提供 --category-code');
+            logger_1.logger.step('发布模板');
+            const detail = await template_1.templateApi.get(client, fdId, categoryCode);
+            await template_1.templateApi.publish(client, { ...detail, fdStatus: 'official' });
+            logger_1.logger.success('模板已发布');
+        }
+        if (opts.json) {
+            logger_1.logger.json({ fdId, added, published: Boolean(opts.publish) });
+        }
+    });
+    // ------------------------------------------------------------------ delete
+    template
+        .command('delete')
+        .description('删除分类表单下的模板（--all 删除该分类表单下的全部模板）')
+        .requiredOption('--category-code <code>', '分类表单编码')
+        .option('--template-id <fdId>', '模板 id，可重复', collect, [])
+        .option('--all', '删除该分类表单下的全部模板')
+        .option('--yes', '确认执行删除')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出结果')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const code = String(opts.categoryCode ?? '').trim();
+        const explicit = (opts.templateId ?? [])
+            .map((s) => String(s).trim())
+            .filter(Boolean);
+        if (!code)
+            throw new Error('--category-code 不能为空');
+        if (!explicit.length && !opts.all) {
+            throw new Error('请用 --template-id 指定模板，或用 --all 删除全部');
+        }
+        logger_1.logger.step(`查询分类表单：${code}`);
+        const category = toList(await template_1.templateApi.findCategoryByCode(client, code))[0];
+        if (!category?.fdId)
+            throw new Error(`分类表单不存在：${code}`);
+        const isSimple = Number(category.fdType) === 2;
+        const kind = isSimple ? 'simple' : 'category';
+        let ids = explicit;
+        if (opts.all) {
+            const listed = await template_1.templateApi.listByCategory(client, kind, code);
+            const rows = isSimple
+                ? (listed?.categoryList ?? [])
+                : (listed ?? []);
+            ids = rows.map((row) => String(row.fdId ?? '')).filter(Boolean);
+        }
+        ids = [...new Set(ids)];
+        if (!ids.length) {
+            logger_1.logger.warn('没有可删除的模板');
+            return;
+        }
+        logger_1.logger.info(logger_1.color.gray(`待删除模板 ${ids.length} 个：${ids.join(', ')}`));
+        if (!opts.yes) {
+            logger_1.logger.warn('已取消：删除模板不可恢复，请追加 --yes 确认执行');
+            return;
+        }
+        await template_1.templateApi.deleteTemplates(client, kind, code, ids);
+        logger_1.logger.success(`已删除 ${ids.length} 个模板`);
+        if (opts.json) {
+            logger_1.logger.json({ categoryCode: code, deleted: ids });
+        }
+    });
+}

package/dist/index.js

@@ -8,8 +8,10 @@ const control_1 = require("./commands/control");
 const field_1 = require("./commands/field");
 const form_1 = require("./commands/form");
 const locale_1 = require("./commands/locale");
+const operation_1 = require("./commands/operation");
+const template_1 = require("./commands/template");
 const logger_1 = require("./utils/logger");
-const VERSION = '2.5.0';
+const VERSION = '2.6.0';
 const program = new commander_1.Command();
 exports.program = program;
 program
@@ -34,6 +36,8 @@ program.hook('preAction', (thisCommand, actionCommand) => {
 (0, app_1.registerAppCommand)(program);
 (0, form_1.registerFormCommand)(program);
 (0, field_1.registerFieldCommand)(program);
+(0, operation_1.registerOperationCommand)(program);
+(0, template_1.registerTemplateCommand)(program);
 (0, locale_1.registerLocaleCommand)(program);
 (0, control_1.registerControlCommand)(program);
 /**
@@ -106,6 +110,10 @@ ${logger_1.color.bold('常用查询')}
   llc control list                              环境可用控件（含高级控件；明细/分页为容器类）
   llc locale list                               环境提供了哪些语言译文
   llc field library [--keyword 关键词]           字段库
+  llc operation list --form-id <fdId>           表单的业务操作（列表页/查看页按钮）
+  llc operation create --form-id <fdId> --name 打开帮助 --code openHelp --type link --url https://example.com
+  llc operation delete --id <operationId> --yes  删除业务操作（被引用时会拒绝）
+  llc operation attach --form-id <fdId> --operation-id <opId>  挂到列表视图（--target view 挂查看视图）
 
 ${logger_1.color.gray('高级控件（desc / tags / mdm / association / mechnumber …）与普通控件同样写法：')}
   llc form autofill --id <fdId> --apply --add-field "字段名:标题:控件类型"

package/package.json

@@ -1,49 +1,49 @@
-{
-  "name": "lan-low-code-cli",
-  "version": "2.5.0",
-  "description": "lan-low-code cli：低代码表单引擎命令行工具（创建表单、获取可用字段、自动完善表单字段）",
-  "keywords": [
-    "low-code",
-    "lan-low-code",
-    "llc",
-    "form",
-    "cli"
-  ],
-  "license": "MIT",
-  "packageManager": "pnpm@10.26.2",
-  "bin": {
-    "llc": "bin/llc.js"
-  },
-  "main": "dist/index.js",
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "clean": "rimraf dist",
-    "rebuild": "pnpm run clean && pnpm run build",
-    "start": "pnpm run build && node bin/llc.js",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepare": "pnpm run build",
-    "bump": "node scripts/bump-version.js",
-    "bump:check": "node scripts/bump-version.js --check",
-    "pack": "node scripts/pack.js",
-    "pack:cli": "node scripts/pack.js --target cli",
-    "pack:skill": "node scripts/pack.js --target skill"
-  },
-  "dependencies": {
-    "commander": "^11.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.30",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.4.5"
-  },
-  "engines": {
-    "node": ">=18",
-    "pnpm": ">=8"
-  },
-  "files": [
-    "bin",
-    "dist",
-    "skills",
-    "README.md"
-  ]
-}
+{
+  "name": "lan-low-code-cli",
+  "version": "2.6.0",
+  "description": "lan-low-code cli：低代码表单引擎命令行工具（创建表单、获取可用字段、自动完善表单字段）",
+  "keywords": [
+    "low-code",
+    "lan-low-code",
+    "llc",
+    "form",
+    "cli"
+  ],
+  "license": "MIT",
+  "packageManager": "pnpm@10.26.2",
+  "bin": {
+    "llc": "bin/llc.js"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "rebuild": "pnpm run clean && pnpm run build",
+    "start": "pnpm run build && node bin/llc.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepare": "pnpm run build",
+    "bump": "node scripts/bump-version.js",
+    "bump:check": "node scripts/bump-version.js --check",
+    "pack": "node scripts/pack.js",
+    "pack:cli": "node scripts/pack.js --target cli",
+    "pack:skill": "node scripts/pack.js --target skill"
+  },
+  "dependencies": {
+    "commander": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.4.5"
+  },
+  "engines": {
+    "node": ">=18",
+    "pnpm": ">=8"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "skills",
+    "README.md"
+  ]
+}