@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/address.json

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

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.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": "amount"
         }
       },
       "required": [
-        "type"
+        "questionType"
       ]
     }
   ],

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

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