@qingflow-tech/qingflow-cli 1.1.50-beta.3 → 1.1.50-beta.5

package/src/qingflow_mcp/builder_facade/app_form.py

@@ -18,6 +18,7 @@ from ..tools.app_tools import AppTools
 from ..tools.package_tools import PackageTools
 from .app_form_schema import AppFormContractError, AppFormSchemaContext, AppFormSchemaRegistry
 from .service import (
+    AmbiguousFieldSelector,
     _coerce_any_int,
     _compile_code_block_binding_fields,
     _compile_q_linker_binding_fields,
@@ -722,14 +723,26 @@ class AppFormNormalizer:
                 ]
                 if fields:
                     body.append({"kind": "row", "fields": fields})
+        # 空表单 + 悬空 dataTitleQueId/dataCoverQueId(模板安装出的空壳应用常见:
+        # 后端 GET 原样吐出指向已不存在字段的 id)读面 canonical 化为 null——
+        # 写回 null 后端 normalizeDataTitleQueId 兜底、空表单落库等价,避免
+        # validate/apply 的 INVALID_DATA_TITLE_FIELD 拒掉自家写面(round-trip 断裂)。
+        has_fields = any(
+            bool(block.get("fields")) for block in body if block.get("kind") == "row"
+        ) or any(
+            bool(row.get("fields"))
+            for block in body
+            if block.get("kind") == "section"
+            for row in block.get("rows") or []
+        )
         resource = {
             "apiVersion": context.api_version,
             "appKey": app_key,
             "spec": {
                 "appName": _compat_label(form.get("formTitle"), "App", app_key),
                 "appDescription": form.get("formDesc") or None,
-                "dataTitleField": _selector(title_id, field_names.get(title_id or 0)) if title_id is not None else None,
-                "dataCoverField": _selector(cover_id, field_names.get(cover_id or 0)) if cover_id is not None else None,
+                "dataTitleField": _selector(title_id, field_names.get(title_id or 0)) if title_id is not None and has_fields else None,
+                "dataCoverField": _selector(cover_id, field_names.get(cover_id or 0)) if cover_id is not None and has_fields else None,
                 "attachments": self._attachments(form.get("formAttach")),
                 "serialNumber": self._serial_number(form.get("serialNumType"), form.get("serialNumConfig")),
                 "body": body,
@@ -1743,6 +1756,8 @@ class AppFormCompiler:
             relation_context["questionRelations"] = relations
             internal_fields, relations = _compile_q_linker_binding_fields(fields=internal_fields, current_schema=relation_context)
             self._validate_unique_relation_targets(relations, internal_fields)
+        except AmbiguousFieldSelector as error:
+            raise AppFormFailure("AMBIGUOUS_FIELD_SELECTOR", str(error), "CONTRACT_PRECHECK", details={"candidateQueIds": error.candidates}) from error
         except (KeyError, ValueError) as error:
             raise AppFormFailure("UNSUPPORTED_FIELD_CONFIG", str(error), "CONTRACT_PRECHECK") from error
         self._assign_subfield_temp_ids(internal_fields)
@@ -2073,20 +2088,15 @@ class AppFormCompiler:
     ) -> tuple[JSONObject | None, JSONObject | None]:
         body = spec.get("body") or []
         fields = list(_iter_fields(body))
-        names: set[str] = set()
+        # 方案 A(duplicate-field-name):同父级允许同名——后端以 queId 为字段身份
+        # (40013 实测 1624 组同名),get 提出的合法形态必须能写回;name 解析的
+        # 歧义由各 selector resolver 以 AMBIGUOUS_FIELD_SELECTOR 显式拒绝,
+        # 不在目标校验层做 name 唯一性强校验。
         for field in fields:
-            name = str(field.get("name") or "")
-            if name in names:
-                raise AppFormFailure("DUPLICATE_FIELD_NAME", f"duplicate top-level field name: {name}", "CONTRACT_PRECHECK")
-            names.add(name)
             if _field_type(field) == "subtable":
-                sub_names: set[str] = set()
                 for subfield in field.get("subfields") or []:
                     if _field_type(subfield) not in SUBFIELD_TYPES:
                         raise AppFormFailure("INVALID_SPEC", "unsupported subtable field type", "CONTRACT_PRECHECK", details={"allowedTypes": sorted(SUBFIELD_TYPES)})
-                    if subfield.get("name") in sub_names:
-                        raise AppFormFailure("DUPLICATE_FIELD_NAME", f"duplicate subtable field name: {subfield.get('name')}", "CONTRACT_PRECHECK")
-                    sub_names.add(str(subfield.get("name") or ""))
         title_selector = spec.get("dataTitleField")
         data_title: JSONObject | None = None
         if fields:
@@ -2145,6 +2155,8 @@ class AppFormCompiler:
             relation_context["questionRelations"] = relations
             internal_fields, relations = _compile_q_linker_binding_fields(fields=internal_fields, current_schema=relation_context)
             self._validate_unique_relation_targets(relations, internal_fields)
+        except AmbiguousFieldSelector as error:
+            raise AppFormFailure("AMBIGUOUS_FIELD_SELECTOR", str(error), "COMPILE", details={"candidateQueIds": error.candidates}) from error
         except (KeyError, ValueError) as error:
             raise AppFormFailure("UNSUPPORTED_FIELD_CONFIG", str(error), "COMPILE") from error
         self._assign_subfield_temp_ids(internal_fields)
@@ -2626,8 +2638,7 @@ class AppFormCompiler:
 
     def _reference_config(self, profile: str, config: JSONObject, template: JSONObject | None = None) -> JSONObject:
         target_app_key = str(config.get("targetAppKey") or "")
-        target_form = self._read_form(profile, target_app_key, being_draft=False)
-        candidates = _backend_question_candidates(target_form)
+        candidates, _target_form = self._target_form_candidates(profile, target_app_key)
         explicit_display = isinstance(config.get("displayFields"), list)
         deprecated_keys = [
             key
@@ -2714,8 +2725,7 @@ class AppFormCompiler:
         target_app_key = str(relation.get("targetAppKey") or "")
         if not target_app_key:
             raise AppFormFailure("UNSUPPORTED_FIELD_CONFIG", "select scope relation requires targetAppKey", "COMPILE")
-        target_form = self._read_form(profile, target_app_key, being_draft=False)
-        candidates = _backend_question_candidates(target_form)
+        candidates, target_form = self._target_form_candidates(profile, target_app_key)
         displayed = _resolve_backend_selector(relation.get("displayedField") or {}, candidates, "selectScopeRelation.displayedField")
         payload: JSONObject = {
             "queId": _positive_int(internal.get("que_id")) or int(internal.get("que_temp_id") or 0),
@@ -2737,14 +2747,27 @@ class AppFormCompiler:
     def _resolve_subfield_runtime_id(selector: JSONObject, internal_fields: list[JSONObject], location: str) -> int:
         if not isinstance(selector, dict):
             raise AppFormFailure("INVALID_FIELD_SELECTOR", f"{location} must be an object", "COMPILE")
+        # 同 _resolve_backend_selector:name 两侧 strip(存量字段名带前后空格,queId 兜底唯一性)。
         que_id = _positive_int(selector.get("queId"))
-        name = str(selector.get("name") or "")
+        name = str(selector.get("name") or "").strip()
         matches = [
             item for item in internal_fields
             if (que_id is None or _positive_int(item.get("que_id")) == que_id)
-            and (not name or str(item.get("name") or "") == name)
+            and (not name or str(item.get("name") or "").strip() == name)
         ]
         if len(matches) != 1:
+            if que_id is None and matches:
+                raise AppFormFailure(
+                    "AMBIGUOUS_FIELD_SELECTOR",
+                    f"{location} matches multiple subfields with the same name; use queId to disambiguate",
+                    "COMPILE",
+                    details={
+                        "selector": selector,
+                        "candidateQueIds": sorted(
+                            {_positive_int(item.get("que_id")) or 0 for item in matches}
+                        ),
+                    },
+                )
             raise AppFormFailure("INVALID_FIELD_SELECTOR", f"{location} must resolve to exactly one subfield", "COMPILE", details={"selector": selector, "matches": len(matches)})
         return _positive_int(matches[0].get("que_id")) or int(matches[0].get("que_temp_id") or 0)
 
@@ -2796,8 +2819,7 @@ class AppFormCompiler:
             source_fields = available_internal_fields
             source_fields_are_backend = False
             if source.get("kind") == "app":
-                target_form = self._read_form(profile, str(source.get("appKey") or ""), being_draft=False)
-                source_fields = _backend_question_candidates(target_form)
+                source_fields, _target_form = self._target_form_candidates(profile, str(source.get("appKey") or ""))
                 source_fields_are_backend = True
                 target = _resolve_backend_selector(source.get("field") or {}, source_fields, "source.field")
                 relation.update(
@@ -3237,6 +3259,34 @@ class AppFormCompiler:
             raise AppFormFailure("FORM_READ_FAILED", "backend returned an invalid form", "READ")
         return value
 
+    def _target_form_candidates(self, profile: str, app_key: str) -> tuple[list[JSONObject], JSONObject]:
+        """跨表引用解析候选集:目标表 草稿∪发布 并集(queId 为 key,草稿覆盖)。
+
+        后端写链对跨表 queId(referQuestions/displayedQueId/matchRules 源字段)无
+        存在性校验、原样落库(FormSvcImpl.updateFormInfo);链上唯一读目标字段的
+        Formula.matchRulesToFormula 取 question∪draft_question 且草稿覆盖,编辑器
+        候选接口(/question/{appKey}/relation)同样支持 beingDraft 草稿态。get 按
+        草稿姿态提取声明,apply 只读发布会漏掉目标表「只加在草稿、从未发布」的字段
+        (round-trip 断裂);只读草稿又会漏掉发布后草稿里删掉的旧字段——并集与
+        后端写链语义一致。草稿读失败(目标表无草稿等)退回仅发布态。
+        """
+        draft_form: JSONObject = {}
+        try:
+            draft_form = self._read_form(profile, app_key, being_draft=True)
+        except AppFormFailure:
+            draft_form = {}
+        published_form = self._read_form(profile, app_key, being_draft=False)
+        merged: list[JSONObject] = []
+        seen: set[int] = set()
+        for item in [*_backend_question_candidates(draft_form), *_backend_question_candidates(published_form)]:
+            que_id = _positive_int(item.get("queId"))
+            if que_id is not None:
+                if que_id in seen:
+                    continue
+                seen.add(que_id)
+            merged.append(item)
+        return merged, (draft_form or published_form)
+
 
 class AppFormReconciler:
     RUNTIME_VERSION = "v1alpha1"
@@ -4395,33 +4445,46 @@ def _snake_code_block(value: JSONObject) -> JSONObject:
 
 
 def _backend_question_candidates(form: JSONObject) -> list[JSONObject]:
+    """目标表字段的解析候选集(含表格子字段及其「父表·子字段」前缀变体)。
+
+    遍历与后端对齐:FormSvcImpl.fillMatchRulesList 按 supId 全局解析父表标题、
+    不看容器嵌套层级,FormQuestionSvcImpl 的候选集同样把段落内字段展开——因此
+    表格(queType=18)无论位于 formQues 顶层、baseQues 还是段落(queType=24)
+    内部,其 subQuestions 都是合法候选;段落本身不作为候选。
+    """
     result: list[JSONObject] = []
+
+    def _visit(item: JSONObject) -> None:
+        que_type = _positive_int(item.get("queType"))
+        if que_type == 24:
+            for inner in item.get("innerQuestions") or []:
+                for nested in inner if isinstance(inner, list) else []:
+                    if isinstance(nested, dict):
+                        _visit(nested)
+            return
+        result.append(item)
+        # 表格(queType=18)子字段同样是合法的目标字段:后端 data_relation
+        # 运行时按 queId 解析目标字段并把表格子字段纳入 targetQuestionMap
+        # (DataRelationCalService 先按 queId 查 question、再把表格的
+        # subQuestions 合入)。displayedQueId 指向表格子字段是存量合法
+        # 配置,提取能读出、编译必须能写回(两闸门同口径)。
+        # matchRules 的筛选源字段(sourceField)在存量里带父表名前缀
+        # (「父表·子字段」,_data_relation_field_name 按同形态写回)。
+        if que_type == 18:
+            table_title = str(item.get("queTitle") or "")
+            for sub in item.get("subQuestions") or []:
+                if isinstance(sub, dict):
+                    prefixed = dict(sub)
+                    prefixed["_sup_que_title"] = table_title
+                    result.append(prefixed)
+
     for item in form.get("baseQues") or []:
         if isinstance(item, dict):
-            result.append(item)
+            _visit(item)
     for row in form.get("formQues") or []:
         for item in row if isinstance(row, list) else []:
-            if not isinstance(item, dict):
-                continue
-            if _positive_int(item.get("queType")) == 24:
-                for inner in item.get("innerQuestions") or []:
-                    result.extend(nested for nested in inner if isinstance(inner, list) and isinstance(nested, dict))
-            else:
-                result.append(item)
-                # 表格(queType=18)子字段同样是合法的目标字段:后端 data_relation
-                # 运行时按 queId 解析目标字段并把表格子字段纳入 targetQuestionMap
-                # (DataRelationCalService 先按 queId 查 question、再把表格的
-                # subQuestions 合入)。displayedQueId 指向表格子字段是存量合法
-                # 配置,提取能读出、编译必须能写回(两闸门同口径)。
-                # matchRules 的筛选源字段(sourceField)在存量里带父表名前缀
-                # (「父表·子字段」,_data_relation_field_name 按同形态写回)。
-                if _positive_int(item.get("queType")) == 18:
-                    table_title = str(item.get("queTitle") or "")
-                    for sub in item.get("subQuestions") or []:
-                        if isinstance(sub, dict):
-                            prefixed = dict(sub)
-                            prefixed["_sup_que_title"] = table_title
-                            result.append(prefixed)
+            if isinstance(item, dict):
+                _visit(item)
     return result
 
 
@@ -4451,29 +4514,58 @@ def _backend_selector_titles(item: JSONObject) -> list[str]:
 
 
 def _resolve_backend_selector(selector: JSONObject, candidates: list[JSONObject], location: str) -> JSONObject:
+    # name 比较两侧 strip:存量字段名带前导/尾随空格(后端无空白校验),声明里的
+    # name 与候选 queTitle 一个空格即失配;queId 已同时给出,空格差异不构成歧义。
     que_id = _positive_int(selector.get("queId"))
-    name = str(selector.get("name") or "")
+    name = str(selector.get("name") or "").strip()
     matches = [
         item
         for item in candidates
         if (que_id is None or _positive_int(item.get("queId")) == que_id)
-        and (not name or name in _backend_selector_titles(item))
+        and (not name or name in {title.strip() for title in _backend_selector_titles(item)})
     ]
     if len(matches) != 1:
+        # 方案 A:后端允许同父级同名(queId 为身份)。name-only 命中多个时显式报
+        # 歧义并给出候选 queId,禁止静默取第一个。
+        if que_id is None and matches:
+            raise AppFormFailure(
+                "AMBIGUOUS_FIELD_SELECTOR",
+                f"{location} matches multiple fields with the same name; use queId to disambiguate",
+                "CONTRACT_PRECHECK",
+                details={
+                    "selector": selector,
+                    "candidateQueIds": sorted(
+                        {_positive_int(item.get("queId")) or 0 for item in matches}
+                    ),
+                },
+            )
         raise AppFormFailure("INVALID_FIELD_SELECTOR", f"{location} must resolve to exactly one field", "CONTRACT_PRECHECK", details={"selector": selector, "matches": len(matches)})
     return matches[0]
 
 
 def _resolve_canonical_selector(selector: JSONObject, candidates: list[JSONObject], location: str) -> JSONObject:
+    # 同 _resolve_backend_selector:name 两侧 strip(存量字段名带前后空格,queId 兜底唯一性)。
     que_id = _positive_int(selector.get("queId"))
-    name = str(selector.get("name") or "")
+    name = str(selector.get("name") or "").strip()
     matches = [
         item
         for item in candidates
         if (que_id is None or _positive_int(item.get("queId")) == que_id)
-        and (not name or str(item.get("name") or "") == name)
+        and (not name or str(item.get("name") or "").strip() == name)
     ]
     if len(matches) != 1:
+        if que_id is None and matches:
+            raise AppFormFailure(
+                "AMBIGUOUS_FIELD_SELECTOR",
+                f"{location} matches multiple fields with the same name; use queId to disambiguate",
+                "CONTRACT_PRECHECK",
+                details={
+                    "selector": selector,
+                    "candidateQueIds": sorted(
+                        {_positive_int(item.get("queId")) or 0 for item in matches}
+                    ),
+                },
+            )
         raise AppFormFailure(
             "INVALID_FIELD_SELECTOR",
             f"{location} must resolve to exactly one top-level field",
@@ -4484,14 +4576,27 @@ def _resolve_canonical_selector(selector: JSONObject, candidates: list[JSONObjec
 
 
 def _resolve_internal_selector(selector: JSONObject, fields: list[JSONObject], location: str) -> JSONObject:
+    # 同 _resolve_backend_selector:name 两侧 strip(存量字段名带前后空格,queId 兜底唯一性)。
     que_id = _positive_int(selector.get("queId") or selector.get("que_id"))
-    name = str(selector.get("name") or "")
+    name = str(selector.get("name") or "").strip()
     matches = [
         item
         for item in fields
         if (que_id is None or _positive_int(item.get("que_id")) == que_id)
-        and (not name or str(item.get("name") or "") == name)
+        and (not name or str(item.get("name") or "").strip() == name)
     ]
     if len(matches) != 1:
+        if que_id is None and matches:
+            raise AppFormFailure(
+                "AMBIGUOUS_FIELD_SELECTOR",
+                f"{location} matches multiple fields with the same name; use queId to disambiguate",
+                "COMPILE",
+                details={
+                    "selector": selector,
+                    "candidateQueIds": sorted(
+                        {_positive_int(item.get("que_id")) or 0 for item in matches}
+                    ),
+                },
+            )
         raise AppFormFailure("INVALID_FIELD_SELECTOR", f"{location} must resolve to exactly one field", "COMPILE", details={"selector": selector, "matches": len(matches)})
     return matches[0]

package/src/qingflow_mcp/builder_facade/models.py

@@ -135,6 +135,7 @@ class PublicViewType(str, Enum):
     board = "board"
     gantt = "gantt"
     hierarchy = "hierarchy"
+    calendar = "calendar"
 
 
 class PublicButtonTriggerAction(str, Enum):
@@ -1273,6 +1274,14 @@ class ViewHierarchyConfigPatch(StrictModel):
     )
 
 
+class ViewCalendarConfigPatch(StrictModel):
+    """日历视图特有配置 → viewgraphCalendarConfigVO。"""
+
+    title_que_id: int = Field(validation_alias=AliasChoices("title_que_id", "titleQueId"))
+    date_que_id: int = Field(validation_alias=AliasChoices("date_que_id", "dateQueId"))
+    color_que_id: int | None = Field(default=None, validation_alias=AliasChoices("color_que_id", "colorQueId"))
+
+
 class ViewDisplayConfigPatch(StrictModel):
     """展示杂项 → defaultRowHigh/beingPinNavigate/remark。"""
 
@@ -1429,6 +1438,7 @@ class ViewUpsertPatch(StrictModel):
     card: ViewCardConfigPatch | None = Field(default=None)
     gantt: ViewGanttConfigPatch | None = Field(default=None)
     hierarchy: ViewHierarchyConfigPatch | None = Field(default=None)
+    calendar: ViewCalendarConfigPatch | None = Field(default=None)
     display: ViewDisplayConfigPatch | None = Field(default=None)
     record: ViewRecordConfigPatch | None = Field(default=None)
     share: ViewShareConfigPatch | None = Field(default=None)
@@ -1497,6 +1507,10 @@ class ViewUpsertPatch(StrictModel):
                 payload["type"] = "board"
             elif normalized == "ganttview":
                 payload["type"] = "gantt"
+            elif normalized == "hierarchyview":
+                payload["type"] = "hierarchy"
+            elif normalized == "calendarview":
+                payload["type"] = "calendar"
         return payload
 
     @model_validator(mode="after")
@@ -1512,6 +1526,11 @@ class ViewUpsertPatch(StrictModel):
                 raise ValueError("hierarchy view requires hierarchy.title_que_id and children_que_id")
         elif self.hierarchy is not None:
             raise ValueError("hierarchy config is only allowed on hierarchy views")
+        if self.type == PublicViewType.calendar:
+            if self.calendar is None:
+                raise ValueError("calendar view requires calendar.title_que_id and date_que_id")
+        elif self.calendar is not None:
+            raise ValueError("calendar config is only allowed on calendar views")
         if self.type != PublicViewType.card and self.card is not None:
             raise ValueError("card config is only allowed on card views")
         if self.type != PublicViewType.gantt and self.gantt is not None:

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json

@@ -1275,7 +1275,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -1337,10 +1337,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/address.json

@@ -301,7 +301,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/attachment.json

@@ -334,7 +334,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/code_block.json

@@ -221,7 +221,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -264,10 +264,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/data_relation.json

@@ -480,7 +480,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -523,10 +523,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date.json

@@ -83,7 +83,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/datetime.json

@@ -83,7 +83,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/department.json

@@ -201,7 +201,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -244,10 +244,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/email.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/link.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/long_text.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/member.json

@@ -150,7 +150,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -193,10 +193,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/multi_select.json

@@ -146,7 +146,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/phone.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },