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

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

@@ -1,15 +1,71 @@
 {
   "$defs": {
     "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,
@@ -19,47 +75,46 @@
         },
         "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"
     },
     "ScalarDefaultValue": {
-      "description": "不包含对象或数组的普通字段默认值。",
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
       "type": [
         "null",
-        "boolean",
-        "number",
         "string"
       ]
     },
@@ -120,12 +175,12 @@
         "config": {
           "$ref": "#/$defs/TextConfig"
         },
-        "type": {
+        "questionType": {
           "const": "long_text"
         }
       },
       "required": [
-        "type"
+        "questionType"
       ]
     }
   ],

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

@@ -73,15 +73,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,
@@ -91,39 +147,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": {
@@ -140,7 +197,7 @@
           ]
         }
       ],
-      "description": "跨字段引用选择器;至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
       "properties": {
         "name": {
           "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
@@ -347,11 +404,9 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "不包含对象或数组的普通字段默认值。",
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
       "type": [
         "null",
-        "boolean",
-        "number",
         "string"
       ]
     },
@@ -414,12 +469,12 @@
         "config": {
           "$ref": "#/$defs/MemberConfig"
         },
-        "type": {
+        "questionType": {
           "const": "member"
         }
       },
       "required": [
-        "type"
+        "questionType"
       ]
     }
   ],

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

@@ -69,15 +69,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,
@@ -87,47 +143,46 @@
         },
         "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"
     },
     "ScalarDefaultValue": {
-      "description": "不包含对象或数组的普通字段默认值。",
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
       "type": [
         "null",
-        "boolean",
-        "number",
         "string"
       ]
     }
@@ -143,12 +198,12 @@
         "config": {
           "$ref": "#/$defs/ChoiceConfig"
         },
-        "type": {
+        "questionType": {
           "const": "multi_select"
         }
       },
       "required": [
-        "type",
+        "questionType",
         "config"
       ]
     }

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

@@ -1,15 +1,71 @@
 {
   "$defs": {
     "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,
@@ -19,39 +75,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"
     },
     "NumberConfig": {
@@ -80,12 +137,10 @@
           ]
         },
         "currencyType": {
-          "description": "货币类型 ID。",
+          "default": 1,
+          "description": "货币类型 ID;后端发布要求为非空正整数,即使 currencyStatus 为 false 也不得传 null。无需指定时省略并使用默认值 1。",
           "minimum": 1,
-          "type": [
-            "integer",
-            "null"
-          ]
+          "type": "integer"
         },
         "decimalDigit": {
           "description": "小数位数。",
@@ -146,11 +201,9 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "不包含对象或数组的普通字段默认值。",
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
       "type": [
         "null",
-        "boolean",
-        "number",
         "string"
       ]
     }
@@ -166,12 +219,12 @@
         "config": {
           "$ref": "#/$defs/NumberConfig"
         },
-        "type": {
+        "questionType": {
           "const": "number"
         }
       },
       "required": [
-        "type"
+        "questionType"
       ]
     }
   ],