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

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

@@ -15,9 +15,6 @@
           "type": "string"
         }
       },
-      "required": [
-        "name"
-      ],
       "type": "object"
     },
     "AnswerValue": {
@@ -232,7 +229,7 @@
     },
     "DataRelationCondition": {
       "additionalProperties": false,
-      "description": "一条数据关联过滤条件。",
+      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。",
       "properties": {
         "operand": {
           "$ref": "#/$defs/DataRelationOperand",
@@ -358,7 +355,7 @@
       ]
     },
     "DataRelationFilters": {
-      "description": "simple 模式的外层组为 OR、组内条件为 AND;advanced 模式使用完整公式。",
+      "description": "simple 模式的外层组为 OR、组内条件为 AND;advanced 模式使用完整公式。simple 条件只声明业务值,builder 会生成后端保存所需的 judgeValues 和 judgeValueDetails,不要在声明中直接填写这两个后端属性。",
       "oneOf": [
         {
           "additionalProperties": false,
@@ -414,9 +411,9 @@
               "const": "literal"
             },
             "values": {
-              "description": "字面量值列表。",
+              "description": "固定比较值列表;值必须使用字符串。选择类来源字段填写已有选项的展示文本,builder 会在 apply 时解析为后端 optId;解析不到会在写入前报错。is_empty/is_not_empty 必须传空数组,其他运算符至少传一项。",
               "items": {
-                "$ref": "#/$defs/JsonValue"
+                "type": "string"
               },
               "type": "array"
             }
@@ -915,15 +912,71 @@
       "type": "object"
     },
     "FieldCommon": {
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 2
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "type": "null"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 3
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "minLength": 1,
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            }
+          }
+        }
+      ],
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
       "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
       "properties": {
-        "dataTitle": {
-          "description": "是否作为数据标题;整个 body 最多且必须按规则存在一个。",
+        "beingRequired": {
+          "description": "该字段是否必填;缺失时保留已有字段当前值。",
           "type": "boolean"
         },
         "defaultType": {
           "default": 1,
-          "description": "默认值类型;1 表示静态值,2 表示关联/绑定值,3 表示公式值。",
+          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
           "enum": [
             1,
             2,
@@ -933,39 +986,40 @@
         },
         "defaultValue": {
           "$ref": "#/$defs/ScalarDefaultValue",
-          "description": "普通字段的标量默认值;表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
-        },
-        "description": {
-          "description": "字段说明;null 或空字符串表示清空。",
-          "type": [
-            "string",
-            "null"
-          ]
+          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;同一父级内唯一,不单独作为字段身份。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
           "minLength": 1,
           "type": "string"
         },
         "queId": {
-          "description": "已有字段的后端 ID;get 返回,新增字段省略。",
+          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
           "minimum": 1,
           "type": "integer"
         },
-        "required": {
-          "description": "是否必填;缺失时保留已有字段当前值。",
-          "type": "boolean"
+        "questionDescription": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比;同一行要么全部提供且合计 100,要么全部省略。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },
-      "required": [
-        "name"
-      ],
       "type": "object"
     },
     "FieldSelector": {
@@ -982,7 +1036,7 @@
           ]
         }
       ],
-      "description": "跨字段引用选择器;至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
       "properties": {
         "name": {
           "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
@@ -997,34 +1051,10 @@
       },
       "type": "object"
     },
-    "JsonValue": {
-      "description": "数据关联字面量支持的任意 JSON 值。",
-      "oneOf": [
-        {
-          "type": "null"
-        },
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "number"
-        },
-        {
-          "type": "string"
-        },
-        {
-          "items": {
-            "$ref": "#/$defs/JsonValue"
-          },
-          "type": "array"
-        },
-        {
-          "additionalProperties": {
-            "$ref": "#/$defs/JsonValue"
-          },
-          "type": "object"
-        }
-      ]
+    "FormulaExpression": {
+      "description": "轻流公式表达式的解码文本;字段引用形如 #queId_<queId>$,由后端 Formula 引擎解析。",
+      "minLength": 1,
+      "type": "string"
     },
     "MemberConfig": {
       "additionalProperties": false,
@@ -1374,11 +1404,23 @@
       "description": "引用字段配置;引用其他应用中的数据。",
       "properties": {
         "beingDefaultFormulaAutoFillEnabled": {
+          "description": "是否启用引用字段的默认值公式自动填充。",
           "type": [
             "boolean",
             "null"
           ]
         },
+        "defaultValueFormula": {
+          "description": "引用字段默认值自动填充使用的公式;仅在 beingDefaultFormulaAutoFillEnabled 为 true 时执行,null 表示清除。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/FormulaExpression"
+            }
+          ]
+        },
         "defaultValueMatchRules": {
           "type": [
             "array",
@@ -1445,11 +1487,9 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "不包含对象或数组的普通字段默认值。",
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
       "type": [
         "null",
-        "boolean",
-        "number",
         "string"
       ]
     },
@@ -1512,7 +1552,7 @@
                 "config": {
                   "$ref": "#/$defs/TextConfig"
                 },
-                "type": {
+                "questionType": {
                   "enum": [
                     "text",
                     "long_text",
@@ -1522,7 +1562,7 @@
                 }
               },
               "required": [
-                "type"
+                "questionType"
               ]
             },
             {
@@ -1530,12 +1570,12 @@
                 "config": {
                   "$ref": "#/$defs/PhoneConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "phone"
                 }
               },
               "required": [
-                "type"
+                "questionType"
               ]
             },
             {
@@ -1543,12 +1583,12 @@
                 "config": {
                   "$ref": "#/$defs/NumberConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "number"
                 }
               },
               "required": [
-                "type"
+                "questionType"
               ]
             },
             {
@@ -1556,12 +1596,12 @@
                 "config": {
                   "$ref": "#/$defs/EmptyConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "date"
                 }
               },
               "required": [
-                "type"
+                "questionType"
               ]
             },
             {
@@ -1569,12 +1609,12 @@
                 "config": {
                   "$ref": "#/$defs/AttachmentConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "attachment"
                 }
               },
               "required": [
-                "type"
+                "questionType"
               ]
             },
             {
@@ -1582,12 +1622,12 @@
                 "config": {
                   "$ref": "#/$defs/MemberConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "member"
                 }
               },
               "required": [
-                "type"
+                "questionType"
               ]
             },
             {
@@ -1595,7 +1635,7 @@
                 "config": {
                   "$ref": "#/$defs/ChoiceConfig"
                 },
-                "type": {
+                "questionType": {
                   "enum": [
                     "single_choice",
                     "single_select",
@@ -1604,7 +1644,7 @@
                 }
               },
               "required": [
-                "type",
+                "questionType",
                 "config"
               ]
             },
@@ -1613,12 +1653,12 @@
                 "config": {
                   "$ref": "#/$defs/DepartmentConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "department"
                 }
               },
               "required": [
-                "type",
+                "questionType",
                 "config"
               ]
             },
@@ -1627,12 +1667,12 @@
                 "config": {
                   "$ref": "#/$defs/RelationConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "relation"
                 }
               },
               "required": [
-                "type",
+                "questionType",
                 "config"
               ]
             },
@@ -1641,12 +1681,12 @@
                 "config": {
                   "$ref": "#/$defs/DataRelationConfig"
                 },
-                "type": {
+                "questionType": {
                   "const": "data_relation"
                 }
               },
               "required": [
-                "type",
+                "questionType",
                 "config"
               ]
             }
@@ -1658,11 +1698,71 @@
       "unevaluatedProperties": false
     },
     "SubFieldCommon": {
-      "description": "表格子字段的公共属性;不允许 dataTitle、dataCover 或 width。",
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 2
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "type": "null"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 3
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "minLength": 1,
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            }
+          }
+        }
+      ],
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
+      "description": "表格子字段的公共属性;不允许 width,也不能被应用级数据标题或数据封面选择器选中。",
       "properties": {
+        "beingRequired": {
+          "description": "该子字段是否必填;缺失时保留当前值。",
+          "type": "boolean"
+        },
         "defaultType": {
           "default": 1,
-          "description": "默认值类型;1 表示静态值,2 表示关联/绑定值,3 表示公式值。",
+          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
           "enum": [
             1,
             2,
@@ -1671,41 +1771,31 @@
           "type": "integer"
         },
         "defaultValue": {
-          "description": "表单填写时的默认值;显式 null 表示清除默认值。",
-          "type": [
-            "null",
-            "boolean",
-            "number",
-            "string",
-            "array",
-            "object"
-          ]
-        },
-        "description": {
-          "description": "子字段说明;null 或空字符串表示清空。",
-          "type": [
-            "string",
-            "null"
-          ]
+          "$ref": "#/$defs/ScalarDefaultValue",
+          "description": "表单填写时的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "子字段展示名称;在所属表格内唯一。",
+          "description": "子字段展示名称;新增子字段必填,已有子字段可在携带 queId 时省略。",
           "minLength": 1,
           "type": "string"
         },
         "queId": {
-          "description": "已有子字段的后端 ID;新增时省略。",
+          "description": "已有子字段的后端 ID;更新时用于精确定位并复用,新增子字段通常省略。",
           "minimum": 1,
           "type": "integer"
         },
-        "required": {
-          "description": "是否必填;缺失时保留当前值。",
-          "type": "boolean"
+        "questionDescription": {
+          "description": "子字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "子字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
         }
       },
-      "required": [
-        "name"
-      ],
       "type": "object"
     },
     "SubtableConfig": {
@@ -1808,19 +1898,19 @@
         "config": {
           "$ref": "#/$defs/SubtableConfig"
         },
+        "questionType": {
+          "const": "subtable"
+        },
         "subfields": {
           "items": {
             "$ref": "#/$defs/SubField"
           },
           "minItems": 1,
           "type": "array"
-        },
-        "type": {
-          "const": "subtable"
         }
       },
       "required": [
-        "type",
+        "questionType",
         "subfields"
       ]
     }