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

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

@@ -111,7 +111,7 @@
           ]
         },
         "fileSize": {
-          "minimum": 0,
+          "minimum": 1,
           "type": [
             "integer",
             "null"
@@ -131,7 +131,7 @@
           ]
         },
         "maxFileLimit": {
-          "minimum": 0,
+          "minimum": 1,
           "type": [
             "integer",
             "null"
@@ -229,7 +229,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",
@@ -265,10 +265,11 @@
         },
         "sourceField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "被过滤的数据源字段;存量读回形态可能缺失(后端反解析出的条件源字段 queId=0 且无名称)。"
+          "description": "被过滤的数据源字段。"
         }
       },
       "required": [
+        "sourceField",
         "operator",
         "operand"
       ],
@@ -276,7 +277,7 @@
     },
     "DataRelationConfig": {
       "additionalProperties": false,
-      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。source 省略表示该字段当前无关联来源配置(存量表单读回形态:后端 GET 对 displayed 目标缺失的 relation 行不回传,FormSvcImpl#getQuestionRelationsBeans continue 分支;新建数据关联字段应提供 source)。",
+      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。",
       "properties": {
         "aggregation": {
           "description": "可选聚合方式;null 表示不聚合。",
@@ -311,10 +312,12 @@
         },
         "source": {
           "$ref": "#/$defs/DataRelationSource",
-          "description": "数据来源;按 kind 选择一种来源结构。存量读回形态可能无 source(后端读面不回传关联配置),此时写回不重建该字段的关联。"
+          "description": "数据来源;按 kind 选择一种来源结构。"
         }
       },
-      "required": [],
+      "required": [
+        "source"
+      ],
       "type": "object"
     },
     "DataRelationCustomButton": {
@@ -986,7 +989,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
           "minLength": 1,
           "type": "string"
         },
@@ -1007,9 +1010,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"
         }
       },
@@ -1029,10 +1036,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"
         },
@@ -1394,7 +1401,7 @@
     },
     "RelationConfig": {
       "additionalProperties": false,
-      "description": "引用字段配置;引用其他应用中的数据。展示字段与权限以 displayFields 为准(后端 referQuestions 全量有序回写,queAuth 1=可编辑/2=隐藏/3=仅可见);displayField/visibleFields 为已废弃旧形态,apply 兼容接收一个版本窗口(displayField 同时视为双向绑定目标)。",
+      "description": "引用字段配置;引用其他应用中的数据。",
       "properties": {
         "beingDefaultFormulaAutoFillEnabled": {
           "description": "是否启用引用字段的默认值公式自动填充。",
@@ -1432,32 +1439,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",
@@ -1472,19 +1454,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"
           },
@@ -1493,7 +1464,8 @@
         }
       },
       "required": [
-        "targetAppKey"
+        "targetAppKey",
+        "displayField"
       ],
       "type": "object"
     },
@@ -1612,10 +1584,7 @@
                   "$ref": "#/$defs/NumberConfig"
                 },
                 "questionType": {
-                  "enum": [
-                    "number",
-                    "amount"
-                  ]
+                  "const": "number"
                 }
               },
               "required": [
@@ -1628,10 +1597,7 @@
                   "$ref": "#/$defs/EmptyConfig"
                 },
                 "questionType": {
-                  "enum": [
-                    "date",
-                    "datetime"
-                  ]
+                  "const": "date"
                 }
               },
               "required": [

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.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/formula.json

@@ -236,28 +236,6 @@
         "DATEDELTA(date, number, unit)"
       ]
     },
-    "DATEDIF": {
-      "category": "date",
-      "example": "DATEDIF(#queId_102$, #queId_101$)",
-      "meaning": "历史日期差函数名，仅存在于存量公式中（当前公式引擎未注册，日期差请使用 DAYS(end, start)）。为使存量声明的 validate/round-trip 通过而保留声明，不建议新公式使用。",
-      "parameters": [
-        {
-          "description": "结束日期或列表",
-          "name": "end"
-        },
-        {
-          "description": "开始日期或列表",
-          "name": "start"
-        }
-      ],
-      "returns": {
-        "description": "天数差文本列表",
-        "type": "list"
-      },
-      "signatures": [
-        "DATEDIF(end, start)"
-      ]
-    },
     "DATETOTIMESTAMP": {
       "category": "date",
       "example": "DATETOTIMESTAMP(#queId_101$)",
@@ -385,19 +363,6 @@
         "GETUSEREMAIL()"
       ]
     },
-    "GETUSERENAME": {
-      "category": "context",
-      "example": "GETUSERENAME()",
-      "meaning": "历史拼写（GETUSERNAME 的讹写），仅存在于存量公式中（当前公式引擎未注册，请使用 GETUSERNAME()）。为使存量声明的 validate/round-trip 通过而保留声明，不建议新公式使用。",
-      "parameters": [],
-      "returns": {
-        "description": "当前用户显示名称；无法取得时为空字符串",
-        "type": "string"
-      },
-      "signatures": [
-        "GETUSERENAME()"
-      ]
-    },
     "GETUSERNAME": {
       "category": "context",
       "example": "GETUSERNAME()",
@@ -1625,13 +1590,5 @@
       "需要拼接字段当前值时，将该字段的实际 queId 写成未加引号的 #queId_<字段ID>$；字段 name、字段标题和字段默认值都不能替代字段引用。",
       "新建应用的同一次 create 声明中尚未获得 queId 时，不得虚构 queId 或以字段 name 代替：先创建字段，app_form_get 回读实际 queId 后，再提交公式默认值更新。"
     ]
-  },
-  "x-qingflow-validation": {
-    "functionCallPolicy": "validate 会识别公式文本中引号外的 函数名( 调用；函数名必须在 x-qingflow-functions 中声明。未知函数会被拒绝，字符串字面量中的 NAME() 不视为函数调用。",
-    "scope": [
-      "defaultType=3 的 defaultValue",
-      "config.defaultValueFormula",
-      "data_relation config.filters.mode=advanced 的 config.filters.formula"
-    ]
   }
 }

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

@@ -136,10 +136,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"
         },
@@ -258,9 +258,13 @@
           "type": "array"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },
@@ -330,10 +334,11 @@
           "description": "段落判别值。"
         },
         "rows": {
-          "description": "段落内的有序字段行;可为空数组(空 = 存量空段落形态,后端容忍,round-trip 空↔空稳定)。",
+          "description": "段落内的非空有序字段行。",
           "items": {
             "$ref": "#/$defs/FieldRow"
           },
+          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -378,6 +383,7 @@
             ],
             "type": "object"
           },
+          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -689,7 +695,6 @@
   "x-qingflow-supported-field-types": [
     "text",
     "long_text",
-    "rich_text",
     "number",
     "amount",
     "link",