@qingflow-tech/qingflow-cli 1.1.51 → 1.1.54

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
+from typing import Any, Union
 
 from pydantic import AliasChoices, Field, model_validator
 
@@ -134,6 +134,8 @@ class PublicViewType(str, Enum):
     card = "card"
     board = "board"
     gantt = "gantt"
+    hierarchy = "hierarchy"
+    calendar = "calendar"
 
 
 class PublicButtonTriggerAction(str, Enum):
@@ -390,9 +392,38 @@ 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):
-    field_name: str = Field(validation_alias=AliasChoices("field_name", "fieldName", "field", "name"))
+    que_id: int = Field(validation_alias=AliasChoices("que_id", "queId", "field_id", "fieldId"))
     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")
@@ -405,11 +436,18 @@ class ViewFilterRulePatch(StrictModel):
         if self.operator in {ViewFilterOperator.is_empty, ViewFilterOperator.not_empty}:
             self.values = []
             return self
-        if not self.values:
+        if not self.values and self.operator != ViewFilterOperator.in_:
+            # in+空值合法:选项/成员类字段"ANY 判型未选任何值"的存量形态
+            # (后端 judgeType=EQUAL_ANY+空值,实测回写稳定保留)
             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
@@ -544,16 +582,14 @@ class VisibilityPatch(StrictModel):
 
     @model_validator(mode="after")
     def validate_shape(self) -> "VisibilityPatch":
-        if self.mode == PublicVisibilityMode.specific and not self.selectors.has_any_selector():
-            raise ValueError("specific visibility requires selectors")
+        # mode=specific + 空 selectors 是合法形态(auth=2 但未配置成员),回写保真;
+        # 不强制要求 specific 必须有 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
@@ -1137,6 +1173,149 @@ 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"))
@@ -1239,17 +1418,30 @@ 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[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"))
+    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"))
     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,
@@ -1315,16 +1507,34 @@ 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_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")
+        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")
         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,6 +10,7 @@
       "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": 1,
+          "minimum": 0,
           "type": [
             "integer",
             "null"
@@ -259,7 +259,7 @@
           ]
         },
         "maxFileLimit": {
-          "minimum": 1,
+          "minimum": 0,
           "type": [
             "integer",
             "null"
@@ -518,7 +518,7 @@
     },
     "DataRelationCondition": {
       "additionalProperties": false,
-      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。",
+      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。sourceField 省略为存量读回形态(历史脏公式的源字段缺失,如 #queId_0$,写回时以 queId=0 透传),新建条件应提供 sourceField。",
       "properties": {
         "operand": {
           "$ref": "#/$defs/DataRelationOperand",
@@ -554,11 +554,10 @@
         },
         "sourceField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "被过滤的数据源字段。"
+          "description": "被过滤的数据源字段;存量读回形态可能缺失(后端反解析出的条件源字段 queId=0 且无名称)。"
         }
       },
       "required": [
-        "sourceField",
         "operator",
         "operand"
       ],
@@ -566,7 +565,7 @@
     },
     "DataRelationConfig": {
       "additionalProperties": false,
-      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。",
+      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。source 省略表示该字段当前无关联来源配置(存量表单读回形态:后端 GET 对 displayed 目标缺失的 relation 行不回传,FormSvcImpl#getQuestionRelationsBeans continue 分支;新建数据关联字段应提供 source)。",
       "properties": {
         "aggregation": {
           "description": "可选聚合方式;null 表示不聚合。",
@@ -601,12 +600,10 @@
         },
         "source": {
           "$ref": "#/$defs/DataRelationSource",
-          "description": "数据来源;按 kind 选择一种来源结构。"
+          "description": "数据来源;按 kind 选择一种来源结构。存量读回形态可能无 source(后端读面不回传关联配置),此时写回不重建该字段的关联。"
         }
       },
-      "required": [
-        "source"
-      ],
+      "required": [],
       "type": "object"
     },
     "DataRelationCustomButton": {
@@ -1278,7 +1275,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -1299,13 +1296,9 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
-          "enum": [
-            25,
-            50,
-            75,
-            100
-          ],
+          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
+          "maximum": 100,
+          "minimum": 1,
           "type": "integer"
         }
       },
@@ -1344,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"
         },
@@ -1975,7 +1968,7 @@
     },
     "RelationConfig": {
       "additionalProperties": false,
-      "description": "引用字段配置;引用其他应用中的数据。",
+      "description": "引用字段配置;引用其他应用中的数据。展示字段与权限以 displayFields 为准(后端 referQuestions 全量有序回写,queAuth 1=可编辑/2=隐藏/3=仅可见);displayField/visibleFields 为已废弃旧形态,apply 兼容接收一个版本窗口(displayField 同时视为双向绑定目标)。",
       "properties": {
         "beingDefaultFormulaAutoFillEnabled": {
           "description": "是否启用引用字段的默认值公式自动填充。",
@@ -2013,7 +2006,32 @@
         },
         "displayField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "引用值的主展示字段。"
+          "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"
         },
         "relationMode": {
           "default": "single",
@@ -2028,8 +2046,19 @@
           "minLength": 1,
           "type": "string"
         },
+        "twoWayBoundField": {
+          "description": "双向引用绑定的目标字段(后端 referQueId);null/省略 = 单向引用。get 读面在 referQueId 非空时必产出。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          ]
+        },
         "visibleFields": {
-          "description": "引用选择界面额外展示的字段。",
+          "description": "已废弃:额外展示字段;apply 兼容翻译为 displayFields 后续项,后续版本移除。",
           "items": {
             "$ref": "#/$defs/FieldSelector"
           },
@@ -2038,8 +2067,7 @@
         }
       },
       "required": [
-        "targetAppKey",
-        "displayField"
+        "targetAppKey"
       ],
       "type": "object"
     },
@@ -2100,11 +2128,10 @@
           "description": "段落判别值。"
         },
         "rows": {
-          "description": "段落内的非空有序字段行。",
+          "description": "段落内的有序字段行;可为空数组(空 = 存量空段落形态,后端容忍,round-trip 空↔空稳定)。",
           "items": {
             "$ref": "#/$defs/FieldRow"
           },
-          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -2385,7 +2412,10 @@
                   "$ref": "#/$defs/NumberConfig"
                 },
                 "questionType": {
-                  "const": "number"
+                  "enum": [
+                    "number",
+                    "amount"
+                  ]
                 }
               },
               "required": [
@@ -2398,7 +2428,10 @@
                   "$ref": "#/$defs/EmptyConfig"
                 },
                 "questionType": {
-                  "const": "date"
+                  "enum": [
+                    "date",
+                    "datetime"
+                  ]
                 }
               },
               "required": [
@@ -2702,7 +2735,8 @@
                 "questionType": {
                   "enum": [
                     "date",
-                    "datetime"
+                    "datetime",
+                    "rich_text"
                   ]
                 }
               },

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

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

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