@qingflow-tech/qingflow-cli 1.1.61-beta.4 → 1.1.61-beta.5

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

@@ -0,0 +1,146 @@
+{
+  "$defs": {
+    "EmptyConfig": {
+      "additionalProperties": false,
+      "description": "该字段类型没有特殊配置。",
+      "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": {
+        "beingRequired": {
+          "description": "该字段是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "defaultType": {
+          "default": 1,
+          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "type": "integer"
+        },
+        "defaultValue": {
+          "$ref": "#/$defs/ScalarDefaultValue",
+          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
+        },
+        "name": {
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "questionDescription": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
+          "maximum": 100,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "ScalarDefaultValue": {
+      "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",
+        "string"
+      ]
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/location.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "allOf": [
+    {
+      "$ref": "#/$defs/FieldCommon"
+    },
+    {
+      "properties": {
+        "config": {
+          "$ref": "#/$defs/EmptyConfig"
+        },
+        "questionType": {
+          "const": "location"
+        }
+      },
+      "required": [
+        "questionType"
+      ]
+    }
+  ],
+  "title": "Qingflow AppForm v1alpha1 location field",
+  "type": "object",
+  "unevaluatedProperties": false
+}

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

@@ -173,8 +173,8 @@
           ]
         },
         "numberFormat": {
-          "description": "数字展示格式 ID。",
-          "minimum": 1,
+          "description": "数字展示格式 ID(1 默认/2 千分位/3 百分比;0 为历史存量值——后端写链无值域校验,原样落库回读)。",
+          "minimum": 0,
           "type": [
             "integer",
             "null"

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

@@ -0,0 +1,146 @@
+{
+  "$defs": {
+    "EmptyConfig": {
+      "additionalProperties": false,
+      "description": "该字段类型没有特殊配置。",
+      "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": {
+        "beingRequired": {
+          "description": "该字段是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "defaultType": {
+          "default": 1,
+          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "type": "integer"
+        },
+        "defaultValue": {
+          "$ref": "#/$defs/ScalarDefaultValue",
+          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
+        },
+        "name": {
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "questionDescription": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
+          "maximum": 100,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "ScalarDefaultValue": {
+      "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",
+        "string"
+      ]
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/ocr.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "allOf": [
+    {
+      "$ref": "#/$defs/FieldCommon"
+    },
+    {
+      "properties": {
+        "config": {
+          "$ref": "#/$defs/EmptyConfig"
+        },
+        "questionType": {
+          "const": "ocr"
+        }
+      },
+      "required": [
+        "questionType"
+      ]
+    }
+  ],
+  "title": "Qingflow AppForm v1alpha1 ocr field",
+  "type": "object",
+  "unevaluatedProperties": false
+}

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

@@ -349,8 +349,8 @@
           ]
         },
         "url": {
-          "description": "请求 URL;动态嵌入字段值时使用 {{key}},并在 inputs 中提供同名 source=json_path 映射。",
-          "minLength": 1,
+          "description": "请求 URL;动态嵌入字段值时使用 {{key}},并在 inputs 中提供同名 source=json_path 映射。自定义模式(configMode=1)后端要求非空;插件模板/连接中心/轻翼智能体模式的 URL 由模板侧提供,存量声明可为空字符串(写回按读面形态透传)。",
+          "minLength": 0,
           "type": "string"
         },
         "urlEncodedValue": {

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

@@ -75,6 +75,12 @@
             "null"
           ]
         },
+        "auditValueDescription": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "beingCanDecrypted": {
           "type": [
             "boolean",
@@ -105,6 +111,12 @@
             "null"
           ]
         },
+        "dataId": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "dateType": {
           "type": [
             "integer",
@@ -123,6 +135,15 @@
             "null"
           ]
         },
+        "previousTableRowOrdinalList": {
+          "items": {
+            "type": "integer"
+          },
+          "type": [
+            "array",
+            "null"
+          ]
+        },
         "queId": {
           "type": [
             "integer",
@@ -141,6 +162,12 @@
             "null"
           ]
         },
+        "questionOrdinal": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "referValues": {
           "items": {
             "$ref": "#/$defs/ReferenceDefaultValue"

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

@@ -621,6 +621,12 @@
             "null"
           ]
         },
+        "auditValueDescription": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "beingCanDecrypted": {
           "type": [
             "boolean",
@@ -651,6 +657,12 @@
             "null"
           ]
         },
+        "dataId": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "dateType": {
           "type": [
             "integer",
@@ -669,6 +681,15 @@
             "null"
           ]
         },
+        "previousTableRowOrdinalList": {
+          "items": {
+            "type": "integer"
+          },
+          "type": [
+            "array",
+            "null"
+          ]
+        },
         "queId": {
           "type": [
             "integer",
@@ -687,6 +708,12 @@
             "null"
           ]
         },
+        "questionOrdinal": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "referValues": {
           "items": {
             "$ref": "#/$defs/ReferenceDefaultValue"
@@ -1289,8 +1316,8 @@
           ]
         },
         "numberFormat": {
-          "description": "数字展示格式 ID。",
-          "minimum": 1,
+          "description": "数字展示格式 ID(1 默认/2 千分位/3 百分比;0 为历史存量值——后端写链无值域校验,原样落库回读)。",
+          "minimum": 0,
           "type": [
             "integer",
             "null"

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

@@ -108,11 +108,11 @@
       "description": "段落内部字段行。",
       "properties": {
         "fields": {
-          "description": "本行的 1 到 4 个顶层字段。",
+          "description": "本行的 1 到 12 个顶层字段(后端无每行字段数上限,按 queWidth 渲染;上限仅约束声明输入)。",
           "items": {
             "$ref": "#/$defs/TopField"
           },
-          "maxItems": 4,
+          "maxItems": 12,
           "minItems": 1,
           "type": "array"
         }
@@ -274,11 +274,11 @@
       "description": "根级普通字段行;字段顺序即展示顺序。",
       "properties": {
         "fields": {
-          "description": "本行的 1 到 4 个顶层字段。",
+          "description": "本行的 1 到 12 个顶层字段(后端无每行字段数上限,按 queWidth 渲染;上限仅约束声明输入)。",
           "items": {
             "$ref": "#/$defs/TopField"
           },
-          "maxItems": 4,
+          "maxItems": 12,
           "minItems": 1,
           "type": "array"
         },
@@ -300,7 +300,7 @@
           "items": {
             "$ref": "#/$defs/FieldSummary"
           },
-          "maxItems": 4,
+          "maxItems": 12,
           "minItems": 1,
           "type": "array"
         },
@@ -368,7 +368,7 @@
                 "items": {
                   "$ref": "#/$defs/FieldSummary"
                 },
-                "maxItems": 4,
+                "maxItems": 12,
                 "minItems": 1,
                 "type": "array"
               }
@@ -708,6 +708,19 @@
     "code_block",
     "data_relation",
     "relation",
-    "subtable"
+    "subtable",
+    "date_duration",
+    "image_select",
+    "location",
+    "ocr",
+    "embed_field",
+    "ai_content_generation",
+    "ai_content_extraction",
+    "ai_content_classification",
+    "ai_machine_translation",
+    "ai_image_recognition",
+    "ai_image_generation",
+    "ai_document_parsing",
+    "ai_text_summary"
   ]
 }

package/src/qingflow_mcp/builder_facade/schemas/portals/manifest.json

@@ -0,0 +1,59 @@
+{
+  "manifestDescription": "面向 builder portal apply 的版本化公开门户契约。summary 提供最小声明(名称 + 布局 + 组件清单),complete 覆盖当前可写能力(全局配置 + 九类组件明细 + 可见性授权),components 提供九类组件的自包含专项 Schema。后端已知但尚不可写的能力以说明性元数据列出,不会被误报为公开能力。",
+  "latestVersion": "v1alpha1",
+  "versions": {
+    "v1alpha1": {
+      "versionDescription": "AI 和 CLI/MCP 使用的 canonical portals DSL。字段名、更新语义和约束与 builder portal apply 对齐;schema 返回会内联组件专项 Schema 的依赖定义。",
+      "apiVersion": "builder.qingflow.com/v1alpha1",
+      "applyDto": "v1alpha1",
+      "contractSource": "portal_apply",
+      "contractVersion": "v1alpha1",
+      "enabledByDefault": true,
+      "schemaKinds": [
+        "summary",
+        "complete",
+        "chart",
+        "view",
+        "grid",
+        "filter",
+        "text",
+        "link",
+        "carousel",
+        "task",
+        "favourite"
+      ],
+      "schemaFiles": {
+        "summary": "v1alpha1/summary.json",
+        "complete": "v1alpha1/complete.json",
+        "chart": "v1alpha1/components/chart.json",
+        "view": "v1alpha1/components/view.json",
+        "grid": "v1alpha1/components/grid.json",
+        "filter": "v1alpha1/components/filter.json",
+        "text": "v1alpha1/components/text.json",
+        "link": "v1alpha1/components/link.json",
+        "carousel": "v1alpha1/components/carousel.json",
+        "task": "v1alpha1/components/task.json",
+        "favourite": "v1alpha1/components/favourite.json"
+      },
+      "componentTypes": [
+        "chart",
+        "view",
+        "grid",
+        "filter",
+        "text",
+        "link",
+        "carousel",
+        "task",
+        "favourite"
+      ],
+      "summaryComponentTypes": [
+        "chart",
+        "view",
+        "grid",
+        "text",
+        "link"
+      ],
+      "status": "active"
+    }
+  }
+}