lan-low-code-cli 2.3.1 → 2.4.0

package/README.md

@@ -90,6 +90,7 @@ llc form create --name <名称> [选项]
 | `--fields <names>` | 仅生成指定字段，逗号分隔 |
 | `--add-field <spec>` | **新增/调整字段**，格式 `name:label[:dataType\|controlType[:controlType]]`，可重复；见「控件类型」章节 |
 | `--option <spec>` | 为下拉/单选/多选**新建选项**：`"字段名=选项1,选项2:值2"`，可重复 |
+| `--org-type <spec>` | 地址本（`address`）**可选类型**：`"字段名=机构,部门,个人"`（或编码 `1/2/4/8/16/256`，`all`=除人员身份外全部），可重复 |
 | `--detail <spec>` | **新建/调整明细表**：`"明细表标题=字段1:标题1[:控件类型],..."`，可重复，见「明细表」章节 |
 | `--include-system` | 同时把系统字段渲染到表单上（默认只渲染业务字段） |
 | `--per-row <n>` | 每行控件数，默认 2 |
@@ -224,7 +225,7 @@ control list 的数据源是 `{origin}/web/sys/artifact/elements/index.json` +
 | 数值 | `numbertext`、`moneytext`、`rate`、`slider`、`timepicker`、`daterange` |
 | 选择 | `select`、`radio`、`checkbox`（均支持 `--option` 配选项） |
 | 日期 | `timestamp`、`timeZone` |
-| 组织人员 | `address`（**地址本**，选人/选组织，非地址文本，见下） |
+| 组织人员 | `address`（**地址本**，选人/选组织，非地址文本，见下；可用 `--org-type` 配可选类型） |
 | 附件/媒体 | `attachment`、`image`、`video` |
 | 编码/码图 | `barcode`、`qrcode` |
 | 其它 | `switch`、`hidden`、`dividing`、`subject`、`relation`、`relationQuery` |
@@ -257,7 +258,7 @@ llc form autofill --id <fdId> --apply --add-field "fd_note:说明文字:desc" --
 | 属性 | 含义 |
 |---|---|
 | `range` | 选择范围：`all`（全部组织，默认）/ `custom`（自定义——此时才出现预选相关属性） |
-| `org.orgTypeArr` | 可选类型，**位掩码数组**：`1`=组织、`2`=部门、`4`=岗位、`8`=人员、`16`=用户组；组合值如 `3`=组织或部门、`12`=岗位或人员、`31`=全部。CLI 默认 `['8']`（仅人员） |
+| `org.orgTypeArr` | **可选类型**，编码数组：`1`=机构、`2`=部门、`4`=岗位、`8`=个人、`16`=常用群组、`256`=人员身份（仅平台开启「多身份」时可选）。CLI 默认 `['8']`（仅个人）；用 `--org-type` 指定，见下 |
 | `multi` | 是否多选（默认 `false`，单选） |
 | `preSelectType` / `preSelectValue` / `nextDept` | 仅 `range='custom'` 生效（预选类型 / 预选值 / 越过部门） |
 | `relation` | 联动传值（`relationKey`/`relationValue`/`relationEnum`/`relationTableName`） |
@@ -268,13 +269,32 @@ llc form autofill --id <fdId> --apply --add-field "fd_note:说明文字:desc" --
 如 `orgTypeArr:['8']` → `ORG_PERSON`、缺省则为 `ORG_ALL`）。CLI 两者都会写入并保持一致。
 
 ```bash
-# 选人字段（默认：全部范围 / 仅人员 / 单选）
+# 选人字段（默认：全部范围 / 仅个人 / 单选）
 llc form autofill --id <fdId> --apply --add-field "fd_owner:责任人:address"
+
+# 指定「可选类型」：部门 + 个人（字段名 = 可选类型，可重复，同一字段按顺序合并）
+llc form autofill --id <fdId> --apply \
+  --add-field "fd_dept_user:部门人员:address" \
+  --org-type "fd_dept_user=部门,个人"
+--org-type "fd_dept_user=2,8"      # 等价写法：编码
+--org-type "fd_dept_user=all"      # 机构+部门+岗位+个人+常用群组
 ```
 
-> 需要「多选 / 自定义范围 / 可选部门」等配置时，用设计器改（CLI 会把这些配置**原样保留**，
+`--org-type` 取值支持三种写法（可混用、逗号分隔、可重复）：
+
+| 写法 | 示例 |
+|---|---|
+| 中文 | `机构` / `组织`、`部门`、`岗位`、`个人` / `人员`、`常用群组` / `用户组`、`人员身份` |
+| 编码 | `1`、`2`、`4`、`8`、`16`、`256` |
+| 英文 | `org`、`dept`、`post`、`person`、`group`、`identity` |
+
+`all` = `1,2,4,8,16`（不含 `256`——人员身份仅在平台开启「多身份」时才是合法选项，需要时显式写）。
+写入 `controlProps.org.orgTypeArr` 时会**保留 `org` 的其余键**（如 `defaultValueType`），
+目标字段不是地址本控件时告警并跳过。
+
+> 需要「多选 / 自定义范围 / 预选值」时仍用设计器改（CLI 会把这些配置**原样保留**，
 > 不会因为重新生成而丢失）；平台预置的 `fd_creator`/`fd_owner`/`fd_alter` 等也是 `address` 类型，
-> 但只靠 `fdFontExtendData.orgTypeArr` 表达类型（`fd_creator`=人员、`fd_creator_dept`=部门）。
+> 但只靠 `fdFontExtendData.orgTypeArr` 表达类型（`fd_creator`=个人、`fd_creator_dept`=部门）。
 
 #### 关联类控件（`relation` / `relationQuery` / `association` / …）
 
@@ -373,6 +393,15 @@ llc form autofill --id 1k4ihs42swdw2vebw38dpgr036rj6uqi0tw0 --apply --publish \
 --option "fd_col_type=研发:rd,实施:impl,运维:ops"     # 省略值则按 1..n
 ```
 
+`--org-type` 为**地址本**（`address`）设置「可选类型」，写入 `controlProps.org.orgTypeArr`
+与 `fdFontExtendData.orgTypeArr`（`org` 的其余键保留）：
+
+```bash
+--org-type "fd_owner=机构,部门,个人"
+--org-type "fd_owner=1,2,8"        # 等价写法：编码
+--org-type "fd_owner=all"          # 除「人员身份」外的全部
+```
+
 ### 明细表
 
 ```bash

package/dist/commands/form.js

@@ -375,6 +375,38 @@ function parseOptionSpecs(items) {
     }
     return result;
 }
+/**
+ * 解析 `--org-type`：`字段名=类型1,类型2`（可重复，同一字段合并）。
+ *
+ * 类型可写编码（`1`机构 / `2`部门 / `4`岗位 / `8`个人 / `16`常用群组 / `256`人员身份）、
+ * 中文名或英文别名，`all` = 机构+部门+岗位+个人+常用群组。
+ * 落库为 `controlProps.org.orgTypeArr`（地址本控件的「可选类型」），并同步到 `fdFontExtendData`。
+ */
+function parseOrgTypeSpecs(items) {
+    const result = {};
+    for (const raw of items) {
+        const eq = raw.indexOf('=');
+        if (eq < 0) {
+            throw new Error(`--org-type 格式错误：${raw}，应为 "字段名=机构,部门,个人" 或 "字段名=1,2,8"`);
+        }
+        const field = raw.slice(0, eq).trim();
+        const tokens = raw
+            .slice(eq + 1)
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean);
+        if (!field || tokens.length === 0) {
+            throw new Error(`--org-type 格式错误：${raw}，字段名与可选类型都不能为空`);
+        }
+        const { codes, unknown } = (0, generator_1.parseOrgTypeTokens)(tokens);
+        if (unknown.length) {
+            throw new Error(`--org-type 无法识别的可选类型：${unknown.join('、')}` +
+                `（可用：机构/部门/岗位/个人/常用群组/人员身份，或编码 1/2/4/8/16/256，或 all）`);
+        }
+        result[field] = Array.from(new Set([...(result[field] ?? []), ...codes]));
+    }
+    return result;
+}
 /** 合并某个操作的字段权限 */
 function mergePermissions(target, fields, patch) {
     const result = { ...(target ?? {}) };
@@ -675,6 +707,7 @@ function registerFormCommand(program) {
         .option('--fields <names>', '仅生成指定字段，逗号分隔（字段名或标题）')
         .option('--add-field <spec>', '新增字段，格式 name:label[:dataType|controlType[:controlType]]，可重复；例 "fd_text:单行文本"、"fd_amt:预算金额:moneytext"', collect, [])
         .option('--option <spec>', '为下拉/单选/多选新建选项："字段名=选项1,选项2:值2"，可重复', collect, [])
+        .option('--org-type <spec>', '地址本「可选类型」："字段名=机构,部门,个人"（或编码 1/2/4/8/16/256，all=全部），可重复', collect, [])
         .option('--detail <spec>', '新建/调整明细表："明细表标题=字段1:标题1,字段2:标题2:控件类型"，可重复', collect, [])
         .option('--include-system', '同时把系统字段渲染到表单上（默认只渲染业务字段）')
         .option('--per-row <n>', '每行控件数量', (v) => Number(v), 2)
@@ -869,6 +902,12 @@ function registerFormCommand(program) {
             const layoutOptions = resolveLayout(opts);
             const permissions = resolvePermissions(opts);
             const optionSpecs = parseOptionSpecs(opts.option ?? []);
+            const orgTypes = parseOrgTypeSpecs(opts.orgType ?? []);
+            if (Object.keys(orgTypes).length) {
+                logger_1.logger.info(`  地址本可选类型：${Object.entries(orgTypes)
+                    .map(([name, codes]) => `${name}=${(0, generator_1.orgTypeText)(codes)}`)
+                    .join('；')}`);
+            }
             const actionSpecs = resolveActions(opts);
             if (actionSpecs.length) {
                 logger_1.logger.info(`  控件动作：${actionSpecs.length} 个`);
@@ -911,16 +950,24 @@ function registerFormCommand(program) {
                 ...layoutOptions,
                 permissions,
                 options: optionSpecs,
+                orgTypes: Object.keys(orgTypes).length ? orgTypes : undefined,
                 actions: actionSpecs,
                 relations: relationSpecs.length ? relationSpecs : undefined,
             });
             if (stats.optionsCompleted) {
                 logger_1.logger.info(`  完善选项多语言：${stats.optionsCompleted} 个`);
             }
+            if (stats.orgTypesCompleted) {
+                logger_1.logger.info(`  地址本可选类型：${stats.orgTypesCompleted} 个字段`);
+            }
             if (stats.actionsCompleted) {
                 logger_1.logger.info(`  配置控件动作：${stats.actionsCompleted} 个`);
             }
-            for (const warning of [...(stats.actionWarnings ?? []), ...(stats.controlWarnings ?? [])]) {
+            for (const warning of [
+                ...(stats.actionWarnings ?? []),
+                ...(stats.orgTypeWarnings ?? []),
+                ...(stats.controlWarnings ?? []),
+            ]) {
                 logger_1.logger.warn(warning);
             }
             assertPropValidation(stats, opts, true);
@@ -1067,6 +1114,7 @@ function registerFormCommand(program) {
         .option('--fields <names>', '仅处理指定字段，逗号分隔')
         .option('--add-field <spec>', '新增字段，格式 name:label[:dataType|controlType[:controlType]]，可重复', collect, [])
         .option('--option <spec>', '为下拉/单选/多选新建选项："字段名=选项1,选项2:值2"，可重复', collect, [])
+        .option('--org-type <spec>', '地址本「可选类型」："字段名=机构,部门,个人"（或编码 1/2/4/8/16/256，all=全部），可重复', collect, [])
         .option('--detail <spec>', '新建/调整明细表："明细表标题=字段1:标题1,字段2:标题2:控件类型"，可重复', collect, [])
         .option('--include-system', '同时把系统字段渲染到表单上（默认只渲染业务字段）')
         .option('--icon <icon>', '页面图标（图标名或图标 JSON）；缺失时会自动补默认图标')
@@ -1134,6 +1182,12 @@ function registerFormCommand(program) {
         const layoutOptions = resolveLayout(opts);
         const permissions = resolvePermissions(opts);
         const optionSpecs = parseOptionSpecs(opts.option ?? []);
+        const orgTypes = parseOrgTypeSpecs(opts.orgType ?? []);
+        if (Object.keys(orgTypes).length) {
+            logger_1.logger.info(`  地址本可选类型：${Object.entries(orgTypes)
+                .map(([name, codes]) => `${name}=${(0, generator_1.orgTypeText)(codes)}`)
+                .join('；')}`);
+        }
         if (layoutOptions.layout && layoutOptions.layout !== 'rows') {
             logger_1.logger.info(`  布局：${layoutOptions.layout}`);
         }
@@ -1179,6 +1233,7 @@ function registerFormCommand(program) {
             ...layoutOptions,
             permissions,
             options: optionSpecs,
+            orgTypes: Object.keys(orgTypes).length ? orgTypes : undefined,
             actions: actionSpecs,
             relations: relationSpecs.length ? relationSpecs : undefined,
             prevFormAttr: prev.prevFormAttr,
@@ -1190,11 +1245,15 @@ function registerFormCommand(program) {
         if (stats.optionsCompleted) {
             logger_1.logger.info(`  完善选项多语言：${stats.optionsCompleted} 个`);
         }
+        if (stats.orgTypesCompleted) {
+            logger_1.logger.info(`  地址本可选类型：${stats.orgTypesCompleted} 个字段`);
+        }
         if (stats.actionsCompleted) {
             logger_1.logger.info(`  配置控件动作：${stats.actionsCompleted} 个`);
         }
         for (const warning of [
             ...(stats.actionWarnings ?? []),
+            ...(stats.orgTypeWarnings ?? []),
             ...(stats.layoutWarnings ?? []),
             ...(stats.controlWarnings ?? []),
         ]) {

package/dist/constants.js

@@ -3,8 +3,8 @@
  * 常量定义：与 sys-xform 前端 util/constant.ts 中的约定保持一致。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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.ORG_TYPE_LABELS = exports.ORG_TYPE_ALL = exports.ORG_TYPE_ALIASES = exports.ADDRESS_CONTROL_PKG = 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 = exports.FIELD_NAME_PREFIX = exports.LOCALE_PATTERN = exports.LOCALE_ALL = exports.LOCALES = void 0;
 /** 设计器主容器 key */
 exports.MAIN = 'main';
 /** 外观容器 */
@@ -187,6 +187,70 @@ exports.DEFAULT_CONTROL_MAP = {
 };
 /** 兜底控件（未知类型） */
 exports.FALLBACK_CONTROL = exports.DEFAULT_CONTROL_MAP.varchar;
+/** 地址本控件包名（可选类型 orgTypeArr 只对此控件生效） */
+exports.ADDRESS_CONTROL_PKG = '@elem/xform-address';
+/**
+ * 地址本「可选类型」（`controlProps.org.orgTypeArr`）取值别名表。
+ *
+ * 取值依据前端 `sys-xform` 属性面板控件 `components/ide/configuration/controls/orgType/index.tsx`
+ * 的 options（与设计器落库数据一致）：
+ * `1`=机构、`2`=部门、`4`=岗位、`8`=个人、`16`=常用群组；
+ * `256`=人员身份（仅平台开启「多身份」时该选项才出现，默认不带）。
+ *
+ * 键为 `--org-type` 允许输入的写法（编码 / 中文 / 英文），值为落库编码。
+ */
+exports.ORG_TYPE_ALIASES = {
+    // 编码
+    '1': '1',
+    '2': '2',
+    '4': '4',
+    '8': '8',
+    '16': '16',
+    '256': '256',
+    // 中文（含常见同义写法）
+    机构: '1',
+    组织: '1',
+    单位: '1',
+    部门: '2',
+    岗位: '4',
+    个人: '8',
+    人员: '8',
+    常用群组: '16',
+    用户组: '16',
+    群组: '16',
+    人员身份: '256',
+    身份: '256',
+    // 英文
+    org: '1',
+    organization: '1',
+    organisation: '1',
+    dept: '2',
+    department: '2',
+    post: '4',
+    position: '4',
+    person: '8',
+    people: '8',
+    user: '8',
+    group: '16',
+    usergroup: '16',
+    identity: '256',
+};
+/**
+ * `all` 展开的预设项（机构/部门/岗位/个人/常用群组）。
+ *
+ * 不含 `256`（人员身份）——它仅在平台开启「多身份」时才是合法选项，
+ * 需要时请显式写 `256` / `人员身份`。
+ */
+exports.ORG_TYPE_ALL = ['1', '2', '4', '8', '16'];
+/** 地址本「可选类型」中文文案（用于日志/报错提示） */
+exports.ORG_TYPE_LABELS = {
+    '1': '机构',
+    '2': '部门',
+    '4': '岗位',
+    '8': '个人',
+    '16': '常用群组',
+    '256': '人员身份',
+};
 /**
  * 控件映射：**控件逻辑类型（xform.type）→ 桌面/移动端控件包 + 数据项类型**。
  *

package/dist/generator/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GLOBAL_ACTION_EVENTS = exports.ACTION_GLOBAL_TARGET = void 0;
+exports.parseOrgTypeTokens = parseOrgTypeTokens;
+exports.orgTypeText = orgTypeText;
 exports.buildRelationProps = buildRelationProps;
 exports.resolveLocales = resolveLocales;
 exports.completeOptionsI18n = completeOptionsI18n;
@@ -14,6 +16,41 @@ const constants_1 = require("../constants");
 const locale_1 = require("../utils/locale");
 const random_1 = require("../utils/random");
 const widgets_1 = require("../widgets");
+/**
+ * 解析地址本「可选类型」输入项（`--org-type` 的等号右侧，逗号分隔）。
+ *
+ * 接受编码（`1`/`2`/`4`/`8`/`16`/`256`）、中文（机构/部门/岗位/个人/常用群组/人员身份）
+ * 与英文（org/dept/post/person/group/identity）写法，`all` 展开为 `ORG_TYPE_ALL`。
+ * 结果按 `ORG_TYPE_ALL` 的语义排序去重，便于稳定输出。
+ *
+ * @returns `codes` 落库编码（按规范顺序）、`unknown` 无法识别的输入项
+ */
+function parseOrgTypeTokens(input) {
+    const codes = [];
+    const unknown = [];
+    for (const raw of input) {
+        const token = String(raw).trim();
+        if (!token)
+            continue;
+        if (token.toLowerCase() === 'all' || token === '全部') {
+            codes.push(...constants_1.ORG_TYPE_ALL);
+            continue;
+        }
+        const code = constants_1.ORG_TYPE_ALIASES[token] ?? constants_1.ORG_TYPE_ALIASES[token.toLowerCase()];
+        if (code)
+            codes.push(code);
+        else
+            unknown.push(token);
+    }
+    const order = [...constants_1.ORG_TYPE_ALL, '256'];
+    const unique = Array.from(new Set(codes));
+    unique.sort((a, b) => order.indexOf(a) - order.indexOf(b));
+    return { codes: unique, unknown };
+}
+/** 地址本「可选类型」编码 → 中文文案（用于日志） */
+function orgTypeText(codes) {
+    return codes.map((code) => `${constants_1.ORG_TYPE_LABELS[code] ?? code}(${code})`).join('、');
+}
 /** `$global`：动作目标为表单全局（onLoad / onBeforeSubmit / onAfterSubmit） */
 exports.ACTION_GLOBAL_TARGET = '$global';
 /** 建模表单的数据模型类名（业务关联的 `modelName`，取自真实表单） */
@@ -510,6 +547,14 @@ function buildFieldAttribute(params) {
         $$tableType: tableType,
         $$tableName: tableName,
     };
+    // 地址本「可选类型」（--org-type）：覆盖 org.orgTypeArr，
+    // 保留 org 的其余键（defaultValueType 等）——设计器改「可选类型」时也只重置该键。
+    if (params.orgTypeArr?.length) {
+        const prevOrg = controlProps.org && typeof controlProps.org === 'object' && !Array.isArray(controlProps.org)
+            ? controlProps.org
+            : {};
+        controlProps.org = { ...prevOrg, orgTypeArr: params.orgTypeArr };
+    }
     if (typeof fdLength === 'number' && fdLength > 0) {
         controlProps.maxLength = fdLength;
     }
@@ -713,6 +758,20 @@ async function buildField(field, model, options, lang, locales) {
             return { label: key, value };
         })
         : undefined;
+    // 地址本「可选类型」（--org-type）：仅对地址本控件生效；目标不是地址本时告警并跳过
+    const requestedOrgTypes = options.orgTypes?.[field.fdName];
+    let orgTypeArr;
+    let orgTypeWarning;
+    if (requestedOrgTypes?.length) {
+        if (resolved.desktopPkg === constants_1.ADDRESS_CONTROL_PKG) {
+            orgTypeArr = requestedOrgTypes;
+        }
+        else {
+            orgTypeWarning =
+                `--org-type 目标「${field.fdLabel || field.fdName}」不是地址本控件` +
+                    `（当前控件：${resolved.logicalType} / ${resolved.desktopPkg}），可选类型未写入`;
+        }
+    }
     const { attribute, config } = buildFieldAttribute({
         fieldUuid: field.uuid,
         langKey,
@@ -727,6 +786,7 @@ async function buildField(field, model, options, lang, locales) {
         options: prevOptions.length ? prevOptions : defaultOptions,
         prevControlProps: prevAttr?.config?.controlProps,
         extraControlProps: relationSpec ? buildRelationProps(relationSpec) : undefined,
+        orgTypeArr,
     });
     field.fdAttribute = attribute;
     // 前端扩展数据同步（如 address 的 orgTypeArr/multi/range）
@@ -766,7 +826,17 @@ async function buildField(field, model, options, lang, locales) {
     const propErrors = (0, widgets_1.validateRequiredProps)(resolved.meta, config);
     // 控件语义校验（属性面板/数据源弹窗强制的规则，如业务关联的关联表单与显示项）
     const semanticErrors = validateSemanticProps(resolved.logicalType, (config.controlProps ?? {}));
-    return { field, model, resolved, langKey, optionCount, propErrors, semanticErrors };
+    return {
+        field,
+        model,
+        resolved,
+        langKey,
+        optionCount,
+        orgTypeApplied: Boolean(orgTypeArr?.length),
+        orgTypeWarning,
+        propErrors,
+        semanticErrors,
+    };
 }
 /** 构建虚拟行：控件节点在持久化格式中**只保留 key 引用** */
 function buildRows(built, options) {
@@ -1453,11 +1523,18 @@ async function buildFdConfig(models, options = {}, stats) {
     const actionTargets = new Map();
     /** 必填属性校验失败汇总（对齐设计器发布前校验） */
     const validationErrors = [];
+    /** 地址本「可选类型」（--org-type）写入告警与命中计数 */
+    const orgTypeWarnings = [];
+    let orgTypesCompleted = 0;
     for (const field of renderFields) {
         const builtField = await buildField(field, main, options, lang, locales);
         built.push(builtField);
         if (stats)
             stats.optionsCompleted += builtField.optionCount;
+        if (builtField.orgTypeApplied)
+            orgTypesCompleted++;
+        if (builtField.orgTypeWarning)
+            orgTypeWarnings.push(builtField.orgTypeWarning);
         actionTargets.set(builtField.field.fdName, `${mainTableName}.${builtField.field.uuid}`);
         for (const error of builtField.propErrors) {
             validationErrors.push(`字段 ${field.fdName}（${builtField.resolved.desktopPkg}）：请输入${error.label}（${error.key}）`);
@@ -1486,6 +1563,10 @@ async function buildFdConfig(models, options = {}, stats) {
                 fields.push(builtField);
                 if (stats)
                     stats.optionsCompleted += builtField.optionCount;
+                if (builtField.orgTypeApplied)
+                    orgTypesCompleted++;
+                if (builtField.orgTypeWarning)
+                    orgTypeWarnings.push(builtField.orgTypeWarning);
                 actionTargets.set(builtField.field.fdName, `${model.fdTableName}.${builtField.field.uuid}`);
                 for (const error of builtField.propErrors) {
                     validationErrors.push(`明细字段 ${model.fdTableName}.${field.fdName}（${builtField.resolved.desktopPkg}）：请输入${error.label}（${error.key}）`);
@@ -1620,6 +1701,9 @@ async function buildFdConfig(models, options = {}, stats) {
     const actionResult = applyControlActions(formAttr, actionTargets, options.actions ?? []);
     if (stats) {
         stats.actionsCompleted = actionResult.completed;
+        stats.orgTypesCompleted = orgTypesCompleted;
+        if (orgTypeWarnings.length)
+            stats.orgTypeWarnings = orgTypeWarnings;
         if (actionResult.warnings.length)
             stats.actionWarnings = actionResult.warnings;
         if (validationErrors.length)

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.3.1';
+const VERSION = '2.4.0';
 const program = new commander_1.Command();
 exports.program = program;
 program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lan-low-code-cli",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "lan-low-code cli：低代码表单引擎命令行工具（创建表单、获取可用字段、自动完善表单字段）",
   "keywords": [
     "low-code",