lan-low-code-cli 0.0.0-stage → 2.0.0

package/bin/llc.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+'use strict'
+
+// 入口垫片：加载编译后的 CLI
+try {
+  require('../dist/index.js')
+} catch (err) {
+  if (err && err.code === 'MODULE_NOT_FOUND' && /dist[\\/]index\.js/.test(err.message)) {
+    console.error('[lcode] 未找到编译产物，请先执行: npm run build')
+    process.exit(1)
+  }
+  throw err
+}

package/dist/api/formDefine.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataSetApi = exports.modelingAppApi = exports.modelingXFormApi = exports.designApi = exports.wordsFieldApi = exports.dataModelApi = exports.formCategoryApi = exports.formDefineApi = void 0;
+/**
+ * 表单定义接口（后端 SysGeneralFormDefineController）
+ * 基础路径：/data/sys-xform/generalFormDefine/
+ * 所有接口均为 POST + JSON
+ */
+const BASE = 'sys-xform/generalFormDefine';
+exports.formDefineApi = {
+    /** 表单初始化：返回带默认值的 VO */
+    init: (client, payload = {}) => client.post(`${BASE}/init`, payload),
+    /** 表单新建：返回 IdVO { fdId } */
+    add: (client, payload) => client.post(`${BASE}/add`, payload),
+    /** 表单加载 */
+    get: (client, fdId, extra = {}) => client.post(`${BASE}/get`, { fdId, ...extra }),
+    /** 表单保存 */
+    save: (client, payload) => client.post(`${BASE}/save`, payload),
+    /** 表单保存并发布 */
+    publish: (client, payload) => client.post(`${BASE}/publish`, payload),
+    /** 表单删除 */
+    delete: (client, fdId) => client.post(`${BASE}/delete`, { fdId }),
+    /** 表单批量删除 */
+    deleteAll: (client, fdIds) => client.post(`${BASE}/deleteAll`, { fdIds }),
+    /** 表单列表查询 */
+    list: (client, request = {}) => client.post(`${BASE}/list`, request),
+};
+/** 表单分类接口（后端 generalFormCategory） */
+const CATEGORY_BASE = 'sys-xform/generalFormCategory';
+exports.formCategoryApi = {
+    list: (client, request = {}) => client.post(`${CATEGORY_BASE}/list`, request),
+};
+/** 数据模型接口（后端 SysXFormDataModelController / SysXFormDataModelFieldController） */
+const MODEL_BASE = 'sys-xform/sysXFormDataModel';
+const FIELD_BASE = 'sys-xform/sysXFormDataModelField';
+exports.dataModelApi = {
+    /** 根据表单 id 加载数据模型（含字段列表） */
+    loadByFormId: (client, fdId) => client.post(`${MODEL_BASE}/loadByFormId`, { fdId }),
+    /** 根据数据模型 id 加载单个数据模型 */
+    load: (client, fdId) => client.post(`${MODEL_BASE}/load`, { fdId }),
+    /** 根据数据模型 id 获取字段 */
+    getModelFields: (client, fdId) => client.post(`${MODEL_BASE}/getModelFields`, { fdId }),
+    /** 生成明细表/从表名 */
+    generateTableName: (client, payload) => client.post(`${MODEL_BASE}/generateTableName`, payload),
+    /** 表名唯一性校验 */
+    validateTableName: (client, payload) => client.post(`${MODEL_BASE}/validateTableName`, { isAdd: true, ...payload }),
+    /**
+     * 获取系统默认数据模型（含服务端生成的 fdId 与系统字段）。
+     *
+     * `fdType: 'detail'` 时返回 `{ fdId, fdType, fdFields:[fd_id, fd_main_id, fd_order], … }`，
+     * 这是新建明细表的权威模板（见前端 `ide-model/operation/addTableModal.tsx`）。
+     */
+    getSystemDefaultModel: (client, payload = {}) => client.post(`${MODEL_BASE}/getSystemDefaultModel`, payload),
+    /** 根据表名模糊匹配表集合 */
+    loadModelMeta: (client, payload) => client.post(`${MODEL_BASE}/loadModelMeta`, payload),
+    /** 数据模型列表 */
+    list: (client, request = {}) => client.post(`${MODEL_BASE}/list`, request),
+    /** 根据表名获取外部表字段集合 */
+    loadFieldMeta: (client, payload) => client.post(`${FIELD_BASE}/loadFieldMeta`, payload),
+    /** 字段列表查询（分页/搜索） */
+    listFields: (client, request = {}) => client.post(`${FIELD_BASE}/list`, request),
+};
+/** 字段库接口（后端 SysXFormWordsFieldController） */
+const WORDS_BASE = 'sys-xform/sysXFormWordsField';
+exports.wordsFieldApi = {
+    /** 字段库列表 */
+    list: (client, request = {}) => client.post(`${WORDS_BASE}/list`, request),
+    /** 编码自动填充：根据名称生成字段编码 */
+    generateFdKey: (client, payload = {}) => client.post(`${WORDS_BASE}/generateFdKey`, payload),
+    /** 检查字段编码是否存在 */
+    checkCodeExist: (client, fdCode) => client.post(`${WORDS_BASE}/checkCodeExist`, { fdCode }),
+};
+/** 表单设计器接口（后端 SysXFormDesignController） */
+const DESIGN_BASE = 'sys-xform/sysXFormDesign';
+exports.designApi = {
+    /** 获取主表单详情 */
+    load: (client, fdId) => client.post(`${DESIGN_BASE}/load`, { fdId }),
+    /** 直接用设计器接口新建 */
+    create: (client, payload) => client.post(`${DESIGN_BASE}/create`, payload),
+    /** 保存表单设计数据 */
+    save: (client, payload) => client.post(`${DESIGN_BASE}/save`, payload),
+    /** 列表查询 */
+    list: (client, request = {}) => client.post(`${DESIGN_BASE}/list`, request),
+    /** 表单发布（请求体为 XFormDesignPushVO） */
+    publish: (client, payload) => client.post(`${DESIGN_BASE}/publish`, payload),
+};
+/**
+ * 业务建模（低代码应用）表单接口
+ * 基础路径：/data/sys-modeling/sysModelingXForm/
+ *
+ * 说明：在"应用"下建表单走这条链路，表单通过 fdAppId 归属应用，
+ * 服务端会写死 fdEntityId=表单id、fdEntityName=fdRunEntityName='sys-modeling'。
+ */
+const MODELING_XFORM_BASE = 'sys-modeling/sysModelingXForm';
+exports.modelingXFormApi = {
+    /** 应用下表单列表 */
+    list: (client, request) => client.post(`${MODELING_XFORM_BASE}/list`, {
+        pageNo: request.pageNo ?? 1,
+        pageSize: request.pageSize ?? 200,
+        conditions: { 'fdApp.fdId': request.fdAppId },
+        columns: ['fdId', 'fdName', 'fdStatus', 'fdTableName'],
+    }),
+    /** 生成建模业务表单数据库表名（mk_model_yyyyMMdd + 随机5位） */
+    generateTableName: (client) => client.post(`${MODELING_XFORM_BASE}/generateTableName`),
+    /** 检查表名是否可用（true=可用） */
+    checkTableNameExist: (client, fdTableName) => client.post(`${MODELING_XFORM_BASE}/checkTableNameExist`, { fdTableName }),
+    /** 检查表单名称在应用内是否已存在（true=已存在） */
+    checkXFormNameExist: (client, payload) => client.post(`${MODELING_XFORM_BASE}/checkXFormNameExist`, {
+        fdApp: { fdId: payload.fdAppId },
+        fdName: payload.fdName,
+        fdId: payload.fdId,
+    }),
+    /** 新增业务表单基本信息（表单名称、表单图标、数据库表名） */
+    create: (client, payload) => client.post(`${MODELING_XFORM_BASE}/create`, payload),
+    /** 保存更新表单基本信息 */
+    saveBase: (client, payload) => client.post(`${MODELING_XFORM_BASE}/saveBase`, payload),
+    /** 保存更新表单设计器配置 */
+    saveDesign: (client, payload) => client.post(`${MODELING_XFORM_BASE}/saveDesign`, payload),
+    /** 业务表单发布 */
+    publish: (client, payload) => client.post(`${MODELING_XFORM_BASE}/publish`, payload),
+    /** 保存设计器配置并同时发布 */
+    saveDesignAndPublish: (client, payload) => client.post(`${MODELING_XFORM_BASE}/saveDesignAndPublish`, payload),
+    /** 获取业务表单设计器配置信息 */
+    loadDesign: (client, fdId) => client.post(`${MODELING_XFORM_BASE}/loadDesign`, { fdId }),
+    /** 获取业务表单基本信息 */
+    loadBase: (client, fdId) => client.post(`${MODELING_XFORM_BASE}/loadBase`, { fdId }),
+    /** 删除业务表单（连同其数据模型） */
+    remove: (client, fdId) => client.post(`${MODELING_XFORM_BASE}/delete`, { fdId }),
+    /** 删除业务表单的运行时数据（保留表单定义） */
+    removeData: (client, fdId) => client.post(`${MODELING_XFORM_BASE}/deleteData`, { fdId }),
+};
+/** 业务建模应用接口 */
+const MODELING_APP_BASE = 'sys-modeling/sysModelingApplication';
+exports.modelingAppApi = {
+    /** 应用基本信息列表 */
+    list: (client, request = {}) => client.post(`${MODELING_APP_BASE}/list`, request),
+    /** 应用列表（不做权限校验） */
+    listNotAuth: (client, request = {}) => client.post(`${MODELING_APP_BASE}/listNotAuth`, request),
+    /** 查看应用 */
+    get: (client, fdId) => client.post(`${MODELING_APP_BASE}/get`, { fdId }),
+    /** 编辑页数据（含可访问者/可维护者，提交 update 需回传） */
+    edit: (client, fdId) => client.post(`${MODELING_APP_BASE}/edit`, { fdId }),
+    /** 新建应用，返回 { fdId }（后端同时创建默认首页） */
+    add: (client, vo) => client.post(`${MODELING_APP_BASE}/add`, vo),
+    /** 修改应用基本信息（请求体为 DetailVO） */
+    update: (client, vo) => client.post(`${MODELING_APP_BASE}/update`, vo),
+    /** 删除应用 */
+    remove: (client, fdId) => client.post(`${MODELING_APP_BASE}/delete`, { fdId }),
+    /** 删除应用业务数据（保留应用） */
+    removeData: (client, fdId) => client.post(`${MODELING_APP_BASE}/deleteData`, { fdId }),
+};
+/** 数据集接口 */
+const DATASET_BASE = 'sys-xform/sysXFormDataSetConfig';
+exports.dataSetApi = {
+    categoryList: (client, payload = {}) => client.post(`${DATASET_BASE}/categoryList`, payload),
+    moduleList: (client, payload = {}) => client.post(`${DATASET_BASE}/moduleList`, payload),
+    entityList: (client, payload = {}) => client.post(`${DATASET_BASE}/entityList`, payload),
+    fieldList: (client, payload = {}) => client.post(`${DATASET_BASE}/fieldList`, payload),
+    subFieldList: (client, payload = {}) => client.post(`${DATASET_BASE}/subFieldList`, payload),
+    entitySearch: (client, payload = {}) => client.post(`${DATASET_BASE}/entitySearch`, payload),
+};

package/dist/client.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LcodeClient = void 0;
+exports.rawRequest = rawRequest;
+const http_1 = __importDefault(require("http"));
+const https_1 = __importDefault(require("https"));
+/**
+ * 底层 HTTP 请求：基于 `node:http` / `node:https`，`agent: false` 禁用连接复用。
+ *
+ * 不用全局 `fetch`（undici）的原因：Windows + Node 24 下，进程退出时 undici
+ * 的空闲 keep-alive 连接会触发 libuv 断言
+ * `Assertion failed: !(handle->flags & UV_HANDLE_CLOSING)`，
+ * 进程以 0xC0000409 异常退出，脚本无法根据退出码判断成败。
+ */
+function rawRequest(options) {
+    const { url, method, headers = {}, body, timeout = 30000 } = options;
+    const target = new URL(url);
+    const transport = target.protocol === 'https:' ? https_1.default : http_1.default;
+    return new Promise((resolve, reject) => {
+        const request = transport.request({
+            protocol: target.protocol,
+            hostname: target.hostname,
+            port: target.port || (target.protocol === 'https:' ? 443 : 80),
+            path: `${target.pathname}${target.search}`,
+            method,
+            headers: {
+                ...headers,
+                ...(body !== undefined ? { 'Content-Length': Buffer.byteLength(body) } : {}),
+            },
+            // 每次请求新建连接，响应结束即关闭，进程可干净退出
+            agent: false,
+        }, (response) => {
+            const chunks = [];
+            response.on('data', (chunk) => chunks.push(chunk));
+            response.on('end', () => {
+                resolve({
+                    status: response.statusCode ?? 0,
+                    statusText: response.statusMessage ?? '',
+                    text: Buffer.concat(chunks).toString('utf8'),
+                });
+            });
+            response.on('error', reject);
+        });
+        request.setTimeout(timeout, () => {
+            request.destroy(new Error(`请求超时(${timeout}ms)`));
+        });
+        request.on('error', reject);
+        if (body !== undefined)
+            request.write(body);
+        request.end();
+    });
+}
+/**
+ * HTTP 客户端：零运行时依赖。
+ * 鉴权方式：请求头 `X-AUTH-TOKEN`。
+ *
+ * 完整请求地址 = `${baseUrl}/${relativePath}`
+ *   例如 baseUrl = http://host/data，relativePath = sys-xform/generalFormDefine/add
+ *   => http://host/data/sys-xform/generalFormDefine/add
+ */
+class LcodeClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.token = config.token;
+        this.timeout = config.timeout ?? 30000;
+    }
+    /** 拼装完整 URL */
+    resolveUrl(relativePath) {
+        const path = relativePath.replace(/^\/+/, '');
+        return `${this.baseUrl}/${path}`;
+    }
+    /** POST 请求（后端接口统一为 POST + JSON body） */
+    async post(relativePath, body = {}) {
+        return this.request('POST', relativePath, body);
+    }
+    async request(method, relativePath, body) {
+        const url = this.resolveUrl(relativePath);
+        let response;
+        try {
+            response = await rawRequest({
+                url,
+                method,
+                headers: {
+                    'Content-Type': 'application/json;charset=UTF-8',
+                    Accept: 'application/json, text/plain, */*',
+                    'X-AUTH-TOKEN': this.token,
+                },
+                body: method === 'POST' ? JSON.stringify(body ?? {}) : undefined,
+                timeout: this.timeout,
+            });
+        }
+        catch (err) {
+            const message = err.message || '';
+            if (message.includes('请求超时')) {
+                throw new Error(`请求超时(${this.timeout}ms)：${url}`);
+            }
+            throw new Error(`请求失败：${url}\n  ${message}`);
+        }
+        const rawText = response.text;
+        let payload = null;
+        if (rawText) {
+            try {
+                payload = JSON.parse(rawText);
+            }
+            catch {
+                payload = null;
+            }
+        }
+        if (response.status < 200 || response.status >= 300) {
+            const detail = payload?.msg || payload?.data || rawText.slice(0, 500);
+            const error = new Error(`HTTP ${response.status} ${response.statusText}：${url}\n  ${formatDetail(detail)}`);
+            error.status = response.status;
+            throw error;
+        }
+        if (payload && payload.success === false) {
+            throw new Error(`接口返回失败：${url}\n  ${formatDetail(payload.msg || payload.data)}`);
+        }
+        // 统一剥离 Response 外层信封，直接返回 data
+        if (payload && Object.prototype.hasOwnProperty.call(payload, 'data') && 'success' in payload) {
+            return payload.data;
+        }
+        return (payload ?? rawText);
+    }
+}
+exports.LcodeClient = LcodeClient;
+function formatDetail(detail) {
+    if (detail === null || detail === undefined)
+        return '（无详细信息）';
+    if (typeof detail === 'string')
+        return detail;
+    try {
+        return JSON.stringify(detail);
+    }
+    catch {
+        return String(detail);
+    }
+}

package/dist/commands/app.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAppCommand = registerAppCommand;
+const formDefine_1 = require("../api/formDefine");
+const client_1 = require("../client");
+const config_1 = require("../config");
+const icon_1 = require("../utils/icon");
+const logger_1 = require("../utils/logger");
+function createClient(opts) {
+    return new client_1.LcodeClient((0, config_1.resolveRuntime)({ baseUrl: opts.baseUrl, token: opts.token }));
+}
+/** 非空的 fdId（commander 的 requiredOption 不拦截空字符串） */
+function requireId(value, label = 'id') {
+    const id = String(value ?? '').trim();
+    if (!id) {
+        throw new Error(`${label} 不能为空`);
+    }
+    return id;
+}
+/**
+ * 应用编码合法性（后端校验正则 `^[a-zA-Z-0-9]*$`）：
+ * 只允许字母、数字、连字符，**不含下划线**。
+ */
+function normalizeAppCode(input) {
+    if (input === undefined)
+        return undefined;
+    const code = String(input).trim();
+    if (!code)
+        return undefined;
+    if (!/^[a-zA-Z0-9-]+$/.test(code)) {
+        throw new Error(`非法的应用编码：${code}（平台要求匹配 ^[a-zA-Z-0-9]*$，只允许字母/数字/连字符，不能使用下划线）`);
+    }
+    return code;
+}
+/** 删除类操作需显式 --yes 确认，避免误删 */
+function confirmDestructive(opts, what) {
+    if (opts.yes || opts.force)
+        return true;
+    logger_1.logger.warn(`已取消：删除 ${what} 属于不可逆操作，请追加 --yes 确认执行`);
+    return false;
+}
+/** 列出应用下的表单（删除前保护：让人先看到会连带删掉什么） */
+async function listAppForms(client, fdId) {
+    try {
+        const result = await formDefine_1.modelingXFormApi.list(client, { fdAppId: fdId, pageSize: 200 });
+        return result?.content ?? [];
+    }
+    catch (err) {
+        logger_1.logger.warn(`列出应用下表单失败（不影响删除，但请自行确认）：${err.message}`);
+        return null;
+    }
+}
+function registerAppCommand(program) {
+    const app = program.command('app').description('业务建模应用（低代码应用）相关操作');
+    app
+        .command('list')
+        .description('查询应用列表，获取创建表单所需的 --app-id')
+        .option('--keyword <name>', '按应用名称搜索')
+        .option('--no-auth', '使用不做权限校验的接口（listNotAuth）')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const request = opts.keyword ? { fdName: String(opts.keyword).trim() } : {};
+        const list = opts.auth === false
+            ? await formDefine_1.modelingAppApi.listNotAuth(client, request)
+            : await formDefine_1.modelingAppApi.list(client, request);
+        const apps = Array.isArray(list) ? list : [];
+        if (opts.json) {
+            logger_1.logger.json(apps);
+            return;
+        }
+        logger_1.logger.table(apps.map((item) => ({
+            fdId: item.fdId ?? '',
+            应用名称: item.fdName ?? '',
+            应用编码: item.fdAppCode ?? '',
+            状态: item.fdStatus ?? '',
+        })));
+        logger_1.logger.info(logger_1.color.gray(`共 ${apps.length} 个应用，fdId 即 form create 的 --app-id`));
+    });
+    app
+        .command('get')
+        .description('查看应用详情（含可访问者/可维护者）')
+        .requiredOption('--id <fdId>', '应用 id')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const detail = await formDefine_1.modelingAppApi.edit(client, opts.id);
+        if (opts.json) {
+            logger_1.logger.json(detail);
+            return;
+        }
+        logger_1.logger.title(`应用：${detail.fdName ?? opts.id}`);
+        logger_1.logger.info(`  fdId     = ${detail.fdId}`);
+        logger_1.logger.info(`  应用编码 = ${detail.fdAppCode ?? logger_1.color.gray('（无）')}`);
+        logger_1.logger.info(`  描述     = ${detail.fdDesc ?? logger_1.color.gray('（无）')}`);
+        const visitor = (detail.listVisitor ?? []).map((x) => x.fdName ?? x.fdId);
+        const maintainer = (detail.listMaintainer ?? []).map((x) => x.fdName ?? x.fdId);
+        logger_1.logger.info(`  可访问者 = ${visitor.length ? visitor.join('、') : logger_1.color.gray('（未设置）')}`);
+        logger_1.logger.info(`  可维护者 = ${maintainer.length ? maintainer.join('、') : logger_1.color.gray('（未设置）')}`);
+    });
+    app
+        .command('create')
+        .description('新建低代码应用（后端会同时创建默认首页）')
+        .requiredOption('--name <name>', '应用名称')
+        .option('--code <code>', '应用编码（作为 URL 中的应用标识）')
+        .option('--desc <text>', '应用描述')
+        .option('--category <fdId>', '业务应用分类 id')
+        .option('--icon <icon>', '应用图标（图标名或图标 JSON）')
+        .option('--order <n>', '排序号', (v) => Number(v))
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const vo = {
+            fdName: String(opts.name).trim(),
+            ...(normalizeAppCode(opts.code) ? { fdAppCode: normalizeAppCode(opts.code) } : {}),
+            ...(opts.desc ? { fdDesc: String(opts.desc) } : {}),
+            fdIcon: (0, icon_1.normalizeIcon)(opts.icon),
+            ...(opts.category ? { fdCategory: { fdId: String(opts.category).trim() } } : {}),
+            ...(opts.order !== undefined ? { fdOrder: opts.order } : {}),
+        };
+        logger_1.logger.step(`新建应用：${vo.fdName}`);
+        const created = await formDefine_1.modelingAppApi.add(client, vo);
+        const fdId = created?.fdId ?? created;
+        logger_1.logger.success(`应用创建成功，fdId = ${fdId}`);
+        logger_1.logger.info(logger_1.color.gray('  后端已同时创建默认首页；可用 llc form create --app-id ' + fdId + ' 建表单'));
+        if (opts.json)
+            logger_1.logger.json({ fdId });
+    });
+    app
+        .command('update')
+        .description('修改应用基本信息（名称/编码/描述/图标/分类/排序）')
+        .requiredOption('--id <fdId>', '应用 id')
+        .option('--name <name>', '应用名称')
+        .option('--code <code>', '应用编码')
+        .option('--desc <text>', '应用描述')
+        .option('--category <fdId>', '业务应用分类 id')
+        .option('--icon <icon>', '应用图标（图标名或图标 JSON）')
+        .option('--order <n>', '排序号', (v) => Number(v))
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const fdId = requireId(opts.id, '应用 id');
+        // update 的请求体是 DetailVO：先取编辑页数据，避免丢掉可访问者/可维护者
+        logger_1.logger.step(`加载应用：${fdId}`);
+        const detail = await formDefine_1.modelingAppApi.edit(client, fdId);
+        const patch = {
+            ...(opts.name !== undefined ? { fdName: String(opts.name).trim() } : {}),
+            ...(opts.code !== undefined ? { fdAppCode: String(opts.code).trim() } : {}),
+            ...(opts.desc !== undefined ? { fdDesc: String(opts.desc) } : {}),
+            ...(opts.icon !== undefined ? { fdIcon: (0, icon_1.normalizeIcon)(opts.icon) } : {}),
+            ...(opts.category !== undefined
+                ? { fdCategory: opts.category ? { fdId: String(opts.category).trim() } : undefined }
+                : {}),
+            ...(opts.order !== undefined ? { fdOrder: opts.order } : {}),
+        };
+        const changed = Object.keys(patch).filter((k) => patch[k] !== undefined);
+        if (changed.length === 0) {
+            logger_1.logger.warn('未提供任何修改项，用法示例：llc app update --id <fdId> --name 新名称');
+            return;
+        }
+        logger_1.logger.step(`提交修改：${changed.join('、')}`);
+        await formDefine_1.modelingAppApi.update(client, { ...detail, ...patch });
+        logger_1.logger.success(`应用 ${detail.fdName ?? fdId} 已更新`);
+    });
+    app
+        .command('delete')
+        .description('删除应用（不可逆，会连带删除其下表单；需 --yes 确认）')
+        .requiredOption('--id <fdId>', '应用 id')
+        .option('--yes', '确认执行删除')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const fdId = requireId(opts.id, '应用 id');
+        const client = createClient(opts);
+        // 删除前保护：先列出应用下的表单
+        const forms = await listAppForms(client, fdId);
+        if (forms) {
+            if (forms.length === 0) {
+                logger_1.logger.info('该应用下没有表单');
+            }
+            else {
+                logger_1.logger.title(`该应用下共有 ${forms.length} 个表单，删除应用会一并删除：`);
+                logger_1.logger.table(forms.map((f) => ({
+                    fdId: f.fdId ?? '',
+                    表单名称: f.fdName ?? '',
+                    状态: String(f.fdStatus ?? ''),
+                })));
+            }
+        }
+        if (!confirmDestructive(opts, `应用 ${fdId}`)) {
+            logger_1.logger.info(logger_1.color.gray('确认无误后请执行：llc app delete --id ' + fdId + ' --yes'));
+            return;
+        }
+        if (forms?.length) {
+            logger_1.logger.warn(`即将删除应用及其下 ${forms.length} 个表单（含全部数据模型）`);
+        }
+        logger_1.logger.step(`删除应用：${fdId}`);
+        await formDefine_1.modelingAppApi.remove(client, fdId);
+        logger_1.logger.success(`应用 ${fdId} 已删除`);
+    });
+    app
+        .command('forms')
+        .description('列出应用下的表单（删除前预览用）')
+        .requiredOption('--id <fdId>', '应用 id')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const fdId = requireId(opts.id, '应用 id');
+        const client = createClient(opts);
+        const forms = await listAppForms(client, fdId);
+        if (forms === null)
+            return;
+        if (opts.json) {
+            logger_1.logger.json(forms);
+            return;
+        }
+        if (forms.length === 0) {
+            logger_1.logger.info('该应用下没有表单');
+            return;
+        }
+        logger_1.logger.table(forms.map((f) => ({
+            fdId: f.fdId ?? '',
+            表单名称: f.fdName ?? '',
+            状态: String(f.fdStatus ?? ''),
+        })));
+        logger_1.logger.info(logger_1.color.gray(`共 ${forms.length} 个表单`));
+    });
+    app
+        .command('delete-data')
+        .description('删除应用的业务数据（保留应用定义；需 --yes 确认）')
+        .requiredOption('--id <fdId>', '应用 id')
+        .option('--yes', '确认执行删除')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const fdId = requireId(opts.id, '应用 id');
+        if (!confirmDestructive(opts, `应用 ${fdId} 的业务数据`))
+            return;
+        const client = createClient(opts);
+        logger_1.logger.step(`删除应用业务数据：${fdId}`);
+        await formDefine_1.modelingAppApi.removeData(client, fdId);
+        logger_1.logger.success(`应用 ${fdId} 的业务数据已删除`);
+    });
+}

package/dist/commands/config.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfigCommand = registerConfigCommand;
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+function maskToken(token) {
+    if (!token)
+        return logger_1.color.gray('（未设置）');
+    if (token.length <= 8)
+        return '****';
+    return `${token.slice(0, 4)}****${token.slice(-4)}`;
+}
+function registerConfigCommand(program) {
+    const config = program.command('config').description('管理 CLI 配置（服务端地址、Token）');
+    config
+        .command('set')
+        .description('设置服务端地址与鉴权 Token（写入全局配置 ~/.lcode/config.json）')
+        .option('--base-url <url>', '服务端基址，例如 http://mkdev01.ywork.me/data')
+        .option('--token <token>', '鉴权 Token（请求头 X-AUTH-TOKEN）')
+        .option('--timeout <ms>', '请求超时（毫秒）', (v) => Number(v))
+        .option('--default-form-type <type>', '默认表单类型（1-6）', (v) => Number(v))
+        .action((opts) => {
+        const patch = {};
+        if (opts.baseUrl !== undefined)
+            patch.baseUrl = String(opts.baseUrl).trim().replace(/\/+$/, '');
+        if (opts.token !== undefined)
+            patch.token = String(opts.token).trim();
+        if (opts.timeout !== undefined)
+            patch.timeout = opts.timeout;
+        if (opts.defaultFormType !== undefined)
+            patch.defaultFormType = opts.defaultFormType;
+        if (Object.keys(patch).length === 0) {
+            logger_1.logger.warn('未提供任何配置项，用法示例：llc config set --base-url http://host/data --token xxx');
+            return;
+        }
+        (0, config_1.saveGlobalConfig)(patch);
+        logger_1.logger.success(`配置已写入 ${config_1.GLOBAL_CONFIG_FILE}`);
+        logger_1.logger.info(`  baseUrl: ${patch.baseUrl ?? logger_1.color.gray('（未变更）')}`);
+        if (patch.token !== undefined)
+            logger_1.logger.info(`  token:   ${maskToken(patch.token)}`);
+    });
+    config
+        .command('show')
+        .description('查看当前生效的配置（含环境变量与项目级配置）')
+        .action(() => {
+        const conf = (0, config_1.loadConfig)();
+        const envBaseUrl = process.env.LLC_BASE_URL;
+        const envToken = process.env.LLC_TOKEN;
+        logger_1.logger.title('当前生效配置');
+        logger_1.logger.info(JSON.stringify({
+            全局配置文件: config_1.GLOBAL_CONFIG_FILE,
+            项目配置文件: config_1.PROJECT_CONFIG_FILE,
+            baseUrl: conf.baseUrl ?? null,
+            token: maskToken(conf.token),
+            timeout: conf.timeout ?? 30000,
+            defaultFormType: conf.defaultFormType ?? null,
+            controlMapKeys: Object.keys(conf.controlMap ?? {}),
+            环境变量: {
+                LLC_BASE_URL: envBaseUrl ?? null,
+                LLC_TOKEN: envToken ? maskToken(envToken) : null,
+            },
+        }, null, 2));
+    });
+    config
+        .command('clear')
+        .description('清除全局配置项')
+        .option('--all', '清除全部（baseUrl/token/timeout/defaultFormType）')
+        .action((opts) => {
+        const keys = opts.all
+            ? ['baseUrl', 'token', 'timeout', 'defaultFormType', 'controlMap']
+            : ['baseUrl', 'token'];
+        (0, config_1.clearGlobalConfig)(keys);
+        logger_1.logger.success(`已清除配置项：${keys.join(', ')}`);
+    });
+}