lan-low-code-cli 2.2.0 → 2.3.1

package/README.md

@@ -25,6 +25,11 @@ pnpm link --global    # 可选：全局注册 llc 命令
 > 请勿混用 npm/yarn，以免生成多余的 `package-lock.json` / `yarn.lock`。
 > 常用脚本：`pnpm build`、`pnpm typecheck`、`pnpm start`、`pnpm run rebuild`（clean + build，注意 `pnpm rebuild` 是 pnpm 内置命令，脚本需用 `pnpm run rebuild`）。
 > 非交互式 CI 可使用 `pnpm install --frozen-lockfile`。
+>
+> **打包分发**：`pnpm run pack`（`scripts/pack.js`，注意与 `rebuild` 一样要用 `run`，`pnpm pack` 是 pnpm 内置命令）把 CLI 与 skill 打成压缩包，输出到 `release/`（`dist/` 只放构建产物），
+> 文件名拼接版本号：`lan-low-code-cli-<version>.tgz`、`lan-low-code-cli-skill-<version>.tgz`，
+> 外加 `--with-deps` 的解压即用包（`-standalone`）。默认 tgz（npm 可直接 `npm i -g ./xxx.tgz`），
+> `--format zip|both` 可切换；`--target cli|skill` 只打其一，`--list` 预览文件清单，`--no-build` 跳过构建。
 
 ## 二、鉴权与服务端地址
 
@@ -286,9 +291,11 @@ llc form autofill --id <fdId> --apply --add-field "fd_owner:责任人:address"
 `fdDictType=querySourceDict`、`fdLength=200`，核心配置在 `controlProps` 与 `fdFontExtendData`：
 
 ```
-controlProps.relationCfg  = { appCode, xformName, modelId, tableName, showFields, refFieldName, fdFormType }
+controlProps.relationCfg  = { appCode, xformName, modelId, tableName, refFieldName, fdFormType }
+// refFieldName 是 `$<字段名>$` 引用（如 `$fd_material_name$`），运行时解析为所选记录的显示值；
+// 不能写成 `$<表名>.<字段名>$`（解析不到会把字面量显示出来），relationCfg 也没有 showFields 键
 controlProps.datasource   = { columns:[{name,label}], queryCondition, tree, relationConditions }
-controlProps.outParams    = { params:[{ sourceField:{fdName,tableName,tableType}, targetField:{…} }] }
+controlProps.outParams    = { params:[{ sourceField:{fdName,tableName,tableType}, targetField:{…} }] }（可选）
 controlProps.mappedType / multi / renderMode / direction / rowCount / isForwardView / modelId / modelName
 ```
 
@@ -334,7 +341,7 @@ llc form autofill --id <fdId> --apply \
 |---|---|---|
 | `字段名` | 目标字段物理名（主表或明细表字段，命中后自动改写为 `relation` 控件） | — |
 | `目标表单` | 表单名或 fdId；按名匹配到多份时优先当前表单所属应用，仍歧义则报错列出候选 | — |
-| `显示值=字段` | 存入 `relationCfg.refFieldName`/`showFields`（多项用逗号，写 `$字段名$`/`$标题$`） | 目标表首个文本类业务字段 |
+| `显示值=字段` | 存入 `relationCfg.refFieldName`（写 `$字段名$`，多项用逗号拼接） | 目标表首个文本类业务字段 |
 | `显示项=字段1,字段2` | 存入 `datasource.columns`（设计器强制必填） | 目标表**全部**业务字段 |
 
 解析后会写入：`relationCfg`（业务对象）、`datasource`（数据源骨架 + 显示项 + 筛选项 + 树设置）、

package/dist/commands/form.js

@@ -207,7 +207,7 @@ function parseActionFile(file) {
 /** 打印业务关联解析结果（字段 → 业务对象、显示值、显示项数量） */
 function logRelations(specs) {
     for (const spec of specs) {
-        logger_1.logger.info(`  业务关联：${spec.fieldName} → ${spec.target.xformName}（显示值 ${spec.showFields.replace(/\$/g, '')}，` +
+        logger_1.logger.info(`  业务关联：${spec.fieldName} → ${spec.target.xformName}（显示值 ${spec.refFieldName.replace(/\$/g, '')}，` +
             `显示项 ${spec.columns.length} 项：${spec.columns.map((c) => c.label).join('/')}）`);
     }
 }
@@ -217,16 +217,21 @@ function resolveActions(opts) {
     const fromFile = parseActionFile(opts.actionFile);
     return [...specs, ...fromFile];
 }
-/** 加载已有表单的 formAttr / viewModel / lang（autofill 时用于合并保留） */
+/** 加载已有表单的 attribute / formAttr / viewModel / lang（autofill 时用于合并保留） */
 async function loadPrevDesign(client, family, formId) {
     try {
         const vo = family === 'modeling'
             ? await formDefine_1.modelingXFormApi.loadDesign(client, formId)
             : await formDefine_1.formDefineApi.get(client, formId).catch(() => formDefine_1.designApi.load(client, formId));
         const cfg = typeof vo.fdConfig === 'string' ? JSON.parse(vo.fdConfig) : vo.fdConfig;
-        const formAttr = cfg?.attribute?.formAttr;
+        // attribute 除 formAttr 外还有 dataUnique / subjectRule 等顶层键，整体保留
+        const attribute = cfg?.attribute;
+        const formAttr = attribute?.formAttr;
         const lang = cfg?.lang;
         return {
+            prevAttribute: attribute && typeof attribute === 'object'
+                ? JSON.stringify(attribute)
+                : undefined,
             prevFormAttr: typeof formAttr === 'string' ? formAttr : undefined,
             prevViewModel: Array.isArray(cfg?.viewModel) &&
                 cfg.viewModel.length
@@ -1177,6 +1182,7 @@ function registerFormCommand(program) {
             actions: actionSpecs,
             relations: relationSpecs.length ? relationSpecs : undefined,
             prevFormAttr: prev.prevFormAttr,
+            prevAttribute: prev.prevAttribute,
             prevViewModel: prev.prevViewModel,
             prevLang: prev.prevLang,
         });
@@ -1295,7 +1301,7 @@ function registerFormCommand(program) {
 }
 /** 按接口族发布表单 */
 async function doPublish(client, family, fdId, base, desc = '') {
-    logger_1.logger.step(`发布表单（${FAMILY_LABEL[family]}/publish）`);
+    logger_1.logger.step(`发布表单（${FAMILY_LABEL[family]}/${family === 'modeling' ? 'saveDesignAndPublish' : 'publish'}）`);
     if (family === 'general') {
         const fresh = await formDefine_1.formDefineApi.get(client, fdId);
         await formDefine_1.formDefineApi.publish(client, {
@@ -1307,9 +1313,15 @@ async function doPublish(client, family, fdId, base, desc = '') {
         });
     }
     else if (family === 'modeling') {
-        await formDefine_1.modelingXFormApi.publish(client, {
+        // 必须走 saveDesignAndPublish：`sysModelingXForm/publish` 只把表单置为发布态，
+        // 不会生成「前台默认视图」（默认列表视图 + 应用前台导航菜单）。
+        // 版本/发布态由 saveDesignAndPublish 一并处理，故发布前先取回完整设计数据。
+        const design = await formDefine_1.modelingXFormApi.loadDesign(client, fdId);
+        await formDefine_1.modelingXFormApi.saveDesignAndPublish(client, {
             ...base,
+            ...design,
             fdId,
+            fdBuildNew: true,
             fdDescribe: desc,
         });
     }

package/dist/constants.js

@@ -3,8 +3,8 @@
  * 常量定义：与 sys-xform 前端 util/constant.ts 中的约定保持一致。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_MOBILE_THEME = exports.DEFAULT_DESKTOP_THEME = exports.DEFAULT_FORM_ICON_JSON = exports.DEFAULT_FORM_ICON = exports.FIELD_NAME_PREFIX = exports.LOCALE_PATTERN = exports.LOCALE_ALL = exports.LOCALES = exports.DEFAULT_LOCALE = exports.DEFAULT_SPAN = exports.OPTION_DICT_TYPE = exports.OPTION_CONTROL_TYPES = exports.DETAIL_CONTROL_DEFAULTS = exports.DETAIL_ROW_FLAGS = exports.DETAIL_OPERATIONS = exports.DETAIL_SYSTEM_FIELDS = exports.DETAIL_CONTROL = exports.CONTROL_DESIGNER_NOTES = exports.CONTROL_NOTE_WITHOUT_ERRORS = exports.RELATION_FRONT_EXTEND_PATHS = exports.CONTROL_DEFAULT_PROPS = exports.CONTROL_SEMANTIC_RULES = exports.PLACEHOLDER_LANG_KEY_CANDIDATES = exports.CONTROL_PLACEHOLDER_LANG_KEYS = exports.CONTAINER_CONTROL_TYPES = exports.CONTROL_TYPE_MAP = exports.FALLBACK_CONTROL = exports.DEFAULT_CONTROL_MAP = exports.ELEMENT_ARTIFACT_PREFIX = exports.DEFAULT_SCENE_NAME = exports.DEFAULT_SCENE_CODE = exports.MODELING_ENTITY_CODE = exports.MODELING_ENTITY_NAME = exports.ENTITY_CODE = exports.ENTITY_NAME = exports.MODULE = exports.REQUIRED_PROP_DEFAULTS = exports.I18N_PROP_TABS = exports.TAB_PANE_MOBILE = exports.TAB_PANE = exports.TABS_MOBILE = exports.TABS = exports.TAB_APPEARANCE_MOBILE = exports.TAB_APPEARANCE = exports.LAYOUT_GRID_ITEM = exports.LAYOUT_GRID = exports.LAYOUT = exports.ROW = exports.APPEARANCE = exports.MAIN = void 0;
-exports.DEFAULT_DETAIL_CONTROL_STYLE = exports.DEFAULT_CONTROL_STYLE = void 0;
+exports.FIELD_NAME_PREFIX = exports.LOCALE_PATTERN = exports.LOCALE_ALL = exports.LOCALES = exports.DEFAULT_LOCALE = exports.DEFAULT_SPAN = exports.OPTION_DICT_TYPE = exports.OPTION_CONTROL_TYPES = exports.DETAIL_CONTROL_DEFAULTS = exports.DETAIL_MAIN_FIELD_BASE = exports.DETAIL_MAIN_FIELD_OPERATIONS = exports.DETAIL_ROW_FLAGS = exports.DETAIL_OPERATIONS = exports.DETAIL_SYSTEM_FIELDS = exports.DETAIL_CONTROL = exports.CONTROL_DESIGNER_DEFAULTS = exports.CONTROL_DESIGNER_NOTES = exports.CONTROL_NOTE_WITHOUT_ERRORS = exports.RELATION_FRONT_EXTEND_PATHS = exports.CONTROL_DEFAULT_PROPS = exports.CONTROL_SEMANTIC_RULES = exports.PLACEHOLDER_PANEL_PKGS = exports.PLACEHOLDER_LANG_KEY_CANDIDATES = exports.CONTROL_PLACEHOLDER_LANG_KEYS = exports.CONTAINER_CONTROL_TYPES = exports.CONTROL_TYPE_MAP = exports.FALLBACK_CONTROL = exports.DEFAULT_CONTROL_MAP = exports.ELEMENT_ARTIFACT_PREFIX = exports.DEFAULT_SCENE_NAME = exports.DEFAULT_SCENE_CODE = exports.MODELING_ENTITY_CODE = exports.MODELING_ENTITY_NAME = exports.ENTITY_CODE = exports.ENTITY_NAME = exports.MODULE = exports.REQUIRED_PROP_DEFAULTS = exports.I18N_PROP_TABS = exports.TAB_PANE_MOBILE = exports.TAB_PANE = exports.TABS_MOBILE = exports.TABS = exports.TAB_APPEARANCE_MOBILE = exports.TAB_APPEARANCE = exports.LAYOUT_GRID_ITEM = exports.LAYOUT_GRID = exports.LAYOUT = exports.ROW = exports.APPEARANCE = exports.MAIN = void 0;
+exports.DEFAULT_DETAIL_CONTROL_STYLE = exports.DEFAULT_CONTROL_STYLE = exports.DEFAULT_MOBILE_THEME = exports.DEFAULT_DESKTOP_THEME = exports.DEFAULT_FORM_ICON_JSON = exports.DEFAULT_FORM_ICON = void 0;
 /** 设计器主容器 key */
 exports.MAIN = 'main';
 /** 外观容器 */
@@ -43,7 +43,8 @@ exports.I18N_PROP_TABS = 'tabs';
  * 保持为空并在发布校验时提示（与设计器行为一致，可用 `--force` 跳过）。
  */
 exports.REQUIRED_PROP_DEFAULTS = {
-    '@elem/xform-textarea': { height: '3' },
+    // height 用数字 3（设计器落库为数字；此前误写字符串 '3'）
+    '@elem/xform-textarea': { height: 3 },
     '@elem/xform-rate': { max: 5 },
     '@elem/xform-slider': { min: 0, max: 100 },
     '@elem/xform-rich-text': { height: 300 },
@@ -100,12 +101,12 @@ exports.REQUIRED_PROP_DEFAULTS = {
         trace: false,
     },
     '@elem/xform-dynamic': { direction: 'column', rowCount: 3 },
+    // calculate 的 statisticMode/defaultValueType 由 CONTROL_DESIGNER_DEFAULTS 提供
+    // （设计器新建默认 FORMULA / defalut——平台原样拼写），此处不再覆盖
     '@elem/xform-calculate': {
-        statisticMode: 'SUM',
         statisticData: [],
         showText: false,
         passValue: false,
-        defaultValueType: 'empty',
     },
     '@elem/xform-cfg': {
         renderMode: 'select',
@@ -223,8 +224,22 @@ exports.CONTROL_TYPE_MAP = {
     subject: { desktop: '@elem/xform-subject', mobile: '@elem/xform-m-subject', logicalType: 'subject', dataType: 'varchar' },
     hyperlinks: { desktop: '@elem/xform-hyperlinks', mobile: '@elem/xform-m-hyperlinks', logicalType: 'hyperlinks', dataType: 'clob' },
     timeZone: { desktop: '@elem/xform-time-zone', mobile: '@elem/xform-m-time-zone', logicalType: 'timeZone', dataType: 'varchar' },
-    relation: { desktop: '@elem/xform-relation', mobile: '@elem/xform-m-relation', logicalType: 'relation', dataType: 'relation' },
+    // relation 的 fdLength：设计器创建的关联字段为 200（环境真实字段一致），不能为 0
+    relation: { desktop: '@elem/xform-relation', mobile: '@elem/xform-m-relation', logicalType: 'relation', dataType: 'relation', defaultLength: 200 },
     relationQuery: { desktop: '@elem/xform-relation-query', mobile: '@elem/xform-relation-query', logicalType: 'relationQuery', dataType: 'relation' },
+    // ---------- 取自「手动新建表单」真实落库数据（多选下拉 / 内部主体 / 配置类 / 外观容器） ----------
+    'select~multi': { desktop: '@elem/xform-select~multi', mobile: '@elem/xform-m-select~multi', logicalType: 'select~multi', dataType: 'varchar', dictType: 'optionDict' },
+    internalCompany: { desktop: '@elem/xform-internal-company', mobile: '@elem/xform-m-internal-company', logicalType: 'internalCompany', dataType: 'other', dictType: 'internalCompany', defaultLength: 200 },
+    cfgCurrency: { desktop: '@elem/xform-subject-currency', mobile: '@elem/xform-m-subject-currency', logicalType: 'cfgCurrency', dataType: 'other', dictType: 'cfgCurrency', defaultLength: 200 },
+    cfgExchangeRate: { desktop: '@elem/xform-exchange-rate', mobile: '@elem/xform-m-exchange-rate', logicalType: 'cfgExchangeRate', dataType: 'number', dictType: 'cfgExchangeRate', defaultLength: 200 },
+    cfgVolume: { desktop: '@elem/xform-volume-unit', mobile: '@elem/xform-m-volume-unit', logicalType: 'cfgVolume', dataType: 'other', dictType: 'cfgVolume', defaultLength: 200 },
+    cfgLength: { desktop: '@elem/xform-length-unit', mobile: '@elem/xform-m-length-unit', logicalType: 'cfgLength', dataType: 'other', dictType: 'cfgLength', defaultLength: 200 },
+    cfgMass: { desktop: '@elem/xform-mass-unit', mobile: '@elem/xform-m-mass-unit', logicalType: 'cfgMass', dataType: 'other', dictType: 'cfgMass', defaultLength: 200 },
+    cfgArea: { desktop: '@elem/xform-area-unit', mobile: '@elem/xform-m-area-unit', logicalType: 'cfgArea', dataType: 'other', dictType: 'cfgArea', defaultLength: 200 },
+    cfgTemperature: { desktop: '@elem/xform-temperature-unit', mobile: '@elem/xform-m-temperature-unit', logicalType: 'cfgTemperature', dataType: 'other', dictType: 'cfgTemperature', defaultLength: 200 },
+    collapseAppearance: { desktop: '@elem/xform-collapse-appearance', mobile: '@elem/xform-m-collapse-appearance', logicalType: 'collapseAppearance', dataType: 'varchar', isStored: false, kind: 'container' },
+    tabApproveAppearance: { desktop: '@elem/xform-tab-approve-appearance', mobile: '@elem/xform-tab-approve-appearance', logicalType: 'tabApproveAppearance', dataType: 'varchar', dictType: 'simpleDict', defaultLength: 2000, isStored: true, kind: 'container' },
+    tabAppearance: { desktop: '@elem/xform-tab-appearance', mobile: '@elem/xform-m-tab-appearance', logicalType: 'tabAppearance', dataType: 'varchar', isStored: false, kind: 'container' },
     // ---------- 高级控件 ----------
     // 下列条目的 dataType / dictType / defaultLength / isStored 均取自真实环境：
     // 控件包 `config.json` 的 xform 元数据（`llc control list` 可查）＋ 真实表单落库数据核对。
@@ -304,6 +319,25 @@ exports.PLACEHOLDER_LANG_KEY_CANDIDATES = [
     'enter',
     'pleaseSelect',
 ];
+/**
+ * 面板由设计器拼装（config.json 未声明 placeholder 配置项）、但设计器新建控件时
+ * **同样会写提示文字**的控件包（桌面端；移动端包同名前缀 m- 一并覆盖）→ 兜底文案。
+ *
+ * 依据：「手动新建表单」（设计器拖入不改动直接发布）的落库数据——这些控件均有
+ * placeholder，文案为通用默认（选择类=请选择、输入类=请输入），并非控件自带资源；
+ * 而 radio/checkbox/button/分割线等确实没有。仅凭资源探测会多写（radio 等也被探测到）。
+ */
+exports.PLACEHOLDER_PANEL_PKGS = {
+    '@elem/xform-select~multi': '请选择',
+    '@elem/xform-internal-company': '请选择',
+    '@elem/xform-subject-currency': '请选择',
+    '@elem/xform-exchange-rate': '请输入',
+    '@elem/xform-volume-unit': '请选择',
+    '@elem/xform-length-unit': '请选择',
+    '@elem/xform-mass-unit': '请选择',
+    '@elem/xform-area-unit': '请选择',
+    '@elem/xform-phone-number': '请输入',
+};
 /** 业务关联（relation）的属性面板由平台拼装，故语义规则在此声明 */
 exports.CONTROL_SEMANTIC_RULES = {
     relation: [
@@ -402,6 +436,7 @@ exports.RELATION_FRONT_EXTEND_PATHS = [
     'datasource.isForwardView',
     'datasource.conditionSetting',
     'renderMode',
+    'trace',
     'outParams',
 ];
 /**
@@ -443,6 +478,388 @@ exports.CONTROL_DESIGNER_NOTES = {
     attdemo: '附件（模板）：需在设计器中指定默认附件',
     imageDemo: '图片（模板）：需在设计器中指定默认图片',
 };
+/**
+ * 设计器**新建控件时的默认属性**（逐键取自「手动新建表单」——设计器拖入控件不改动直接发布的落库数据）。
+ *
+ * CLI 生成的字段此前缺少这些键（如 defaultValueType=formula、日期格式、图片/附件限制、
+ * 单位控件的 fdCode/meteringSystem、选项类控件的 $$init 脚本等），导致与设计器创建的控件
+ * 行为不一致。合并顺序：config.json 默认值 → CONTROL_DEFAULT_PROPS → **本表** →
+ * REQUIRED_PROP_DEFAULTS → 已有属性沿用。
+ *
+ * 不含：身份键（id/desktop/mobile/name/uuid/title）、placeholder 与 options（由生成器
+ * 按多语言机制生成）、span、maxLength（随 fdLength）。
+ */
+exports.CONTROL_DESIGNER_DEFAULTS = {
+    "address": {
+        "multi": false,
+        "org": { "orgTypeArr": ["8"], "defaultValueType": "null" },
+        "orgAvailable": false,
+        "passValue": false,
+        "preSelectType": "fixed",
+        "range": "all",
+        "showAvatar": false,
+        "showOrgType": 0,
+        "showText": false,
+        "trace": false,
+    },
+    "area": {
+        "defaultValueType": "null",
+        "passValue": false,
+        "precisionRegion": "county",
+        "selectLevel": "allLevel",
+        "showHierarchy": "all",
+        "showText": false,
+    },
+    "attachment": {
+        "anonymous": false,
+        "customCount": 1,
+        "itemDisplayConfig": ["showCreated", "showCreator", "showOrder", "showSize"],
+        "maxCount": 0,
+        "printContent": "nameOnly",
+        "printLayout": "horizontal",
+        "showText": false,
+        "singleMaxSize": 5242880,
+    },
+    "barcode": {
+        "createEnv": "xform",
+        "defaultValueType": "formula",
+        "height": 40,
+        "saveEnv": true,
+        "showText": false,
+    },
+    "button": {
+        "showText": false,
+    },
+    "calculate": {
+        "defaultValueType": "defalut",
+        "passValue": false,
+        "showText": false,
+        "statisticMode": "FORMULA",
+    },
+    "cfgArea": {
+        "defaultUnit": { "value": "null", "type": "fdUnit" },
+        "fdCode": "area",
+        "meteringSystem": "Metric",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "cfgCurrency": {
+        "currencyShowType": { "label": "货币符号", "value": "fdFlag", "splicing": ["fdFlag"] },
+        "defaultValOpt": "none",
+        "enableRelation": false,
+        "passValue": true,
+        "relationOption": "base",
+        "showSearch": false,
+        "showText": false,
+        "trace": false,
+    },
+    "cfgExchangeRate": {
+        "isGetRate": false,
+        "passValue": false,
+        "showText": false,
+        "sourceCurrency": null,
+        "targetCurrency": null,
+        "trace": false,
+    },
+    "cfgLength": {
+        "defaultUnit": { "value": "null", "type": "fdUnit" },
+        "fdCode": "length",
+        "meteringSystem": "Metric",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "cfgMass": {
+        "defaultUnit": { "value": "null", "type": "fdUnit" },
+        "fdCode": "mass",
+        "meteringSystem": "Metric",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "cfgTemperature": {
+        "defaultUnit": { "value": "null", "type": "fdUnit" },
+        "fdCode": "temperature",
+        "meteringSystem": "Metric",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+        "value": null,
+    },
+    "cfgVolume": {
+        "defaultUnit": { "value": "null", "type": "fdUnit" },
+        "fdCode": "volume",
+        "meteringSystem": "Metric",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "checkbox": {
+        "$$init": "function(e){var t=e.controlProps||{},n=t.options,r=t.value;if((null==n?void 0:n.length)&&void 0===r){var o=n.filter((function(e){return e.checked}));if(null==o?void 0:o.length){var l=o.map((function(e){return e.value}));return e.controlProps.value=l,l}}}",
+        "defaultValueType": "fixed",
+        "direction": "column",
+        "multi": true,
+        "optionSource": "custom",
+        "passValue": false,
+        "rowCount": 3,
+        "serialType": "empty",
+        "showText": false,
+        "trace": false,
+    },
+    "collapseAppearance": {
+        "alignTitle": "left",
+        "canChangeSpan": false,
+        "isExpand": "expand",
+        "selectedNodes": [],
+        "visible": true,
+    },
+    "desc": {
+        "alignDesc": "left",
+        "controlTitleStyle": { "color": "#000000", "fontSize": 14 },
+    },
+    "dividing": {
+        "$$preset": { "styleSelect": { "default": { "titleStyle": { "color": "#000000" } }, "line": { "titleStyle": { "color": "#000000" } }, "flag-line": { "titleStyle": { "color": "#000000" } }, "italics-block": { "titleStyle": { "color": "#ffffff" } }, "custom-default": { "titleStyle": { "color": "#000000" } } } },
+    },
+    "hyperlinks": {
+        "defaultValueType": "fixed",
+        "largestSet": "infinit",
+        "showText": false,
+    },
+    "image": {
+        "anonymous": false,
+        "maxCount": 0,
+        "onlyMobileUpload": false,
+        "pcUpload": false,
+        "showImgSetting": { "type": ["dataSize", "attachName"] },
+        "showText": false,
+        "singleMaxSize": 5242880,
+    },
+    "internalCompany": {
+        "passValue": false,
+        "selectRange": 0,
+        "showText": false,
+        "trace": false,
+    },
+    "interval": {
+        "backgroundColor": "#F8F8F8",
+        "controlWidth": "default",
+        "height": 16,
+        "marginBottom": 16,
+        "marginTop": 16,
+        "maxColor": "#F8F8F8",
+    },
+    "location": {
+        "allowed": true,
+        "isLocationCenter": false,
+        "mapContent": { "address": "formattedAddress" },
+        "passValue": false,
+        "searchNearBy": { "isLocation": false, "checkboxvalue": false, "inputvalue": "300" },
+        "selectable": false,
+        "showText": false,
+    },
+    "mechnumber": {
+        "fdSysNumber": { "fdEntityName": "com.landray.sys.modeling.core.entity.main.SysModelingMainEntity", "fdContentClob": "[{\"name\":\"20200314\",\"type\":\"date\",\"error\":false,\"ruleData\":{\"zone\":\"中文(中国)\",\"format\":\"yyyyMMdd\"},\"id\":\"1\"}]", "fdVirtualNumberValue": "20200314", "fdName": "fd_col_kty5pq", "fdDefaultFlag": false, "fdTemplateFlag": true, "fdId": "1k4n6g2p5wcw7erbw21a52243ukdo6f1daw0" },
+        "fdType": "2",
+        "showText": false,
+    },
+    "moneytext": {
+        "defaultValueType": "formula",
+        "passValue": false,
+        "precision": 2,
+        "showCount": true,
+        "showText": false,
+        "symbol": "",
+        "trace": false,
+    },
+    "numbertext": {
+        "defaultValueType": "formula",
+        "numberFormat": { "formatType": "base", "percentage": null, "precision": null, "groupingUsed": null, "symbol": null, "unit": "" },
+        "passValue": false,
+        "showCount": true,
+        "showText": false,
+        "trace": false,
+    },
+    "phoneNumber": {
+        "defaultValueType": "formula",
+        "international": true,
+        "passValue": false,
+        "showText": false,
+    },
+    "qrcode": {
+        "createEnv": "xform",
+        "fdIsStored": false,
+        "modelName": "com.landray.sys.xform.core.entity.design.SysXFormDesign",
+        "pageType": 2,
+        "saveEnv": true,
+        "showText": false,
+        "size": "160px",
+    },
+    "radio": {
+        "$$init": "function(e){var t=e.controlProps||{},r=t.options,n=t.value;if((null==r?void 0:r.length)&&void 0===n){var o=r.find((function(e){return e.checked}));if(void 0!==o){var a=o.value;return e.controlProps.value=a,a}}}",
+        "defaultValueType": "fixed",
+        "direction": "column",
+        "optionSource": "custom",
+        "passValue": false,
+        "rowCount": 3,
+        "serialType": "empty",
+        "showText": false,
+        "trace": false,
+    },
+    "rate": {
+        "defaultValue": 0,
+        "defaultValueType": "fixed",
+        "max": 5,
+        "rateColor": { "option": "fix", "color": "#F6CD14" },
+        "rateIcon": "iconCommon_combine_30_gradeStar",
+        "rateSet": [],
+        "showCustomRes": false,
+        "showText": false,
+    },
+    "relation": {
+        "direction": "column",
+        "isForwardView": "no",
+        "modelName": "com.landray.sys.xform.core.entity.design.SysXFormDesign",
+        "multi": false,
+        "passValue": false,
+        "renderMode": "singlelist",
+        "rowCount": 3,
+        "showText": false,
+        "trace": false,
+    },
+    "rich-text": {
+        "defaultValueFormulaVO": {},
+        "defaultValueType": "formula",
+        "height": 400,
+        "passValue": false,
+        "resize": true,
+        "showText": false,
+        "trace": false,
+        "viewPageSet": { "isSystem": true, "displayMode": "adaptive" },
+    },
+    "select": {
+        "$$init": "function(e){var t=(e||{}).controlProps||{},r=t.value,n=t.multi,o=t.options;if(void 0===r&&(null==o?void 0:o.length)){if(n){var l=o.filter((function(e){return e.checked})),a=(null==l?void 0:l.length)?l.map((function(e){return e.value})):void 0;return e.controlProps.value=a,a}var i=o.find((function(e){return e.checked})),u=i?i.value:void 0;return e.controlProps.value=u,u}}",
+        "defaultValueType": "fixed",
+        "multi": false,
+        "optionSource": "custom",
+        "passValue": false,
+        "showSearch": false,
+        "showText": false,
+        "trace": false,
+    },
+    "select~multi": {
+        "$$init": "function(e){var t=(e||{}).controlProps||{},r=t.value,n=t.multi,o=t.options;if(void 0===r&&(null==o?void 0:o.length)){if(n){var l=o.filter((function(e){return e.checked})),a=(null==l?void 0:l.length)?l.map((function(e){return e.value})):void 0;return e.controlProps.value=a,a}var i=o.find((function(e){return e.checked})),u=i?i.value:void 0;return e.controlProps.value=u,u}}",
+        "defaultValueType": "fixed",
+        "multi": true,
+        "optionSource": "custom",
+        "passValue": false,
+        "showSearch": false,
+        "showText": false,
+        "trace": false,
+    },
+    "serial-number": {
+        "canChangeSpan": false,
+    },
+    "slider": {
+        "$$init": "function(e){var t=(e||{}).controlProps||{},r=t.value,n=t.min;if(void 0===r){var o=void 0!==n?n:0;return e.controlProps.value=o,o}}",
+        "color": "",
+        "columnWidth": "100",
+        "max": 100,
+        "min": 0,
+        "showText": false,
+        "step": 1,
+        "value": 0,
+    },
+    "switch": {
+        "$$init": "function(e){var t=e.controlProps||{},o=t.defaultValue,r=t.value;o&&void 0===r&&(e.controlProps.value=\"yes\"===o)}",
+        "closeCfg": { "colorMap": { "background": { "label": "背景", "color": "#c3c3c3" }, "font": { "label": "文字", "color": "#fff" } } },
+        "defaultValue": "yes",
+        "defaultValueType": "fixed",
+        "openCfg": { "colorMap": { "background": { "label": "背景", "color": "#4285F4" }, "font": { "label": "文字", "color": "#fff" } } },
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "tabAppearance": {
+        "canChangeSpan": false,
+    },
+    "tabApproveAppearance": {
+        "canChangeSpan": false,
+    },
+    "text": {
+        "aiFill": false,
+        "defaultValueType": "formula",
+        "encrypt": false,
+        "encryptMonth": 9999,
+        "failureRule": "ANONYMIZE",
+        "maskFormatType": "********",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "textarea": {
+        "aiFill": false,
+        "defaultValueType": "formula",
+        "encrypt": false,
+        "encryptMonth": 9999,
+        "failureRule": "ANONYMIZE",
+        "height": 3,
+        "maskFormatType": "********",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+        "viewPageSet": { "isSystem": true, "displayMode": "adaptive" },
+    },
+    "timeAxis": {
+        "axisFieldsStyle": { "fontStyle": { "fontSize": 16 } },
+        "contentFields": ["fd_material_name", "fd_spec"],
+        "contentStyle": { "fontSize": 12, "color": "#666" },
+        "coordinateField": { "coordinateField": "fd_material_name", "fieldDataType": "text" },
+        "dataSheet": { "fdFormId": "1k4ihquulwdw2v2rw21ni5op3jhum26atdw0", "tableName": "mk_model_202610102twt1", "fdApp": { "fdName": "物料管理", "fdId": "1k4ihq0uowdw2u0sw1dfved73ul9gvcv1uw0", "fdAppCode": "material-mgmt" }, "modelId": "sys-modeling#1k4ihquulwdw2v2rw21ni5op3jhum26atdw0" },
+        "dataSource": "associated_table",
+        "displayDirection": "vertical",
+        "displayMethod": "tile",
+        "isForwardView": "no",
+        "maxHeight": 600,
+        "maxPageSize": 10,
+        "openWay": { "_target": "blank" },
+        "showText": false,
+        "sortOrder": "default",
+        "timeAxisContents": [{ "key": "coordinate1" }],
+    },
+    "timepicker": {
+        "dataPattern": "HH/mm",
+        "dataStep": 1,
+        "dateRange": { "startTime": 0, "endTime": 86399000 },
+        "defaultValueType": "null",
+        "displayPattern": "HH:mm",
+        "passValue": false,
+        "showText": false,
+        "timeRange": "fixed",
+    },
+    "timestamp": {
+        "$$init": "function(e){var t=(e||{}).controlProps||{},r=t.defaultValueType,n=t.value;if(\"now\"===r&&void 0===n){var o=(new Date).valueOf();return e.controlProps.value=o,o}}",
+        "dataPattern": "yyyy-MM-dd",
+        "defaultValueType": "null",
+        "displayPattern": "yyyy年MM月DD日",
+        "passValue": false,
+        "showText": false,
+        "trace": false,
+    },
+    "timeZone": {
+        "displayStyle": "button",
+        "passValue": true,
+        "showText": false,
+        "timeZoneplaceholder": "!{mv4retk3sy39207n5mi}",
+    },
+    "video": {
+        "anonymous": false,
+        "maxCount": 0,
+        "showText": false,
+        "singleMaxSize": 5242880,
+        "supportList": false,
+    },
+};
 /** 明细表控件（数据项类型为 varchar，控件逻辑类型 detail） */
 exports.DETAIL_CONTROL = {
     desktop: '@elem/xform-detail-table',
@@ -468,6 +885,31 @@ exports.DETAIL_OPERATIONS = {
 };
 /** 明细表行操作开关（auth 顶层） */
 exports.DETAIL_ROW_FLAGS = { add: { canAddRow: true, canDeleteRow: true, canImport: true } };
+/**
+ * 明细表在**主表** auth 条目中的行操作：
+ * `auth[0].{add|edit|view}[主表名].fields[明细表名].operations`。
+ *
+ * 设计器把明细表当作主表字段权限里的一个条目（`store/auth/utils.ts`），条目形如
+ * `{ visible, editable, required, hide, operations }`；运行时/渲染依赖其中的
+ * operations 渲染明细表顶部操作栏（添加行/删除行/导入/导出）。
+ * 注意 showType 与明细表自身条目（`DETAIL_OPERATIONS`，always）不同：
+ * add/edit 为 edit，view 为 onlyView——真实表单核对结论。
+ */
+exports.DETAIL_MAIN_FIELD_OPERATIONS = {
+    add: [
+        { id: 'canAddRow', label: '添加行', messageKey: 'sys-xform:detail.operation.addRow', showType: 'edit', type: 'operation' },
+        { id: 'canDeleteRow', label: '删除行', messageKey: 'sys-xform:detail.operation.deleteRow', showType: 'edit', type: 'operation' },
+        { id: 'canImport', label: '导入', messageKey: 'sys-xform:detail.operation.import', showType: 'edit', type: 'operation' },
+    ],
+    view: [
+        { id: 'canExport', label: '导出', messageKey: 'sys-xform:detail.operation.export', showType: 'onlyView', type: 'view' },
+    ],
+};
+/** 明细表在主表 auth 条目中的基础权限（add/edit 与 view 键不同） */
+exports.DETAIL_MAIN_FIELD_BASE = {
+    add: { visible: true, editable: true, required: false, hide: false },
+    view: { visible: true, hide: false },
+};
 /**
  * 明细表控件的默认属性。
  *

package/dist/generator/index.js

@@ -21,8 +21,14 @@ const MODELING_MODEL_NAME = 'com.landray.sys.xform.core.entity.design.SysXFormDe
 /**
  * 构建业务关联的 `controlProps` 片段（`relationCfg` + `datasource` + 显示方式）。
  *
- * `datasource` 的骨架键取自真实表单（queryCondition/tree/filters/isListThrough…），
- * 这些是设计器「列表设置」弹窗的固有字段，缺失会导致设计器打开该控件时结构不完整。
+ * 骨架逐键对齐**设计器手动创建的真实字段**（物料入库单 `fd_col_9bg1ms`）：
+ * - `refFieldName` 是 `$<字段名>$` 引用（运行时解析为所选记录的显示值）——
+ *   早期版本误写成 `$<表名>.<字段名>$`，运行时解析不到就会把字面量显示出来；
+ * - 不写 `showFields`（设计器不生成该键）；
+ * - `datasource.queryCondition` 是 `{ linkType, query: {} }`——带 `conditionGroup` 的
+ *   完整条件结构会导致运行时**列表加载失败**；
+ * - `isDisplayMode` 必须为 `false`（true 是「仅展示」模式）；
+ * - 不写 `queryCollection` / `sorters` / `querySorters`（设计器未配置时不生成）。
  */
 function buildRelationProps(spec) {
     const { target } = spec;
@@ -34,7 +40,6 @@ function buildRelationProps(spec) {
             appCode: target.appCode,
             xformName: target.xformName,
             modelId: target.modelId,
-            showFields: spec.showFields,
             refFieldName: spec.refFieldName,
             tableType: 'main',
             tableName: target.tableName,
@@ -43,7 +48,7 @@ function buildRelationProps(spec) {
         datasource: {
             queryCondition: { linkType: '$and', query: {} },
             columns,
-            filters: spec.filters ?? columns,
+            filters: spec.filters ?? [],
             tree: {
                 treeLoop: true,
                 querySorters: [],
@@ -52,17 +57,17 @@ function buildRelationProps(spec) {
                 relationConditions: [{ operator: { value: '$eq' }, value: { format: 'field' } }],
                 queryCondition: {
                     linkType: '$and',
-                    query: { type: 'conditionGroup', orAndOperator: 'type', condition: [] },
+                    query: { type: 'conditionGroup', condition: [] },
                 },
                 navigationMode: 'custom',
+                // 树导航的实体引用（sys-modeling#<表单fdId>），设计器创建的字段必有
+                entityName: `sys-modeling#${target.modelId}`,
             },
             isListThrough: true,
-            isDisplayMode: true,
+            isDisplayMode: false,
             viewId: '',
             conditionSetting: false,
             isForwardView: true,
-            queryCollection: {},
-            sorters: [],
         },
         ...(spec.outParams ? { outParams: spec.outParams } : {}),
     };
@@ -343,6 +348,7 @@ async function resolveControl(field, options) {
         logicalType: preserved
             ? field.fdType || preserved.logicalType
             : meta?.xform?.type || entry.logicalType,
+        kind: entry.kind ?? 'control',
         meta,
         metaMobile,
     };
@@ -469,7 +475,12 @@ function buildFieldAttribute(params) {
     const prev = params.prevControlProps;
     const prevPkg = prev?.desktop?.type;
     if (prev && prevPkg === resolved.desktopPkg) {
+        // 业务关联重建时（extraControlProps 提供 relationCfg/datasource），旧字段可能带着
+        // 早期版本写入的空 outParams——设计器创建的字段没有这个键，不沿用
+        const skipStaleOutParams = params.extraControlProps != null && !('outParams' in params.extraControlProps);
         for (const [propKey, value] of Object.entries(prev)) {
+            if (skipStaleOutParams && propKey === 'outParams')
+                continue;
             if (!CONTROL_PROP_MANAGED_KEYS.has(propKey))
                 carried[propKey] = value;
         }
@@ -480,6 +491,9 @@ function buildFieldAttribute(params) {
         ...(constants_1.CONTROL_DEFAULT_PROPS[resolved.desktopPkg] ?? {}),
         // 必填属性兜底默认值（config.json 声明 required 但无 default 的项）
         ...requiredDefaults,
+        // 设计器新建控件的默认属性（逐键取自设计器落库，见 CONTROL_DESIGNER_DEFAULTS）——
+        // 按控件逻辑类型匹配，修正 CLI 与设计器新建控件的默认值差异
+        ...(constants_1.CONTROL_DESIGNER_DEFAULTS[resolved.logicalType] ?? {}),
         ...carried,
         ...params.fontExtend,
         ...(params.extraControlProps ?? {}),
@@ -513,7 +527,7 @@ function buildFieldAttribute(params) {
     const config = {
         key,
         type: logicalType,
-        kind: 'control',
+        kind: resolved.kind,
         label: langKey,
         controlProps,
         labelProps,
@@ -559,10 +573,9 @@ function enrichField(field, model, resolved) {
                     passValue: false,
                     trace: false,
                     encrypt: false,
-                    // 初始值模式：config.json 默认 'null'（无初始值）。不能写 'formula'——
-                    // 公式模式下 defaultValueFormulaVO 必填，设计器提交会被拦截
-                    defaultValueType: 'null',
                     encryptDefinition: {},
+                    // 注意：不写 defaultValueType——由 CONTROL_DESIGNER_DEFAULTS 提供各控件
+                    // 的设计器默认值（formula/fixed/defalut…），并在构建后回同步到此处
                 });
     }
     if (!field.fdIsSystem && (field.fdOrder === undefined || field.fdOrder === null)) {
@@ -603,7 +616,11 @@ async function buildField(field, model, options, lang, locales) {
     //    area=pleaseSelect，其余=placeholder），键名不对就取不到文案（日期控件提示文字缺失即此原因）。
     let placeholderKey;
     const registry = options.registry;
-    if (registry && (0, widgets_1.hasConfigItem)(resolved.meta, 'placeholder')) {
+    // 门控：config.json 声明了 placeholder 的控件 + 面板由设计器拼装（config.json 未声明
+    // 但设计器新建时同样写提示文字）的控件。两者都不满足的（radio/checkbox/button 等）
+    // 设计器也不写提示文字——不能仅凭资源探测，否则会多写（已与设计器新建表单核对）
+    if (registry &&
+        ((0, widgets_1.hasConfigItem)(resolved.meta, 'placeholder') || constants_1.PLACEHOLDER_PANEL_PKGS[resolved.desktopPkg])) {
         const prevPlaceholder = prevAttr?.config?.controlProps?.placeholder;
         const prevLangEntry = typeof prevPlaceholder === 'string' ? options.prevLang?.[prevPlaceholder] : undefined;
         if (typeof prevPlaceholder === 'string' &&
@@ -636,6 +653,20 @@ async function buildField(field, model, options, lang, locales) {
                 };
                 break;
             }
+            // 拼装面板控件（config.json 未声明 placeholder）：控件资源探测不到时使用
+            // 设计器的通用默认文案（选择类=请选择、输入类=请输入，见 PLACEHOLDER_PANEL_PKGS）
+            if (!placeholderKey) {
+                const fallbackText = constants_1.PLACEHOLDER_PANEL_PKGS[resolved.desktopPkg];
+                if (fallbackText) {
+                    placeholderKey = (0, random_1.generateMessageKey)();
+                    lang[placeholderKey] = {
+                        prop: 'placeholder',
+                        name: field.fdName,
+                        type: 'input',
+                        content: buildLangContent(locales, fallbackText, undefined, options.messages),
+                    };
+                }
+            }
         }
     }
     // 新建选项（--option）：写入 fdFontExtendData.options，作为选项的唯一来源
@@ -667,6 +698,21 @@ async function buildField(field, model, options, lang, locales) {
             label: item?.label,
             value: item?.value,
         }));
+    // 选项类控件缺省选项：对齐设计器新建时的默认选项（选项1/2/3，值 1/2/3，含多语言）。
+    // CLI 此前不写默认选项，下拉/单选/多选运行时是空选项（真实缺陷，已与设计器新建表单核对）
+    const defaultOptions = !prevOptions.length && !specified?.length &&
+        ['radio', 'checkbox', 'select', 'select~multi'].includes(String(field.fdType))
+        ? ['1', '2', '3'].map((value, i) => {
+            const key = (0, random_1.generateMessageKey)();
+            lang[key] = {
+                prop: 'option',
+                name: field.fdName,
+                type: 'input',
+                content: buildLangContent(locales, `选项${i + 1}`, undefined, options.messages),
+            };
+            return { label: key, value };
+        })
+        : undefined;
     const { attribute, config } = buildFieldAttribute({
         fieldUuid: field.uuid,
         langKey,
@@ -678,19 +724,34 @@ async function buildField(field, model, options, lang, locales) {
         resolved,
         placeholderKey,
         fontExtend: fontExtendOf(field),
-        options: prevOptions.length ? prevOptions : undefined,
+        options: prevOptions.length ? prevOptions : defaultOptions,
         prevControlProps: prevAttr?.config?.controlProps,
         extraControlProps: relationSpec ? buildRelationProps(relationSpec) : undefined,
     });
     field.fdAttribute = attribute;
     // 前端扩展数据同步（如 address 的 orgTypeArr/multi/range）
     syncFontExtendData(field, resolved.meta, (config.controlProps ?? {}));
+    // fdFontExtendData.defaultValueType 与 controlProps 保持一致（设计器行为：
+    // 新建控件的默认初始值模式为 formula/fixed/defalut 等，见 CONTROL_DESIGNER_DEFAULTS）
+    {
+        const feObj = (0, random_1.safeJsonParse)(field.fdFontExtendData, {});
+        const cpObj = (config.controlProps ?? {});
+        if (cpObj.defaultValueType !== undefined && feObj.defaultValueType !== cpObj.defaultValueType) {
+            feObj.defaultValueType = cpObj.defaultValueType;
+            field.fdFontExtendData = JSON.stringify(feObj);
+        }
+    }
     // 业务关联的前端扩展数据（控件源码 JSDoc 声明的 @frontExtendData 路径）：
     // modelId/refFieldName/tableType/tableName、datasource 各键、renderMode、outParams
     if (relationSpec) {
         const fontExtend = field.fdFontExtendData
             ? (0, random_1.safeJsonParse)(field.fdFontExtendData, {})
             : {};
+        // 早期版本生成、现在不再写的键：清掉，避免运行时拿到过期结构
+        for (const stale of ['queryCollection', 'querySorters', 'sorters'])
+            delete fontExtend[stale];
+        if (!relationSpec.outParams)
+            delete fontExtend.outParams;
         const props = (config.controlProps ?? {});
         for (const path of constants_1.RELATION_FRONT_EXTEND_PATHS) {
             const value = getByPath(props, path);
@@ -932,6 +993,9 @@ function wrapAppearance(tableName, children) {
                 key: constants_1.MAIN,
                 type: constants_1.MAIN,
                 kind: 'container',
+                // 设计器保存时经 setMainCmpt 写入（ide/editor/runtime/business/feature.ts），
+                // 值为空也必须带键：CLI 曾缺失该属性，与设计器发布的视图不一致
+                controlProps: { importBtn: null, onDesktopImport: null },
                 children,
             },
         ],
@@ -943,7 +1007,7 @@ function wrapAppearance(tableName, children) {
  * 注意：栅格布局（`layout` / `@elem/layout-grid` / `GridItem`）**不写入**此处，
  * 而多页签（`tab-appearance` / `tabs` / `tabpane`）**需要写入** —— 均为真实表单核对结论。
  */
-function buildControlMappings(built, options = {}) {
+function buildControlMappings(built, options = {}, details = []) {
     /** 布局控件的兜底元数据（控件包无 xform 时用，与真实表单的 xform.type 一致） */
     const layoutDefaults = {
         [constants_1.TAB_APPEARANCE]: 'tabAppearance',
@@ -953,11 +1017,13 @@ function buildControlMappings(built, options = {}) {
     const build = (platform) => {
         const seen = new Set();
         const list = [];
-        built.forEach((item) => {
+        // **主表 + 明细字段**的控件都要进映射：运行时按 controlMappings 解析控件，
+        // 明细字段的控件缺失时明细表渲染不完整（如顶部操作栏不出现）——真实缺陷已核对
+        for (const item of [...built, ...details.flatMap((d) => d.fields)]) {
             const pkg = platform === 'desktop' ? item.resolved.desktopPkg : item.resolved.mobilePkg;
             const meta = platform === 'desktop' ? item.resolved.meta : item.resolved.metaMobile;
             if (!pkg || seen.has(pkg))
-                return;
+                continue;
             seen.add(pkg);
             const xform = { ...(meta?.xform ?? {}), type: item.resolved.logicalType };
             // 前端 handleFindXFormWidgets 会把包级 env 同步进 xform.env
@@ -966,7 +1032,7 @@ function buildControlMappings(built, options = {}) {
                 xform.env = meta.env;
             }
             list.push({ name: pkg, platform, xform });
-        });
+        }
         if (options.layout === 'tabs') {
             const pkgs = platform === 'desktop'
                 ? [constants_1.TAB_APPEARANCE, constants_1.TABS, constants_1.TAB_PANE]
@@ -1001,7 +1067,7 @@ function buildViewModel(built, mainTableName, options = {}, lang = {}, locales =
     });
     // 页签多语言只生成一次，供桌面端渲染树复用
     const panes = options.layout === 'tabs' ? resolveTabs(built, options, lang, locales) : [];
-    const mappings = buildControlMappings(built, options);
+    const mappings = buildControlMappings(built, options, details);
     if (detailMappings?.desktop.length)
         mappings.desktop.push(...detailMappings.desktop);
     if (detailMappings?.mobile.length)
@@ -1076,7 +1142,7 @@ function buildAuth(models, options = {}) {
                     hide: false,
                     ...perm.edit?.[field.fdName],
                 };
-                viewFields[field.fdName] = { visible: true, ...perm.view?.[field.fdName] };
+                viewFields[field.fdName] = { visible: true, hide: false, ...perm.view?.[field.fdName] };
             });
             add[model.fdTableName] = {
                 ...constants_1.DETAIL_ROW_FLAGS.add,
@@ -1113,7 +1179,28 @@ function buildAuth(models, options = {}) {
                 hide: false,
                 ...perm.edit?.[field.fdName],
             };
-            viewFields[field.fdName] = { visible: true, ...perm.view?.[field.fdName] };
+            viewFields[field.fdName] = { visible: true, hide: false, ...perm.view?.[field.fdName] };
+        });
+        // 明细表在主表 auth 中以「字段条目」出现，携带行操作（添加行/删除行/导入/导出）。
+        // 缺失时运行时明细表顶部操作栏不渲染（真实缺陷，设计器保存的结构已核对）
+        models
+            .filter((m) => m.fdType === 'detail')
+            .forEach((detail) => {
+            addFields[detail.fdTableName] = {
+                ...constants_1.DETAIL_MAIN_FIELD_BASE.add,
+                ...perm.add?.[detail.fdTableName],
+                operations: constants_1.DETAIL_MAIN_FIELD_OPERATIONS.add,
+            };
+            editFields[detail.fdTableName] = {
+                ...constants_1.DETAIL_MAIN_FIELD_BASE.add,
+                ...perm.edit?.[detail.fdTableName],
+                operations: constants_1.DETAIL_MAIN_FIELD_OPERATIONS.add,
+            };
+            viewFields[detail.fdTableName] = {
+                ...constants_1.DETAIL_MAIN_FIELD_BASE.view,
+                ...perm.view?.[detail.fdTableName],
+                operations: constants_1.DETAIL_MAIN_FIELD_OPERATIONS.view,
+            };
         });
         add[model.fdTableName] = { fields: addFields };
         edit[model.fdTableName] = { fields: editFields };
@@ -1476,6 +1563,54 @@ async function buildFdConfig(models, options = {}, stats) {
                 ];
             }
         }
+        // 沿用视图时同样补齐 `<main>` 节点的 controlProps（设计器保存时经 setMainCmpt 写入，
+        // CLI 早期版本重建的视图缺失；详见 wrapAppearance 注释），并把 controlMappings
+        // 与重建的映射做并集——旧视图的映射可能缺明细字段的控件（真实缺陷）
+        const rebuiltMappings = buildControlMappings(built, options, details);
+        for (const vm of viewModel) {
+            const viewConfig = (0, random_1.safeJsonParse)(vm.fdConfig, {});
+            const render = viewConfig?.view?.render;
+            if (!render)
+                continue;
+            let patched = false;
+            const patchMain = (nodes) => {
+                for (const node of nodes) {
+                    if (!node || typeof node !== 'object')
+                        continue;
+                    if (node.type === constants_1.MAIN) {
+                        node.controlProps = {
+                            importBtn: null,
+                            onDesktopImport: null,
+                            ...(node.controlProps ?? {}),
+                        };
+                        patched = true;
+                        return true;
+                    }
+                    if (Array.isArray(node.children) && patchMain(node.children))
+                        return true;
+                }
+                return false;
+            };
+            for (const platform of Object.keys(render)) {
+                if (Array.isArray(render[platform]))
+                    patchMain(render[platform]);
+            }
+            // controlMappings 并集：旧条目保留（如页签控件），重建条目按 name 覆盖（元数据最新）
+            const cm = viewConfig.view?.controlMappings;
+            if (cm) {
+                for (const platform of ['desktop', 'mobile']) {
+                    const byName = new Map((Array.isArray(cm[platform]) ? cm[platform] : []).map((e) => [e.name, e]));
+                    for (const entry of rebuiltMappings[platform] ?? [])
+                        byName.set(entry.name, entry);
+                    for (const entry of detailMappings?.[platform] ?? [])
+                        byName.set(entry.name, entry);
+                    cm[platform] = [...byName.values()];
+                    patched = true;
+                }
+            }
+            if (patched)
+                vm.fdConfig = JSON.stringify(viewConfig);
+        }
     }
     else {
         viewModel = buildViewModel(built, mainTableName, options, lang, locales, details, detailMappings);
@@ -1506,6 +1641,11 @@ async function buildFdConfig(models, options = {}, stats) {
         if (notes.size)
             stats.controlWarnings = [...notes];
     }
+    // attribute：formAttr 重建，其余顶层键（dataUnique / subjectRule 等）从已有设计整体保留
+    let prevAttributeObj = {};
+    if (options.prevAttribute)
+        prevAttributeObj = (0, random_1.safeJsonParse)(options.prevAttribute, {});
+    delete prevAttributeObj.formAttr;
     return {
         id: options.formId ?? '',
         name: options.formName ?? '',
@@ -1514,7 +1654,7 @@ async function buildFdConfig(models, options = {}, stats) {
         entityCode: options.entityCode ?? constants_1.ENTITY_CODE,
         dataModel: models,
         auth: buildAuth(models, options),
-        attribute: { formAttr: JSON.stringify(formAttr) },
+        attribute: { ...prevAttributeObj, formAttr: JSON.stringify(formAttr) },
         error: JSON.stringify({}),
         lang: JSON.stringify(lang),
         authFilter: { detailAuthDefine: {} },

package/dist/index.js

@@ -9,7 +9,7 @@ const field_1 = require("./commands/field");
 const form_1 = require("./commands/form");
 const locale_1 = require("./commands/locale");
 const logger_1 = require("./utils/logger");
-const VERSION = '2.2.0';
+const VERSION = '2.3.1';
 const program = new commander_1.Command();
 exports.program = program;
 program

package/dist/relation.js

@@ -122,7 +122,6 @@ async function resolveRelations(client, parsed, currentAppId) {
                 fdFormType: form.fdType ?? 0,
             },
             refFieldName: refNames.map((n) => `$${n}$`).join(''),
-            showFields: refNames.map((n) => `$${labelOf.get(n)}$`).join(''),
             columns: columnNames.map((n) => ({ name: n, label: labelOf.get(n) })),
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lan-low-code-cli",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "lan-low-code cli：低代码表单引擎命令行工具（创建表单、获取可用字段、自动完善表单字段）",
   "keywords": [
     "low-code",
@@ -23,7 +23,10 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "prepare": "pnpm run build",
     "bump": "node scripts/bump-version.js",
-    "bump:check": "node scripts/bump-version.js --check"
+    "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"