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

package/src/qingflow_mcp/builder_facade/models.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import re
 from enum import Enum
-from typing import Any, Union
+from typing import Any
 
 from pydantic import AliasChoices, Field, model_validator
 
@@ -134,8 +134,6 @@ class PublicViewType(str, Enum):
     card = "card"
     board = "board"
     gantt = "gantt"
-    hierarchy = "hierarchy"
-    calendar = "calendar"
 
 
 class PublicButtonTriggerAction(str, Enum):
@@ -392,38 +390,9 @@ class FlowConditionRulePatch(StrictModel):
         return self
 
 
-
-
-def _coerce_que_id(value: Any) -> Any:
-    """字段引用归一:queId(后端字段唯一键)。接受 int / "123" / "field_123"(field_id 形态) → int;
-    其余形态原样返回交给 pydantic 报错(契约诚实:不支持显示名引用)。"""
-    if isinstance(value, bool) or isinstance(value, int):
-        return value
-    if isinstance(value, str):
-        stripped = value.strip()
-        if stripped.isdigit():
-            return int(stripped)
-        if stripped.startswith("field_") and stripped[6:].isdigit():
-            return int(stripped[6:])
-    return value
-
 class ViewFilterRulePatch(StrictModel):
-    que_id: int = Field(validation_alias=AliasChoices("que_id", "queId", "field_id", "fieldId"))
+    field_name: str = Field(validation_alias=AliasChoices("field_name", "fieldName", "field", "name"))
     operator: ViewFilterOperator = Field(default=ViewFilterOperator.eq, validation_alias=AliasChoices("operator", "op"))
-
-    @model_validator(mode="before")
-    @classmethod
-    def normalize_que_id(cls, value: Any) -> Any:
-        if isinstance(value, dict):
-            for alias in ("queId", "field_id", "fieldId"):
-                if alias in value and "que_id" not in value:
-                    value = {**{k: v for k, v in value.items() if k != alias}, "que_id": value[alias]}
-                    break
-            for alias in ("queId", "field_id", "fieldId"):
-                value.pop(alias, None) if alias != "que_id" else None
-        if isinstance(value, dict) and "que_id" in value:
-            return {**value, "que_id": _coerce_que_id(value["que_id"])}
-        return value
     values: list[Any] = Field(default_factory=list)
 
     @model_validator(mode="before")
@@ -436,18 +405,11 @@ class ViewFilterRulePatch(StrictModel):
         if self.operator in {ViewFilterOperator.is_empty, ViewFilterOperator.not_empty}:
             self.values = []
             return self
-        if not self.values and self.operator != ViewFilterOperator.in_:
-            # in+空值合法:选项/成员类字段"ANY 判型未选任何值"的存量形态
-            # (后端 judgeType=EQUAL_ANY+空值,实测回写稳定保留)
+        if not self.values:
             raise ValueError("view filter rule requires values")
         return self
 
 
-# 视图筛选双形态(与 visible_when/root_filter 的嵌组形态对齐):
-# 扁平 [rule, ...] = 单组 AND(向后兼容);嵌套 [[rule,...],[rule,...]] = 组间 OR、组内 AND
-ViewFilterGroupPatch = Union[ViewFilterRulePatch, list[ViewFilterRulePatch]]
-
-
 class FieldSelector(StrictModel):
     field_id: str | None = None
     que_id: int | None = None
@@ -582,14 +544,16 @@ class VisibilityPatch(StrictModel):
 
     @model_validator(mode="after")
     def validate_shape(self) -> "VisibilityPatch":
-        # mode=specific + 空 selectors 是合法形态(auth=2 但未配置成员),回写保真;
-        # 不强制要求 specific 必须有 selectors
+        if self.mode == PublicVisibilityMode.specific and not self.selectors.has_any_selector():
+            raise ValueError("specific visibility requires selectors")
         if self.mode != PublicVisibilityMode.specific and self.selectors.has_any_selector():
             raise ValueError("selectors are only allowed when mode=specific")
         if self.mode == PublicVisibilityMode.everyone and self.external_mode != PublicExternalVisibilityMode.workspace:
             raise ValueError("mode=everyone requires external_mode=workspace")
         if self.mode == PublicVisibilityMode.everyone and self.external_selectors.has_any_selector():
             raise ValueError("external_selectors are not allowed when mode=everyone")
+        if self.external_mode == PublicExternalVisibilityMode.specific and not self.external_selectors.has_any_selector():
+            raise ValueError("external_mode=specific requires external_selectors")
         if self.external_mode != PublicExternalVisibilityMode.specific and self.external_selectors.has_any_selector():
             raise ValueError("external_selectors are only allowed when external_mode=specific")
         return self
@@ -1173,149 +1137,6 @@ class ViewQueryConditionsPatch(StrictModel):
     rows: list[list[str | int]] = Field(default_factory=list, validation_alias=AliasChoices("rows", "fields", "queryCondition"))
 
 
-class ViewDataPermissionPatch(StrictModel):
-    """数据权限形状(公开语义)→ dataPermissionType + dataScope。"""
-
-    type: str = Field(default="custom", validation_alias=AliasChoices("type", "permission_type", "permissionType"))
-    scope: str = Field(default="all", validation_alias=AliasChoices("scope", "data_scope", "dataScope"))
-
-    @model_validator(mode="after")
-    def validate_shape(self) -> "ViewDataPermissionPatch":
-        if self.type not in {"config", "custom"}:
-            raise ValueError("data_permission.type must be config or custom")
-        if self.scope not in {"all", "oneself", "dept", "subordinate", "custom"}:
-            raise ValueError("data_permission.scope must be one of all/oneself/dept/subordinate/custom")
-        return self
-
-
-class ViewSortRulePatch(StrictModel):
-    """排序规则(公开语义)→ viewgraphSorts + sortType=customSort。"""
-
-    que_id: int = Field(validation_alias=AliasChoices("que_id", "queId", "field_id", "fieldId"))
-    ascending: bool = Field(default=True, validation_alias=AliasChoices("ascending", "asc", "beingSortAscend"))
-
-    @model_validator(mode="before")
-    @classmethod
-    def normalize_que_id(cls, value: Any) -> Any:
-        if isinstance(value, dict):
-            for alias in ("queId", "field_id", "fieldId"):
-                if alias in value and "que_id" not in value:
-                    value = {**{k: v for k, v in value.items() if k != alias}, "que_id": value[alias]}
-                    break
-            for alias in ("queId", "field_id", "fieldId"):
-                value.pop(alias, None) if alias != "que_id" else None
-        if isinstance(value, dict) and "que_id" in value:
-            return {**value, "que_id": _coerce_que_id(value["que_id"])}
-        return value
-
-
-class ViewCardConfigPatch(StrictModel):
-    """卡片视图特有配置 → titleQue/frontCoverQueId/clippingMode/... 。"""
-
-    title_que_id: int | None = Field(default=None, validation_alias=AliasChoices("title_que_id", "titleQueId"))
-    cover_que_id: int | None = Field(default=None, validation_alias=AliasChoices("cover_que_id", "coverQueId", "front_cover_que_id", "frontCoverQueId"))
-    clipping_mode: str | None = Field(default=None, validation_alias=AliasChoices("clipping_mode", "clippingMode"))
-    image_adaption: bool | None = Field(default=None, validation_alias=AliasChoices("image_adaption", "imageAdaption", "beingImageAdaption"))
-    show_field_title: bool | None = Field(default=None, validation_alias=AliasChoices("show_field_title", "showFieldTitle", "beingShowQueTitle"))
-    show_title: bool | None = Field(default=None, validation_alias=AliasChoices("show_title", "showTitle", "beingShowTitleQue"))
-    show_cover: bool | None = Field(default=None, validation_alias=AliasChoices("show_cover", "showCover", "beingShowCover"))
-    group_que_id: int | None = Field(default=None, validation_alias=AliasChoices("group_que_id", "groupQueId"))
-    group_color: bool | None = Field(default=None, validation_alias=AliasChoices("group_color", "groupColor", "beingGroupColor"))
-
-    @model_validator(mode="after")
-    def validate_shape(self) -> "ViewCardConfigPatch":
-        if self.clipping_mode is not None and self.clipping_mode not in {"default", "fill"}:
-            raise ValueError("card.clipping_mode must be default or fill")
-        return self
-
-
-class ViewGanttGroupPatch(StrictModel):
-    que_id: int = Field(validation_alias=AliasChoices("que_id", "queId"))
-    ordinal: int | None = Field(default=None)
-
-
-class ViewGanttDependencyPatch(StrictModel):
-    predecessor_que_id: int = Field(validation_alias=AliasChoices("predecessor_que_id", "predecessorQueId"))
-    dependency_que_id: int = Field(validation_alias=AliasChoices("dependency_que_id", "dependencyQueId"))
-    start_start_option_id: int | None = Field(default=None, validation_alias=AliasChoices("start_start_option_id", "startStartOptionId"))
-    start_end_option_id: int | None = Field(default=None, validation_alias=AliasChoices("start_end_option_id", "startEndOptionId"))
-    end_start_option_id: int | None = Field(default=None, validation_alias=AliasChoices("end_start_option_id", "endStartOptionId"))
-    end_end_option_id: int | None = Field(default=None, validation_alias=AliasChoices("end_end_option_id", "endEndOptionId"))
-
-
-class ViewGanttConfigPatch(StrictModel):
-    """甘特视图特有配置 → viewgraphGanttConfigVO。"""
-
-    title_que_id: int | None = Field(default=None, validation_alias=AliasChoices("title_que_id", "titleQueId"))
-    start_que_id: int | None = Field(default=None, validation_alias=AliasChoices("start_que_id", "startQueId"))
-    end_que_id: int | None = Field(default=None, validation_alias=AliasChoices("end_que_id", "endQueId"))
-    default_time_dimension: str | None = Field(default=None, validation_alias=AliasChoices("default_time_dimension", "defaultTimeDimension"))
-    auto_calibration: bool | None = Field(default=None, validation_alias=AliasChoices("auto_calibration", "autoCalibration", "beingAutoCalibration"))
-    groups: list[ViewGanttGroupPatch] = Field(default_factory=list)
-    dependencies: list[ViewGanttDependencyPatch] = Field(default_factory=list, validation_alias=AliasChoices("dependencies", "dependency"))
-
-    @model_validator(mode="after")
-    def validate_shape(self) -> "ViewGanttConfigPatch":
-        if self.default_time_dimension is not None and self.default_time_dimension not in {"day", "week", "month", "year"}:
-            raise ValueError("gantt.default_time_dimension must be day, week, month, or year")
-        if len(self.dependencies) > 1:
-            raise ValueError("gantt.dependencies supports at most one dependency relation in v1alpha1")
-        return self
-
-
-class ViewHierarchyConfigPatch(StrictModel):
-    """层级视图特有配置 → viewgraphHierarchyConfigVO。"""
-
-    title_que_id: int = Field(validation_alias=AliasChoices("title_que_id", "titleQueId"))
-    children_que_id: int = Field(validation_alias=AliasChoices("children_que_id", "childrenQueId"))
-    root_filter: list[list[ViewFilterRulePatch]] = Field(
-        default_factory=list,
-        validation_alias=AliasChoices("root_filter", "rootFilter", "root_node_filter", "rootNodeFilter"),
-    )
-
-
-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。"""
-
-    row_height: str | None = Field(default=None, validation_alias=AliasChoices("row_height", "rowHeight", "defaultRowHigh"))
-    pin_navigate: bool | None = Field(default=None, validation_alias=AliasChoices("pin_navigate", "pinNavigate", "beingPinNavigate"))
-    remark: str | None = Field(default=None)
-
-    @model_validator(mode="after")
-    def validate_shape(self) -> "ViewDisplayConfigPatch":
-        # 后端 defaultRowHigh 实际值域:compact/moderate/highest(high 为历史别名)
-        if self.row_height is not None and self.row_height not in {"compact", "moderate", "highest", "high"}:
-            raise ValueError("display.row_height must be compact, moderate, highest, or high")
-        return self
-
-
-class ViewRecordConfigPatch(StrictModel):
-    """记录可见性开关 → beingAuditRecordVisible 等。"""
-
-    audit_visible: bool | None = Field(default=None, validation_alias=AliasChoices("audit_visible", "auditVisible", "beingAuditRecordVisible"))
-    data_log_visible: bool | None = Field(default=None, validation_alias=AliasChoices("data_log_visible", "dataLogVisible", "beingDataLogVisible"))
-    qrobot_record_visible: bool | None = Field(default=None, validation_alias=AliasChoices("qrobot_record_visible", "qrobotRecordVisible", "beingQrobotRecordVisible"))
-    workflow_future_visible: bool | None = Field(default=None, validation_alias=AliasChoices("workflow_future_visible", "workflowFutureVisible", "beingWorkflowNodeFutureListVisible"))
-    comment: bool | None = Field(default=None, validation_alias=AliasChoices("comment", "beingCommentStatus"))
-
-
-class ViewShareConfigPatch(StrictModel):
-    """分享与安全 → beingNeedPass/viewgraphPass/beingForceLogin/beingPrintStatus。"""
-
-    need_pass: bool | None = Field(default=None, validation_alias=AliasChoices("need_pass", "needPass", "beingNeedPass"))
-    password: str | None = Field(default=None, validation_alias=AliasChoices("password", "pass", "viewgraphPass"))
-    force_login: bool | None = Field(default=None, validation_alias=AliasChoices("force_login", "forceLogin", "beingForceLogin"))
-    print_enabled: bool | None = Field(default=None, validation_alias=AliasChoices("print_enabled", "printEnabled", "beingPrintStatus"))
-
-
 class ViewAssociatedResourcesPatch(StrictModel):
     visible: bool = Field(default=True, validation_alias=AliasChoices("visible", "enabled", "asosChartVisible"))
     limit_type: str | None = Field(default=None, validation_alias=AliasChoices("limit_type", "limitType"))
@@ -1418,30 +1239,17 @@ class ViewActionButtonPatch(StrictModel):
 class ViewUpsertPatch(StrictModel):
     name: str
     view_key: str | None = Field(default=None, validation_alias=AliasChoices("view_key", "viewKey"))
-    pinned: bool | None = Field(default=None, validation_alias=AliasChoices("pinned", "fixed", "is_pinned", "isPinned"))
     type: PublicViewType
-    columns: list[int] = Field(default_factory=list)
-    group_que_id: int | None = Field(default=None, validation_alias=AliasChoices("group_que_id", "groupQueId"))
-    filters: list["ViewFilterGroupPatch"] = Field(default_factory=list)
-    start_que_id: int | None = Field(default=None, validation_alias=AliasChoices("start_que_id", "startQueId"))
-    end_que_id: int | None = Field(default=None, validation_alias=AliasChoices("end_que_id", "endQueId"))
-    title_que_id: int | None = Field(default=None, validation_alias=AliasChoices("title_que_id", "titleQueId"))
+    columns: list[str] = Field(default_factory=list)
+    group_by: str | None = None
+    filters: list[ViewFilterRulePatch] = Field(default_factory=list)
+    start_field: str | None = Field(default=None, validation_alias=AliasChoices("start_field", "startField"))
+    end_field: str | None = Field(default=None, validation_alias=AliasChoices("end_field", "endField"))
+    title_field: str | None = Field(default=None, validation_alias=AliasChoices("title_field", "titleField"))
     buttons: list["ViewButtonBindingPatch"] | None = None
     action_buttons: list[ViewActionButtonPatch] | None = Field(default=None, validation_alias=AliasChoices("action_buttons", "actionButtons"))
     action_buttons_mode: str = Field(default="merge", validation_alias=AliasChoices("action_buttons_mode", "actionButtonsMode", "button_mode", "buttonMode"))
     visibility: VisibilityPatch | None = None
-    data_permission: ViewDataPermissionPatch | None = Field(
-        default=None,
-        validation_alias=AliasChoices("data_permission", "dataPermission"),
-    )
-    sort: list[ViewSortRulePatch] | None = Field(default=None, validation_alias=AliasChoices("sort", "sort_rules", "sortRules"))
-    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)
     query_conditions: ViewQueryConditionsPatch | None = Field(default=None, validation_alias=AliasChoices("query_conditions", "queryConditions", "query_condition", "queryCondition"))
     associated_resources: ViewAssociatedResourcesPatch | None = Field(
         default=None,
@@ -1507,34 +1315,16 @@ 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")
     def validate_shape(self) -> "ViewUpsertPatch":
         if self.type in {PublicViewType.table, PublicViewType.card} and not self.columns:
             raise ValueError("table/card views require columns")
-        if self.type == PublicViewType.board and not self.group_que_id:
-            raise ValueError("board view requires group_que_id")
-        if self.type == PublicViewType.gantt and not (self.start_que_id and self.end_que_id):
-            raise ValueError("gantt view requires start_que_id and end_que_id")
-        if self.type == PublicViewType.hierarchy:
-            if self.hierarchy is None or not (self.hierarchy.title_que_id and self.hierarchy.children_que_id):
-                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:
-            raise ValueError("gantt config is only allowed on gantt views")
+        if self.type == PublicViewType.board and not self.group_by:
+            raise ValueError("board view requires group_by")
+        if self.type == PublicViewType.gantt and not (self.start_field and self.end_field):
+            raise ValueError("gantt view requires start_field and end_field")
         normalized_mode = str(self.action_buttons_mode or "merge").strip().lower()
         if normalized_mode not in {"merge", "replace"}:
             raise ValueError("action_buttons_mode must be merge or replace")

package/src/qingflow_mcp/builder_facade/schemas/app_form/manifest.json

@@ -10,7 +10,6 @@
       "fieldTypes": [
         "text",
         "long_text",
-        "rich_text",
         "number",
         "amount",
         "link",

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

@@ -239,7 +239,7 @@
           ]
         },
         "fileSize": {
-          "minimum": 0,
+          "minimum": 1,
           "type": [
             "integer",
             "null"
@@ -259,7 +259,7 @@
           ]
         },
         "maxFileLimit": {
-          "minimum": 0,
+          "minimum": 1,
           "type": [
             "integer",
             "null"
@@ -518,7 +518,7 @@
     },
     "DataRelationCondition": {
       "additionalProperties": false,
-      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。sourceField 省略为存量读回形态(历史脏公式的源字段缺失,如 #queId_0$,写回时以 queId=0 透传),新建条件应提供 sourceField。",
+      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。",
       "properties": {
         "operand": {
           "$ref": "#/$defs/DataRelationOperand",
@@ -554,10 +554,11 @@
         },
         "sourceField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "被过滤的数据源字段;存量读回形态可能缺失(后端反解析出的条件源字段 queId=0 且无名称)。"
+          "description": "被过滤的数据源字段。"
         }
       },
       "required": [
+        "sourceField",
         "operator",
         "operand"
       ],
@@ -565,7 +566,7 @@
     },
     "DataRelationConfig": {
       "additionalProperties": false,
-      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。source 省略表示该字段当前无关联来源配置(存量表单读回形态:后端 GET 对 displayed 目标缺失的 relation 行不回传,FormSvcImpl#getQuestionRelationsBeans continue 分支;新建数据关联字段应提供 source)。",
+      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。",
       "properties": {
         "aggregation": {
           "description": "可选聚合方式;null 表示不聚合。",
@@ -600,10 +601,12 @@
         },
         "source": {
           "$ref": "#/$defs/DataRelationSource",
-          "description": "数据来源;按 kind 选择一种来源结构。存量读回形态可能无 source(后端读面不回传关联配置),此时写回不重建该字段的关联。"
+          "description": "数据来源;按 kind 选择一种来源结构。"
         }
       },
-      "required": [],
+      "required": [
+        "source"
+      ],
       "type": "object"
     },
     "DataRelationCustomButton": {
@@ -1275,7 +1278,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
           "minLength": 1,
           "type": "string"
         },
@@ -1296,9 +1299,13 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },
@@ -1337,10 +1344,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
           "minLength": 1,
           "type": "string"
         },
@@ -1968,7 +1975,7 @@
     },
     "RelationConfig": {
       "additionalProperties": false,
-      "description": "引用字段配置;引用其他应用中的数据。展示字段与权限以 displayFields 为准(后端 referQuestions 全量有序回写,queAuth 1=可编辑/2=隐藏/3=仅可见);displayField/visibleFields 为已废弃旧形态,apply 兼容接收一个版本窗口(displayField 同时视为双向绑定目标)。",
+      "description": "引用字段配置;引用其他应用中的数据。",
       "properties": {
         "beingDefaultFormulaAutoFillEnabled": {
           "description": "是否启用引用字段的默认值公式自动填充。",
@@ -2006,32 +2013,7 @@
         },
         "displayField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "已废弃:主展示字段;apply 兼容翻译为 twoWayBoundField + displayFields 首项,后续版本移除。"
-        },
-        "displayFields": {
-          "description": "有序展示字段全量列表(含隐藏字段),按 ordinal 保序回写为后端 referQuestions。可为空列表:空 = 双向绑定未配展示字段的合法存量形态(后端写链路对空 referQuestions 跳过插入、读面容忍空),round-trip 空↔空稳定;与已废弃 displayField/visibleFields 不可混用,条目 queId 不可重复。",
-          "items": {
-            "additionalProperties": false,
-            "properties": {
-              "auth": {
-                "default": "visible",
-                "description": "展示字段权限;editable=可编辑(1), hidden=隐藏(2), visible=仅可见(3);缺失按 visible。",
-                "enum": [
-                  "editable",
-                  "hidden",
-                  "visible"
-                ]
-              },
-              "field": {
-                "$ref": "#/$defs/FieldSelector"
-              }
-            },
-            "required": [
-              "field"
-            ],
-            "type": "object"
-          },
-          "type": "array"
+          "description": "引用值的主展示字段。"
         },
         "relationMode": {
           "default": "single",
@@ -2046,19 +2028,8 @@
           "minLength": 1,
           "type": "string"
         },
-        "twoWayBoundField": {
-          "description": "双向引用绑定的目标字段(后端 referQueId);null/省略 = 单向引用。get 读面在 referQueId 非空时必产出。",
-          "oneOf": [
-            {
-              "type": "null"
-            },
-            {
-              "$ref": "#/$defs/FieldSelector"
-            }
-          ]
-        },
         "visibleFields": {
-          "description": "已废弃:额外展示字段;apply 兼容翻译为 displayFields 后续项,后续版本移除。",
+          "description": "引用选择界面额外展示的字段。",
           "items": {
             "$ref": "#/$defs/FieldSelector"
           },
@@ -2067,7 +2038,8 @@
         }
       },
       "required": [
-        "targetAppKey"
+        "targetAppKey",
+        "displayField"
       ],
       "type": "object"
     },
@@ -2128,10 +2100,11 @@
           "description": "段落判别值。"
         },
         "rows": {
-          "description": "段落内的有序字段行;可为空数组(空 = 存量空段落形态,后端容忍,round-trip 空↔空稳定)。",
+          "description": "段落内的非空有序字段行。",
           "items": {
             "$ref": "#/$defs/FieldRow"
           },
+          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -2412,10 +2385,7 @@
                   "$ref": "#/$defs/NumberConfig"
                 },
                 "questionType": {
-                  "enum": [
-                    "number",
-                    "amount"
-                  ]
+                  "const": "number"
                 }
               },
               "required": [
@@ -2428,10 +2398,7 @@
                   "$ref": "#/$defs/EmptyConfig"
                 },
                 "questionType": {
-                  "enum": [
-                    "date",
-                    "datetime"
-                  ]
+                  "const": "date"
                 }
               },
               "required": [
@@ -2735,8 +2702,7 @@
                 "questionType": {
                   "enum": [
                     "date",
-                    "datetime",
-                    "rich_text"
+                    "datetime"
                   ]
                 }
               },

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 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
           "minLength": 1,
           "type": "string"
         },
@@ -322,9 +322,13 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },

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 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
           "minLength": 1,
           "type": "string"
         },
@@ -99,9 +99,13 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },

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

@@ -94,7 +94,7 @@
           ]
         },
         "fileSize": {
-          "minimum": 0,
+          "minimum": 1,
           "type": [
             "integer",
             "null"
@@ -114,7 +114,7 @@
           ]
         },
         "maxFileLimit": {
-          "minimum": 0,
+          "minimum": 1,
           "type": [
             "integer",
             "null"
@@ -334,7 +334,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
           "minLength": 1,
           "type": "string"
         },
@@ -355,9 +355,13 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },