weaver-e10-builder 1.6.15 → 1.7.0

package/dist/services/esb-interface/importer.d.ts

@@ -1,11 +1,45 @@
 import type { ApiClient } from '../../core/client.js';
 import type { InterfaceCreateResult, InterfaceImportResult, PostmanCollection } from './types.js';
+/** 创建接口的完整路径（预检与提交共用同一常量，禁止各写一份） */
+export declare const CREATE_INTERFACE_PATH = "/api/bs/esb/setting/aiconnector/createSystemInterfaceByAi";
+/**
+ * 创建接口不存在时的提示文案：结论只指向平台服务包版本，别往文档/参数上引。
+ * 版本要求来自平台侧确认：260701 基线 ≥ 1.76.0-hotfix7，或 0901 基线 ≥ 1.77.0-hotfix1。
+ */
+export declare const CONNECTOR_INTERFACE_MISSING_MESSAGE: string;
+export type CreateInterfaceProbeVerdict = {
+    outcome: 'exists';
+    reason: string;
+} | {
+    outcome: 'missing';
+    reason: string;
+} | {
+    outcome: 'unknown';
+    reason: string;
+};
+/**
+ * 判定「创建接口是否已部署」的纯函数（可单测，不发请求）。
+ *
+ * 顺序很重要：token 失效与后端 5xx 必须排在「不存在」之前——无 token 时平台对**任何**
+ * `/api` 路径（含完全不存在映射的路径）都回同一个 401，把它当「不存在」会误报版本问题。
+ */
+export declare function classifyCreateInterfaceProbe(probe: {
+    status: number;
+    text: string;
+    json?: any;
+}): CreateInterfaceProbeVerdict;
+/**
+ * 提交前预检：确认目标环境已部署创建接口，未部署则直接抛错并提示服务包版本要求。
+ *
+ * 只发只读 `GET`——创建接口是新增语义、无幂等，绝不能用它本身做存在性试探。
+ */
+export declare function ensureCreateInterfaceAvailable(client: Pick<ApiClient, 'getBaseUrl' | 'probeGet'>): Promise<void>;
 export declare function importInterfaceDocument(sourcePath: string, options?: {
     now?: Date;
     id?: string;
     systemPoolName?: string;
 }): Promise<InterfaceImportResult>;
-export declare function createSystemInterfaces(client: Pick<ApiClient, 'post' | 'getBaseUrl'>, collection: PostmanCollection, options: {
+export declare function createSystemInterfaces(client: Pick<ApiClient, 'post' | 'getBaseUrl' | 'probeGet'>, collection: PostmanCollection, options: {
     systemPoolName: string;
 }): Promise<InterfaceCreateResult>;
 export declare function validateCollection(collection: PostmanCollection): void;

package/dist/services/esb-interface/importer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/services/esb-interface/importer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIlG,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,qBAAqB,CAAC,CAWhC;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC,EAC9C,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAahC;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAsBtE"}
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/services/esb-interface/importer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIlG,oCAAoC;AACpC,eAAO,MAAM,qBAAqB,8DAAwB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,mCAAmC,QAEsC,CAAC;AAuBvF,MAAM,MAAM,2BAA2B,GACnC;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAO3C;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,GAClD,2BAA2B,CAmB7B;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,CAAC,GACjD,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,qBAAqB,CAAC,CAWhC;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC,EAC3D,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAehC;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAsBtE"}

package/dist/services/esb-interface/importer.js

@@ -2,7 +2,81 @@ import { readInterfaceDocument, parseInterfaceDocumentText } from './document-pa
 import { parseInterfaceWorkbook } from './document-parser.js';
 import { extname } from 'node:path';
 import { buildImportResult, collectionNameFromPath } from './postman-collection.js';
-const CREATE_INTERFACE_PATH = '/api/bs/esb/setting/aiconnector/createSystemInterfaceByAi';
+const CONNECTOR_CREATE_PATH = '/api/bs/esb/setting/aiconnector/createSystemInterfaceByAi';
+/** 创建接口的完整路径（预检与提交共用同一常量，禁止各写一份） */
+export const CREATE_INTERFACE_PATH = CONNECTOR_CREATE_PATH;
+/**
+ * 创建接口不存在时的提示文案：结论只指向平台服务包版本，别往文档/参数上引。
+ * 版本要求来自平台侧确认：260701 基线 ≥ 1.76.0-hotfix7，或 0901 基线 ≥ 1.77.0-hotfix1。
+ */
+export const CONNECTOR_INTERFACE_MISSING_MESSAGE = '目标环境未部署 AI 生成连接器接口（createSystemInterfaceByAi）。'
+    + 'weaver-esb-setting 必须为 260701 基线 1.76.0-hotfix7 及以上，或 0901 基线 1.77.0-hotfix1 及以上';
+/** 路由已注册（只是不接受 GET / 缺参数 / 业务校验失败）的状态码 */
+const ROUTE_EXISTS_STATUS = new Set([200, 201, 204, 400, 403, 405, 406, 415, 422, 429]);
+/** 响应体中代表「无此路由」的标记（小写匹配） */
+const MISSING_MARKERS = [
+    '<title>404',
+    '404 not found',
+    'no static resource',
+    'no handler',
+    'no mapping',
+    'whitelabel error page',
+    '路径不存在',
+    '接口不存在',
+];
+/** 响应体中代表「鉴权失败」的标记（小写匹配） */
+const AUTH_MARKERS = ['token为空或失效', 'token empty or invalid', 'token失效', 'token invalid'];
+/** 响应体中代表「后端应用不可用」的标记（小写匹配） */
+const ENV_DOWN_MARKERS = ['/error_500', '后端服务异常', 'bad gateway', 'service unavailable'];
+function hasMarker(text, markers) {
+    const low = (text || '').toLowerCase();
+    return markers.some((marker) => low.includes(marker));
+}
+/**
+ * 判定「创建接口是否已部署」的纯函数（可单测，不发请求）。
+ *
+ * 顺序很重要：token 失效与后端 5xx 必须排在「不存在」之前——无 token 时平台对**任何**
+ * `/api` 路径（含完全不存在映射的路径）都回同一个 401，把它当「不存在」会误报版本问题。
+ */
+export function classifyCreateInterfaceProbe(probe) {
+    const text = probe.text || '';
+    if (probe.status === 302) {
+        return { outcome: 'unknown', reason: '请求被重定向（会话可能已失效），无法判定接口是否存在' };
+    }
+    if (hasMarker(text, AUTH_MARKERS)) {
+        return { outcome: 'unknown', reason: 'Eteamsid 无效或已过期，无法判定接口是否存在，请重新登录后再试' };
+    }
+    if (probe.status >= 500 || hasMarker(text, ENV_DOWN_MARKERS)) {
+        return { outcome: 'unknown', reason: `目标环境后端异常（HTTP ${probe.status}），与接口版本无关，请待环境恢复后重试` };
+    }
+    if (probe.status === 404 || Number(probe.json?.code) === 404 || hasMarker(text, MISSING_MARKERS)) {
+        return { outcome: 'missing', reason: CONNECTOR_INTERFACE_MISSING_MESSAGE };
+    }
+    if (ROUTE_EXISTS_STATUS.has(probe.status)) {
+        return { outcome: 'exists', reason: `接口已部署（HTTP ${probe.status}）` };
+    }
+    return { outcome: 'unknown', reason: `非预期响应（HTTP ${probe.status}），请人工确认该环境是否支持该接口` };
+}
+/**
+ * 提交前预检：确认目标环境已部署创建接口，未部署则直接抛错并提示服务包版本要求。
+ *
+ * 只发只读 `GET`——创建接口是新增语义、无幂等，绝不能用它本身做存在性试探。
+ */
+export async function ensureCreateInterfaceAvailable(client) {
+    const url = `${client.getBaseUrl()}${CREATE_INTERFACE_PATH}`;
+    let probe;
+    try {
+        probe = await client.probeGet(url);
+    }
+    catch (error) {
+        throw new Error(`环境预检失败：无法连接目标环境（${error?.message || error}），已停止提交`);
+    }
+    const verdict = classifyCreateInterfaceProbe(probe);
+    if (verdict.outcome === 'missing')
+        throw new Error(verdict.reason);
+    if (verdict.outcome === 'unknown')
+        throw new Error(`环境预检未能判定，已停止提交：${verdict.reason}`);
+}
 export async function importInterfaceDocument(sourcePath, options = {}) {
     const workbook = ['.xlsx', '.xls'].includes(extname(sourcePath).toLowerCase())
         ? parseInterfaceWorkbook(sourcePath)
@@ -21,6 +95,8 @@ export async function createSystemInterfaces(client, collection, options) {
     if (!systemPoolName)
         throw new Error('systemPoolName 必填且不能为空');
     validateCollection(collection);
+    // 先预检环境是否部署了创建接口：版本过低时直接拦下，避免把版本问题误判成文档/参数问题
+    await ensureCreateInterfaceAvailable(client);
     const response = await client.post(`${client.getBaseUrl()}${CREATE_INTERFACE_PATH}`, { postmanJson: JSON.stringify(collection), systemPoolName });
     const data = response?.data;
     if (response?.code !== 200 || data?.res !== true) {

package/dist/services/esb-interface/importer.js.map

@@ -1 +1 @@
-{"version":3,"file":"importer.js","sourceRoot":"","sources":["../../../src/services/esb-interface/importer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"importer.js","sourceRoot":"","sources":["../../../src/services/esb-interface/importer.ts"],"names":[],"mappings":"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"}

package/dist/services/form-base-setting.d.ts

@@ -0,0 +1,88 @@
+import type { ApiClient } from '../core/client.js';
+type Client = Pick<ApiClient, 'post'>;
+/**
+ * 表单「功能设置」里按段保存的表单级设置（`formmanage` 的 `baseSettingPartType`）。
+ *
+ * 读取：`formmanage/getForm` 带 partType，返回 `data.form.formBaseSetting`；
+ * 保存：`formmanage/saveForm` 带同一 partType + `allowPartialSave:true`，body 放整段 `formBaseSetting`。
+ *
+ * 写策略同台账 list-config：读全量 → 只改点名的键 → 整段回写 → 只回读被改的键。
+ *
+ * ⚠ 数据设置里每一段都有自己的「设置类型」（`*Type`：`system`=读取系统设置 / `custom`=自定义设置）。
+ * 段内单项只有在自定义设置下才按表单自身取值 —— 真机核对：`subBtnType` 为 `system` 时，
+ * `fixBatchOperate` / `rowActionPosition` 根本不出现在保存报文里。所以改段内单项时，
+ * 若该段不是 `custom`，命令会连同「设置类型」一起切成 `custom`（并在结果里标出是自动切换）。
+ */
+export declare const FORM_MANAGE_SETTING_PATH = "/api/ebuilder/form/form/formmanage";
+export declare const FORM_SETTING_MODULE = "ebuilderform";
+/** 已支持的分段：字段设置 / 数据设置。 */
+export type BaseSettingPart = 'field' | 'data';
+export declare const BASE_SETTING_PARTS: BaseSettingPart[];
+/** 段「设置类型」的取值文案。 */
+export declare const MODE_VALUE_LABELS: Record<string, string>;
+/** 一项设置所属的界面区块及其「设置类型」键。 */
+export interface SettingSectionRef {
+    label: string;
+    modeKey: string;
+}
+/** 一个可写项：CLI 选项 ↔ formBaseSetting 键。 */
+export interface SettingOption {
+    /** CLI 长选项名（不含 --） */
+    option: string;
+    /** formBaseSetting 里的键 */
+    key: string;
+    /** 界面文案 */
+    label: string;
+    kind: 'boolean' | 'enum';
+    /** enum 的允许值 → 界面文案 */
+    values?: Record<string, string>;
+    /** 所属区块；段内单项只有在「自定义设置」下才生效 */
+    section?: SettingSectionRef;
+}
+/** 字段设置（`baseSettingPartType:"field"`）。 */
+export declare const FIELD_SETTING_OPTIONS: SettingOption[];
+/** 数据设置（`baseSettingPartType:"data"`）。 */
+export declare const DATA_SETTING_OPTIONS: SettingOption[];
+export declare function optionsOf(part: BaseSettingPart): SettingOption[];
+/** 按选项名找它属于哪一段；找不到返回 null。 */
+export declare function partOfOption(option: string): BaseSettingPart | null;
+/** 读取某一段设置的整段对象。 */
+export declare function readBaseSetting(client: Client, baseUrl: string, appId: string, objId: string, formId: string, part?: string): Promise<Record<string, any>>;
+/** 整段回写某一段设置。 */
+export declare function saveBaseSetting(client: Client, baseUrl: string, appId: string, objId: string, formId: string, part: string, setting: Record<string, any>): Promise<void>;
+export interface SettingChange {
+    /** CLI 选项名；自动切换的设置类型为空串 */
+    option: string;
+    key: string;
+    label: string;
+    from: unknown;
+    to: unknown;
+    /** true = 为了让段内开关生效而自动切换的「设置类型」 */
+    auto?: boolean;
+}
+export interface SettingResult {
+    part: BaseSettingPart;
+    /** true = 所有点名项都已是目标值，未发保存请求 */
+    unchanged: boolean;
+    changes: SettingChange[];
+}
+/**
+ * 修改某一段里的若干设置：只改点名的键（必要时连同该段的设置类型），其余原样回写，保存后回读。
+ *
+ * `values` 的键是 CLI 选项名（不含 `--`）；布尔项传 boolean，枚举项传字符串。
+ */
+export declare function setBaseSetting(client: Client, baseUrl: string, appId: string, objId: string, formId: string, part: string, values: Record<string, boolean | string | undefined>): Promise<SettingResult>;
+/** 字段设置里的「浏览框数据获取最新标题」键。 */
+export declare const BROWSER_LATEST_TITLE_KEY = "currentRelDetail";
+export declare const REL_DETAIL_TYPE_KEY = "currentRelDetailType";
+export declare function readFieldSetting(client: Client, baseUrl: string, appId: string, objId: string, formId: string): Promise<Record<string, any>>;
+export declare function saveFieldSetting(client: Client, baseUrl: string, appId: string, objId: string, formId: string, setting: Record<string, any>): Promise<void>;
+export interface BrowserLatestTitleResult {
+    unchanged: boolean;
+    before: boolean;
+    after: boolean;
+}
+/** 设置「浏览框数据获取最新标题」，保存后回读校验。 */
+export declare function setBrowserLatestTitle(client: Client, baseUrl: string, appId: string, objId: string, formId: string, enabled: boolean): Promise<BrowserLatestTitleResult>;
+export {};
+//# sourceMappingURL=form-base-setting.d.ts.map

package/dist/services/form-base-setting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-base-setting.d.ts","sourceRoot":"","sources":["../../src/services/form-base-setting.ts"],"names":[],"mappings":"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"}

package/dist/services/form-base-setting.js

@@ -0,0 +1,272 @@
+/**
+ * 表单「功能设置」里按段保存的表单级设置（`formmanage` 的 `baseSettingPartType`）。
+ *
+ * 读取：`formmanage/getForm` 带 partType，返回 `data.form.formBaseSetting`；
+ * 保存：`formmanage/saveForm` 带同一 partType + `allowPartialSave:true`，body 放整段 `formBaseSetting`。
+ *
+ * 写策略同台账 list-config：读全量 → 只改点名的键 → 整段回写 → 只回读被改的键。
+ *
+ * ⚠ 数据设置里每一段都有自己的「设置类型」（`*Type`：`system`=读取系统设置 / `custom`=自定义设置）。
+ * 段内单项只有在自定义设置下才按表单自身取值 —— 真机核对：`subBtnType` 为 `system` 时，
+ * `fixBatchOperate` / `rowActionPosition` 根本不出现在保存报文里。所以改段内单项时，
+ * 若该段不是 `custom`，命令会连同「设置类型」一起切成 `custom`（并在结果里标出是自动切换）。
+ */
+export const FORM_MANAGE_SETTING_PATH = '/api/ebuilder/form/form/formmanage';
+export const FORM_SETTING_MODULE = 'ebuilderform';
+export const BASE_SETTING_PARTS = ['field', 'data'];
+/** 段「设置类型」的取值文案。 */
+export const MODE_VALUE_LABELS = {
+    system: '读取系统设置',
+    custom: '自定义设置',
+};
+const FIELD_SECTION = { label: '字段设置', modeKey: 'currentRelDetailType' };
+const LINKAGE_SECTION = { label: '字段联动设置', modeKey: 'linkageFilePermissionType' };
+const DETAIL_BUTTON_SECTION = { label: '明细表按钮设置', modeKey: 'subBtnType' };
+const DATA_LOG_SECTION = { label: '数据日志设置', modeKey: 'insertDataLogType' };
+/** 字段设置（`baseSettingPartType:"field"`）。 */
+export const FIELD_SETTING_OPTIONS = [
+    {
+        // 真机核对（2026-11-05）：开 true / 关 false。
+        option: 'browser-latest-title',
+        key: 'currentRelDetail',
+        label: '浏览框数据获取最新标题',
+        kind: 'boolean',
+        section: FIELD_SECTION,
+    },
+];
+/** 数据设置（`baseSettingPartType:"data"`）。 */
+export const DATA_SETTING_OPTIONS = [
+    {
+        // 整段的设置类型：读取系统设置 / 自定义设置。
+        option: 'linkage-mode',
+        key: 'linkageFilePermissionType',
+        label: '字段联动设置·设置类型',
+        kind: 'enum',
+        values: MODE_VALUE_LABELS,
+        section: LINKAGE_SECTION,
+    },
+    {
+        // 真机核对（2026-11-05）：开 true / 关 false。
+        option: 'file-permission',
+        key: 'linkageFilePermission',
+        label: '启用附件鉴权',
+        kind: 'boolean',
+        section: LINKAGE_SECTION,
+    },
+    {
+        option: 'login-free-execute',
+        key: 'fdLinkageNoLoginExecute',
+        label: '免登场景执行联动',
+        kind: 'boolean',
+        section: LINKAGE_SECTION,
+    },
+    {
+        // 整段的设置类型：读取系统设置 / 自定义设置。
+        option: 'detail-button-mode',
+        key: 'subBtnType',
+        label: '明细表按钮设置·设置类型',
+        kind: 'enum',
+        values: MODE_VALUE_LABELS,
+        section: DETAIL_BUTTON_SECTION,
+    },
+    {
+        option: 'detail-batch-always-visible',
+        key: 'fixBatchOperate',
+        label: '批量操作按钮常显',
+        kind: 'boolean',
+        section: DETAIL_BUTTON_SECTION,
+    },
+    {
+        // 真机核对：float=明细行上 / inline=明细行内。
+        option: 'detail-row-action-position',
+        key: 'rowActionPosition',
+        label: '行操作按钮位置',
+        kind: 'enum',
+        values: { float: '明细行上', inline: '明细行内' },
+        section: DETAIL_BUTTON_SECTION,
+    },
+    {
+        // 整段的设置类型：读取系统设置 / 自定义设置。
+        option: 'data-log-mode',
+        key: 'insertDataLogType',
+        label: '数据日志设置·设置类型',
+        kind: 'enum',
+        values: MODE_VALUE_LABELS,
+        section: DATA_LOG_SECTION,
+    },
+    {
+        // 真机核对（2026-11-05）：按界面顺序，记录表单日志=needDataLog、新建数据记录日志=insertDataLog。
+        option: 'record-form-log',
+        key: 'needDataLog',
+        label: '记录表单日志',
+        kind: 'boolean',
+        section: DATA_LOG_SECTION,
+    },
+    {
+        option: 'insert-data-log',
+        key: 'insertDataLog',
+        label: '新建数据记录日志',
+        kind: 'boolean',
+        section: DATA_LOG_SECTION,
+    },
+];
+export function optionsOf(part) {
+    return part === 'data' ? DATA_SETTING_OPTIONS : FIELD_SETTING_OPTIONS;
+}
+/** 按选项名找它属于哪一段；找不到返回 null。 */
+export function partOfOption(option) {
+    if (FIELD_SETTING_OPTIONS.some((t) => t.option === option))
+        return 'field';
+    if (DATA_SETTING_OPTIONS.some((t) => t.option === option))
+        return 'data';
+    return null;
+}
+function assertOk(response, action) {
+    if (response?.code !== 200 || response?.status === false || response?.fail === true) {
+        throw new Error(`${action}失败: ${response?.msg || '平台未确认成功'}`);
+    }
+}
+function assertPart(part) {
+    if (!BASE_SETTING_PARTS.includes(part)) {
+        throw new Error(`--part 仅支持 ${BASE_SETTING_PARTS.join(' / ')}`);
+    }
+    return part;
+}
+function partLabel(part) {
+    return part === 'data' ? '数据设置' : '字段设置';
+}
+/** 读取某一段设置的整段对象。 */
+export async function readBaseSetting(client, baseUrl, appId, objId, formId, part = 'field') {
+    const partType = assertPart(part);
+    const response = await client.post(`${baseUrl}${FORM_MANAGE_SETTING_PATH}/getForm?apid=${appId}`, {
+        module: FORM_SETTING_MODULE,
+        form: { id: formId },
+        baseSettingPartType: partType,
+        customParam: { appId, objId },
+    }, { ebbusinessid: formId });
+    assertOk(response, `读取表单功能设置·${partLabel(partType)}`);
+    const setting = response?.data?.form?.formBaseSetting;
+    if (!setting || typeof setting !== 'object') {
+        throw new Error(`平台未返回 formBaseSetting（formId=${formId}）`);
+    }
+    return setting;
+}
+/** 整段回写某一段设置。 */
+export async function saveBaseSetting(client, baseUrl, appId, objId, formId, part, setting) {
+    const partType = assertPart(part);
+    const response = await client.post(`${baseUrl}${FORM_MANAGE_SETTING_PATH}/saveForm?apid=${appId}`, {
+        module: FORM_SETTING_MODULE,
+        allowPartialSave: true,
+        baseSettingPartType: partType,
+        form: { id: formId, formBaseSetting: setting },
+        customParam: { appId, objId },
+    }, { ebbusinessid: formId });
+    assertOk(response, `保存表单功能设置·${partLabel(partType)}`);
+}
+function sameValue(a, b) {
+    return a === b;
+}
+/**
+ * 修改某一段里的若干设置：只改点名的键（必要时连同该段的设置类型），其余原样回写，保存后回读。
+ *
+ * `values` 的键是 CLI 选项名（不含 `--`）；布尔项传 boolean，枚举项传字符串。
+ */
+export async function setBaseSetting(client, baseUrl, appId, objId, formId, part, values) {
+    const partType = assertPart(part);
+    const specs = optionsOf(partType);
+    const picked = specs.filter((spec) => values[spec.option] !== undefined);
+    if (!picked.length) {
+        throw new Error('至少指定一项设置；可用：`form base-setting set --help`');
+    }
+    const before = await readBaseSetting(client, baseUrl, appId, objId, formId, partType);
+    const next = { ...before };
+    const changes = [];
+    /** 需要自动切成自定义设置的段 */
+    const promote = new Map();
+    for (const spec of picked) {
+        const target = values[spec.option];
+        if (spec.kind === 'boolean' && typeof target !== 'boolean') {
+            throw new Error(`--${spec.option} 只接受 on/off`);
+        }
+        if (spec.kind === 'enum' && !Object.keys(spec.values || {}).includes(String(target))) {
+            throw new Error(`--${spec.option} 只接受 ${Object.keys(spec.values || {}).join(' / ')}`);
+        }
+        const current = before[spec.key];
+        if (sameValue(current, target))
+            continue;
+        next[spec.key] = target;
+        changes.push({ option: spec.option, key: spec.key, label: spec.label, from: current, to: target });
+        // 段内单项：设置类型不是 custom 时，写了也不生效，自动切换。
+        const section = spec.section;
+        if (section && spec.key !== section.modeKey && before[section.modeKey] !== 'custom') {
+            promote.set(section.modeKey, section);
+        }
+    }
+    // 显式把某段切回读取系统设置时，不能同时改该段其它单项。
+    for (const spec of picked) {
+        const section = spec.section;
+        if (!section || spec.key !== section.modeKey)
+            continue;
+        if (values[spec.option] === 'custom')
+            continue;
+        const conflict = picked.find((p) => p.section?.modeKey === section.modeKey && p.key !== section.modeKey);
+        if (conflict) {
+            throw new Error(`「${section.label}」设置为读取系统设置时，不能同时修改 --${conflict.option}`);
+        }
+    }
+    if (!changes.length) {
+        return { part: partType, unchanged: true, changes: [] };
+    }
+    // 本次已显式设置了某段设置类型时，不再自动补这一段的切换记录。
+    const explicitModes = new Set();
+    for (const spec of picked) {
+        if (spec.section && spec.key === spec.section.modeKey)
+            explicitModes.add(spec.section.modeKey);
+    }
+    const autoChanges = [];
+    for (const section of promote.values()) {
+        if (explicitModes.has(section.modeKey))
+            continue;
+        const from = before[section.modeKey];
+        next[section.modeKey] = 'custom';
+        autoChanges.push({
+            option: '',
+            key: section.modeKey,
+            label: `${section.label}·设置类型`,
+            from,
+            to: 'custom',
+            auto: true,
+        });
+    }
+    const allChanges = [...autoChanges, ...changes];
+    await saveBaseSetting(client, baseUrl, appId, objId, formId, partType, next);
+    // 平台存在 200 但不落库的情况，必须回读断言。
+    const after = await readBaseSetting(client, baseUrl, appId, objId, formId, partType);
+    for (const change of allChanges) {
+        if (!sameValue(after[change.key], change.to)) {
+            throw new Error(`已保存，但回读 ${change.key} 不一致：期望 ${String(change.to)}，实际 ${String(after[change.key])}`);
+        }
+    }
+    return { part: partType, unchanged: false, changes: allChanges };
+}
+// ─── 兼容入口（字段设置） ────────────────────────────────────
+/** 字段设置里的「浏览框数据获取最新标题」键。 */
+export const BROWSER_LATEST_TITLE_KEY = 'currentRelDetail';
+export const REL_DETAIL_TYPE_KEY = 'currentRelDetailType';
+export function readFieldSetting(client, baseUrl, appId, objId, formId) {
+    return readBaseSetting(client, baseUrl, appId, objId, formId, 'field');
+}
+export function saveFieldSetting(client, baseUrl, appId, objId, formId, setting) {
+    return saveBaseSetting(client, baseUrl, appId, objId, formId, 'field', setting);
+}
+/** 设置「浏览框数据获取最新标题」，保存后回读校验。 */
+export async function setBrowserLatestTitle(client, baseUrl, appId, objId, formId, enabled) {
+    const result = await setBaseSetting(client, baseUrl, appId, objId, formId, 'field', { 'browser-latest-title': enabled });
+    const change = result.changes.find((c) => c.key === BROWSER_LATEST_TITLE_KEY);
+    return {
+        unchanged: result.unchanged,
+        before: change ? change.from : enabled,
+        after: enabled,
+    };
+}
+//# sourceMappingURL=form-base-setting.js.map

package/dist/services/form-base-setting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-base-setting.js","sourceRoot":"","sources":["../../src/services/form-base-setting.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,oCAAoC,CAAC;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAIlD,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAEvE,oBAAoB;AACpB,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,OAAO;CAChB,CAAC;AAuBF,MAAM,aAAa,GAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAC5F,MAAM,eAAe,GAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACrG,MAAM,qBAAqB,GAAsB,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAC7F,MAAM,gBAAgB,GAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE9F,2CAA2C;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACpD;QACE,qCAAqC;QACrC,MAAM,EAAE,sBAAsB;QAC9B,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,aAAa;KACvB;CACF,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD;QACE,0BAA0B;QAC1B,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,2BAA2B;QAChC,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,eAAe;KACzB;IACD;QACE,qCAAqC;QACrC,MAAM,EAAE,iBAAiB;QACzB,GAAG,EAAE,uBAAuB;QAC5B,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,eAAe;KACzB;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,GAAG,EAAE,yBAAyB;QAC9B,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,eAAe;KACzB;IACD;QACE,0BAA0B;QAC1B,MAAM,EAAE,oBAAoB;QAC5B,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,qBAAqB;KAC/B;IACD;QACE,MAAM,EAAE,6BAA6B;QACrC,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,qBAAqB;KAC/B;IACD;QACE,iCAAiC;QACjC,MAAM,EAAE,4BAA4B;QACpC,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;QACzC,OAAO,EAAE,qBAAqB;KAC/B;IACD;QACE,0BAA0B;QAC1B,MAAM,EAAE,eAAe;QACvB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,gBAAgB;KAC1B;IACD;QACE,oEAAoE;QACpE,MAAM,EAAE,iBAAiB;QACzB,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,gBAAgB;KAC1B;IACD;QACE,MAAM,EAAE,iBAAiB;QACzB,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,gBAAgB;KAC1B;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAqB;IAC7C,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,qBAAqB,CAAC;AACxE,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3E,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,QAAa,EAAE,MAAc;IAC7C,IAAI,QAAQ,EAAE,IAAI,KAAK,GAAG,IAAI,QAAQ,EAAE,MAAM,KAAK,KAAK,IAAI,QAAQ,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAE,GAAG,IAAI,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAuB,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,cAAc,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAuB,CAAC;AACjC,CAAC;AAED,SAAS,SAAS,CAAC,IAAqB;IACtC,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,oBAAoB;AACpB,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,OAAe,EACf,KAAa,EACb,KAAa,EACb,MAAc,EACd,OAAe,OAAO;IAEtB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,GAAG,OAAO,GAAG,wBAAwB,iBAAiB,KAAK,EAAE,EAC7D;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KAC9B,EACD,EAAE,YAAY,EAAE,MAAM,EAAE,CACzB,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,YAAY,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC;IACtD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAA8B,CAAC;AACxC,CAAC;AAED,iBAAiB;AACjB,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,OAAe,EACf,KAAa,EACb,KAAa,EACb,MAAc,EACd,IAAY,EACZ,OAA4B;IAE5B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,GAAG,OAAO,GAAG,wBAAwB,kBAAkB,KAAK,EAAE,EAC9D;QACE,MAAM,EAAE,mBAAmB;QAC3B,gBAAgB,EAAE,IAAI;QACtB,mBAAmB,EAAE,QAAQ;QAC7B,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE;QAC9C,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KAC9B,EACD,EAAE,YAAY,EAAE,MAAM,EAAE,CACzB,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,YAAY,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AAoBD,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,OAAe,EACf,KAAa,EACb,KAAa,EACb,MAAc,EACd,IAAY,EACZ,MAAoD;IAEpD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,oBAAoB;IACpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAqB,CAAC;QACvD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,aAAa,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,QAAQ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,SAAS;QACzC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnG,oCAAoC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO;YAAE,SAAS;QACvD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,SAAS;QAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QACzG,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,wBAAwB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED,iCAAiC;IACjC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;QACjC,WAAW,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,EAAE;YACV,GAAG,EAAE,OAAO,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,OAAO;YAC9B,IAAI;YACJ,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC;IAEhD,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE7E,2BAA2B;IAC3B,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrF,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,GAAG,WAAW,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACnE,CAAC;AAED,sDAAsD;AAEtD,4BAA4B;AAC5B,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAE1D,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EAAE,OAAe,EAAE,KAAa,EAAE,KAAa,EAAE,MAAc;IAE7E,OAAO,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EAAE,OAAe,EAAE,KAAa,EAAE,KAAa,EAAE,MAAc,EAC7E,OAA4B;IAE5B,OAAO,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAQD,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,OAAe,EACf,KAAa,EACb,KAAa,EACb,MAAc,EACd,OAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,CACpF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IAC9E,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,MAAM,CAAC,IAAgB,CAAC,CAAC,CAAC,OAAO;QACnD,KAAK,EAAE,OAAO;KACf,CAAC;AACJ,CAAC"}

package/dist/services/form-list-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-list-columns.d.ts","sourceRoot":"","sources":["../../src/services/form-list-columns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC;AAC3D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC3E;AACD,MAAM,WAAW,aAAa;IAAG,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE;AAG7H;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,WAAW,CAAC;AAC3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,iBAAiB,CAIhE;AACD,eAAO,MAAM,qBAAqB,2XAAyK,CAAC;AAO5M,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,EAAE,CAsB7D;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAY/D;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAuCvJ;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAQzE;AAQD,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,IAAI;IAAU,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,MAAM;IAFtH,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAC,CAAS;gBACJ,MAAM,EAAE,MAAM,EAAU,IAAI,EAAE,MAAM,EAAU,KAAK,EAAE,MAAM,EAAU,KAAK,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM;IACxH,MAAM,CAAC,QAAQ,SAAO;IAGtB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBtC,IAAI,CAAC,OAAO,EAAE,aAAa;;;;;;;;;;;;;;;;;CAkClC"}
+{"version":3,"file":"form-list-columns.d.ts","sourceRoot":"","sources":["../../src/services/form-list-columns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC;AAC3D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC3E;AACD,MAAM,WAAW,aAAa;IAAG,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE;AAG7H;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,WAAW,CAAC;AAC3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,iBAAiB,CAahE;AACD,eAAO,MAAM,qBAAqB,2XAAyK,CAAC;AAO5M,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,EAAE,CAsB7D;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAY/D;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAuCvJ;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAQzE;AAQD,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,IAAI;IAAU,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,MAAM;IAFtH,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAC,CAAS;gBACJ,MAAM,EAAE,MAAM,EAAU,IAAI,EAAE,MAAM,EAAU,KAAK,EAAE,MAAM,EAAU,KAAK,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM;IACxH,MAAM,CAAC,QAAQ,SAAO;IAGtB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBtC,IAAI,CAAC,OAAO,EAAE,aAAa;;;;;;;;;;;;;;;;;CAkClC"}

package/dist/services/form-list-columns.js

@@ -2,10 +2,19 @@ import { randomUUID } from 'node:crypto';
 import { requirePlatformFieldName } from './field-identity.js';
 const allowed = new Set(['fieldId', 'id', 'text', 'width', 'format', 'decimalLength', 'hidden', 'viewDataDetail']);
 export function resolveFieldLayer(config) {
-    if (config?.type === 'NList')
-        return 'listField';
-    if (Array.isArray(config?.listField) && config.listField.length > 0)
+    // **非空 listField 优先**：列表式/卡片布局一定在 listField 里。
+    // `type === 'NList'` 不能单独当判据 —— 可编辑表格（mode 9/11）同样是 NList，
+    // 但显示列在 tableField，旧逻辑会让 `form list-columns` 读到空的 listField 并误报“没有列”。
+    const listField = Array.isArray(config?.listField) ? config.listField : [];
+    if (listField.length > 0)
         return 'listField';
+    const tableField = Array.isArray(config?.tableField) ? config.tableField : [];
+    if (tableField.length > 0)
+        return 'tableField';
+    // 两边都空：按展示模式兜底。mode 2=列表式、12=卡片布局 → listField；其余（含可编辑表格 8/9/11）→ tableField。
+    if (config?.type === 'NList') {
+        return ['2', '12'].includes(String(config?.mode ?? '')) ? 'listField' : 'tableField';
+    }
     return 'tableField';
 }
 export const LIST_FIELD_LAYER_HINT = '该视图的显示字段在列表式/卡片布局层（listField + cardLayout），form list-columns 只改表格式的 tableField。请改用 `form nlist add-field` / `form nlist remove-field`（增量）或 `form nlist apply`（整份模板）。';