@qingflow-tech/qingflow-cli 1.1.43 → 1.1.44-beta.2

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

@@ -0,0 +1,2969 @@
+{
+  "$defs": {
+    "AddressConfig": {
+      "additionalProperties": false,
+      "description": "地址精度、定位和扫码配置;defaultValues 使用 AnswerDetail 结构。",
+      "properties": {
+        "addressPrecision": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "canScan": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultValues": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/DefaultValues"
+            }
+          ]
+        },
+        "pickPosition": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "AliasSelector": {
+      "additionalProperties": false,
+      "description": "Q-Linker 或代码块输出别名;已有输出优先携带 aliasId。",
+      "properties": {
+        "aliasId": {
+          "description": "后端生成的别名 ID;新增输出时可省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "name": {
+          "description": "输出别名名称。",
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "AnswerValue": {
+      "additionalProperties": false,
+      "properties": {
+        "dataValue": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "email": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "id": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "optionId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "ordinal": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "otherInfo": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "pluginValue": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "queId": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "value": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "valueStr": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "AppFormSpec": {
+      "additionalProperties": false,
+      "description": "表单基础配置与字段布局目标态;除 body 外,缺失属性表示保留当前值。应用内所有 q_linker 和 code_block 字段的 outputs[].targetField 必须全局唯一,同一实际字段只能被一个输出映射写入。多个生产方需要回写时,请选择不同目标字段或合并为一个生产方。",
+      "properties": {
+        "appDescription": {
+          "description": "应用描述;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "appName": {
+          "description": "应用名称;缺失时保留当前名称。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "attachments": {
+          "description": "应用附件完整目标态;空数组表示删除全部应用附件。",
+          "items": {
+            "$ref": "#/$defs/Attachment"
+          },
+          "type": "array"
+        },
+        "body": {
+          "$ref": "#/$defs/Body",
+          "description": "业务字段与布局的完整目标态;缺失字段或段落表示删除。应用内所有 Q-Linker 和代码块的 outputs[].targetField 不得重复选择同一实际字段。"
+        },
+        "dataCoverField": {
+          "description": "数据封面字段选择器;指定每条数据的封面附件来源。仅允许选择顶层 attachment 字段;null 表示清除数据封面。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          ]
+        },
+        "dataTitleField": {
+          "description": "数据标题字段选择器;指定每条数据的主显示标题来源。创建非空 body 时必填,更新时省略表示保留当前选择;显式提供时必须唯一定位一个顶层字段,仅 body 为空时允许 null。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          ]
+        },
+        "serialNumber": {
+          "$ref": "#/$defs/SerialNumber",
+          "description": "应用编号规则;支持默认编号或自定义组件编号。"
+        }
+      },
+      "required": [
+        "body"
+      ],
+      "type": "object"
+    },
+    "Attachment": {
+      "additionalProperties": false,
+      "description": "应用级附件;已有附件由 attachId 复用,新增附件省略 attachId。",
+      "properties": {
+        "attachId": {
+          "description": "后端生成的附件 ID;get 返回,新增时省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "fileName": {
+          "description": "附件展示名称。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "fileUrl": {
+          "description": "已上传文件的可访问 URL。",
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "fileName",
+        "fileUrl"
+      ],
+      "type": "object"
+    },
+    "AttachmentConfig": {
+      "additionalProperties": false,
+      "description": "附件字段上传限制。",
+      "properties": {
+        "canScan": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultValues": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/DefaultValues"
+            }
+          ]
+        },
+        "fileBeingCaptureOnly": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "fileSize": {
+          "minimum": 1,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "fileType": {
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "imageCompress": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "maxFileLimit": {
+          "minimum": 1,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "maxFileLimitStatus": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "pluginStatus": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "Body": {
+      "description": "有序表单内容块;空数组表示删除全部业务字段和段落。",
+      "items": {
+        "$ref": "#/$defs/BodyBlock"
+      },
+      "type": "array"
+    },
+    "BodyBlock": {
+      "description": "根级普通行或独占外层位置的段落。",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/RowBlock"
+        },
+        {
+          "$ref": "#/$defs/SectionBlock"
+        }
+      ]
+    },
+    "ChoiceConfig": {
+      "additionalProperties": false,
+      "description": "选择类字段配置。",
+      "properties": {
+        "beingShowColor": {
+          "description": "是否展示选项颜色。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultOptions": {
+          "description": "选项默认选中状态;值必须来自 options,省略表示保留现有状态。",
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array",
+          "uniqueItems": true
+        },
+        "maxOpts": {
+          "description": "最多选择项数;null 表示不限制。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "minOpts": {
+          "description": "最少选择项数;null 表示不限制。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "optDirection": {
+          "description": "选项排列方向 ID。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "optSelectMode": {
+          "description": "多项选择模式 ID。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "options": {
+          "description": "非空有序选项文案;缺失选项表示从该字段配置中删除。",
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "minItems": 1,
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "options"
+      ],
+      "type": "object"
+    },
+    "CodeBlockBinding": {
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "outputs": {
+                "minItems": 1
+              }
+            },
+            "required": [
+              "outputs"
+            ]
+          },
+          "then": {
+            "properties": {
+              "code": {
+                "pattern": "(^|[^A-Za-z0-9_$])qf_output\\s*=(?!=)"
+              }
+            }
+          }
+        }
+      ],
+      "description": "代码块的输入、代码和输出映射;配置 outputs 时,代码必须显式给 qf_output 赋值,仅 return 对象不会产生可回写结果。每个输出目标还必须满足应用级唯一性规则,不能与任何代码块或 Q-Linker 的其他输出指向同一实际字段。多个生产方需要回写时,请选择不同目标字段或合并为一个生产方。",
+      "properties": {
+        "autoTrigger": {
+          "description": "是否在输入变化时自动执行代码块。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "code": {
+          "description": "业务代码源码;MCP/CLI 仅保存,不执行。inputs 声明的 var 会由 Builder 自动注入。配置 outputs 时必须显式赋值 qf_output,例如 qf_output = { score: input.score };,仅 return 对象或比较 qf_output 不会回写。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "customButtonText": {
+          "description": "自定义触发按钮文案。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customButtonTextEnabled": {
+          "description": "是否启用自定义触发按钮文案。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "hideOnForm": {
+          "description": "是否在表单填写界面隐藏该代码块字段。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "inputs": {
+          "description": "当前表单字段到代码变量的映射。Builder 会在保存时自动生成读取 qf_field 的代码前缀;业务 code 直接使用 var,不要手写 qf_field.{字段名$$ID$$}。",
+          "items": {
+            "$ref": "#/$defs/CodeBlockInputBinding"
+          },
+          "type": "array"
+        },
+        "outputs": {
+          "description": "代码输出路径到目标字段的映射;每个 path 必须从代码显式赋值的 qf_output 中读取,且所有 targetField 在整个应用的代码块和 Q-Linker 输出中必须全局唯一。",
+          "items": {
+            "$ref": "#/$defs/CodeBlockOutputBinding"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "type": "object"
+    },
+    "CodeBlockConfig": {
+      "additionalProperties": false,
+      "description": "代码块的高层声明;无法无损还原为该结构时阻断处理。",
+      "properties": {
+        "codeBlockBinding": {
+          "$ref": "#/$defs/CodeBlockBinding"
+        }
+      },
+      "required": [
+        "codeBlockBinding"
+      ],
+      "type": "object"
+    },
+    "CodeBlockInputBinding": {
+      "additionalProperties": false,
+      "description": "一个表单字段到代码变量的映射;Builder 自动生成后端字段读取前缀。",
+      "properties": {
+        "field": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "输入来源字段。"
+        },
+        "var": {
+          "description": "业务 code 中直接使用的 JavaScript 变量名;null 表示由 Builder 生成合法且唯一的变量名。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "field"
+      ],
+      "type": "object"
+    },
+    "CodeBlockOutputBinding": {
+      "additionalProperties": false,
+      "description": "一个代码输出值到表单字段的映射;同一实际目标字段在整个应用中只能被一个代码块或 Q-Linker 输出映射写入。",
+      "properties": {
+        "alias": {
+          "description": "输出别名;用于后续数据关联引用。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "aliasId": {
+          "description": "后端生成的输出别名 ID;新增输出时省略,Builder 在首次写入后按 alias 与 path 自动回填再保存关系。更新已有输出时必须保留 get 返回值,不得自行编造或置空。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "path": {
+          "description": "从 qf_output 中取值的 JSONPath。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "接收结果的当前表单字段;该字段在整个应用的全部代码块和 Q-Linker outputs 中只能作为 targetField 出现一次,不得被多个输出关系重复写入。"
+        }
+      },
+      "required": [
+        "alias",
+        "path",
+        "targetField"
+      ],
+      "type": "object"
+    },
+    "DataRelationCondition": {
+      "additionalProperties": false,
+      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。",
+      "properties": {
+        "operand": {
+          "$ref": "#/$defs/DataRelationOperand",
+          "description": "比较值来源;可为字面量、当前表单字段或输出别名。"
+        },
+        "operator": {
+          "description": "比较运算符;Reconciler 会结合字段类型校验可用性。",
+          "enum": [
+            "equal",
+            "not_equal",
+            "contains",
+            "not_contains",
+            "greater_than",
+            "greater_or_equal",
+            "less_than",
+            "less_or_equal",
+            "dynamic_range",
+            "equal_any",
+            "not_equal_any",
+            "is_empty",
+            "is_not_empty",
+            "belongs_to",
+            "not_belongs_to",
+            "subordinate_to",
+            "not_subordinate_to",
+            "subordinate_included",
+            "subordinate_not_included",
+            "fuzzy_match",
+            "contains_any",
+            "contains_all",
+            "decimal_range"
+          ]
+        },
+        "sourceField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "被过滤的数据源字段。"
+        }
+      },
+      "required": [
+        "sourceField",
+        "operator",
+        "operand"
+      ],
+      "type": "object"
+    },
+    "DataRelationConfig": {
+      "additionalProperties": false,
+      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。",
+      "properties": {
+        "aggregation": {
+          "description": "可选聚合方式;null 表示不聚合。",
+          "enum": [
+            "sum",
+            "average",
+            "max",
+            "min",
+            "first",
+            "last",
+            "filled_count",
+            "empty_count",
+            "count",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customButton": {
+          "$ref": "#/$defs/DataRelationCustomButton",
+          "description": "可选自定义按钮配置。"
+        },
+        "filters": {
+          "$ref": "#/$defs/DataRelationFilters",
+          "description": "可选过滤条件;支持简单条件组或高级公式。"
+        },
+        "sort": {
+          "$ref": "#/$defs/DataRelationSort",
+          "description": "可选排序配置。"
+        },
+        "source": {
+          "$ref": "#/$defs/DataRelationSource",
+          "description": "数据来源;按 kind 选择一种来源结构。"
+        }
+      },
+      "required": [
+        "source"
+      ],
+      "type": "object"
+    },
+    "DataRelationCustomButton": {
+      "description": "数据关联自定义按钮;启用时必须引用已有 buttonId。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "const": false
+            }
+          },
+          "required": [
+            "enabled"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "buttonId": {
+              "minimum": 1,
+              "type": "integer"
+            },
+            "enabled": {
+              "const": true
+            }
+          },
+          "required": [
+            "enabled",
+            "buttonId"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationFilters": {
+      "description": "simple 模式的外层组为 OR、组内条件为 AND;advanced 模式使用完整公式。simple 条件只声明业务值,builder 会生成后端保存所需的 judgeValues 和 judgeValueDetails,不要在声明中直接填写这两个后端属性。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "groups": {
+              "description": "OR 条件组数组;每个内层数组是一组 AND 条件。",
+              "items": {
+                "items": {
+                  "$ref": "#/$defs/DataRelationCondition"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              "type": "array"
+            },
+            "mode": {
+              "const": "simple"
+            }
+          },
+          "required": [
+            "mode",
+            "groups"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "formula": {
+              "description": "解码后的高级筛选公式。",
+              "minLength": 1,
+              "type": "string"
+            },
+            "mode": {
+              "const": "advanced"
+            }
+          },
+          "required": [
+            "mode",
+            "formula"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationOperand": {
+      "description": "数据关联条件右值的判别联合。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "const": "literal"
+            },
+            "values": {
+              "description": "固定比较值列表;值必须使用字符串。选择类来源字段填写已有选项的展示文本,builder 会在 apply 时解析为后端 optId;解析不到会在写入前报错。is_empty/is_not_empty 必须传空数组,其他运算符至少传一项。",
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "kind",
+            "values"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "$ref": "#/$defs/FieldSelector"
+            },
+            "kind": {
+              "const": "current_field"
+            }
+          },
+          "required": [
+            "kind",
+            "field"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector"
+            },
+            "kind": {
+              "const": "alias"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationSort": {
+      "description": "数据关联排序开关;启用时必须指定排序来源和方向。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "const": false
+            }
+          },
+          "required": [
+            "enabled"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "by": {
+              "$ref": "#/$defs/DataRelationSortBy"
+            },
+            "direction": {
+              "enum": [
+                "asc",
+                "desc"
+              ]
+            },
+            "enabled": {
+              "const": true
+            }
+          },
+          "required": [
+            "enabled",
+            "by",
+            "direction"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationSortBy": {
+      "description": "排序值来源;可为来源字段或输出别名。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "$ref": "#/$defs/FieldSelector"
+            },
+            "kind": {
+              "const": "field"
+            }
+          },
+          "required": [
+            "kind",
+            "field"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector"
+            },
+            "kind": {
+              "const": "alias"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationSource": {
+      "description": "数据关联来源判别联合;kind 决定其余必填字段。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "appKey": {
+              "description": "来源应用的 appKey。",
+              "minLength": 1,
+              "type": "string"
+            },
+            "field": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "来源应用中的结果字段。"
+            },
+            "kind": {
+              "const": "app"
+            }
+          },
+          "required": [
+            "kind",
+            "appKey",
+            "field"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector",
+              "description": "Q-Linker 输出别名。"
+            },
+            "kind": {
+              "const": "q_linker"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "当前应用中的 Q-Linker 字段。"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector",
+              "description": "代码块输出别名。"
+            },
+            "kind": {
+              "const": "code_block"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "当前应用中的代码块字段。"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DefaultValues": {
+      "additionalProperties": false,
+      "properties": {
+        "associatedQueType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "beingCanDecrypted": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "beingDesensitized": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "canDecimal": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "currencyStatus": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "currencyType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "dateType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "decimalDigit": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "numberFormat": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "queId": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "queTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "queType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "referValues": {
+          "items": {
+            "$ref": "#/$defs/ReferenceDefaultValue"
+          },
+          "type": "array"
+        },
+        "rowId": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "sourceValue": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "tableValues": {
+          "items": {
+            "items": {
+              "$ref": "#/$defs/DefaultValues"
+            },
+            "type": "array"
+          },
+          "type": "array"
+        },
+        "values": {
+          "items": {
+            "$ref": "#/$defs/AnswerValue"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "values"
+      ],
+      "type": "object"
+    },
+    "DepartmentConfig": {
+      "additionalProperties": false,
+      "description": "部门字段的可选范围配置。",
+      "properties": {
+        "beingShowParentPath": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "canScan": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultDepartments": {
+          "$ref": "#/$defs/DepartmentScope"
+        },
+        "departmentScope": {
+          "$ref": "#/$defs/DepartmentScope"
+        },
+        "departmentScopeRelation": {
+          "$ref": "#/$defs/SelectScopeRelation"
+        },
+        "noRepeat": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "departmentScope"
+      ],
+      "type": "object"
+    },
+    "DepartmentScope": {
+      "description": "all 表示全部部门;custom 表示仅允许指定部门。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "includeSubDeparts": {
+              "description": "是否包含所选部门的下级部门。",
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "all"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "departments": {
+              "description": "custom 模式允许选择的部门列表。",
+              "items": {
+                "$ref": "#/$defs/DepartmentSelector"
+              },
+              "minItems": 1,
+              "type": "array"
+            },
+            "includeSubDeparts": {
+              "description": "是否包含指定部门的下级部门。",
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "custom"
+            }
+          },
+          "required": [
+            "mode",
+            "departments"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "relation"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DepartmentSelector": {
+      "additionalProperties": false,
+      "description": "部门身份;deptId 必填,deptName 仅用于展示。",
+      "properties": {
+        "deptId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "deptName": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "deptId"
+      ],
+      "type": "object"
+    },
+    "DynamicMemberSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "queId": {
+          "type": "integer"
+        },
+        "queTitle": {
+          "type": "string"
+        },
+        "type": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "EmptyConfig": {
+      "additionalProperties": false,
+      "description": "该字段类型没有特殊配置。",
+      "type": "object"
+    },
+    "ExternalDepartmentSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "deptId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "deptName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "deptId"
+      ],
+      "type": "object"
+    },
+    "ExternalMemberSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "email": {
+          "type": "string"
+        },
+        "nickName": {
+          "type": "string"
+        },
+        "uid": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "uid"
+      ],
+      "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 时省略;同一父级内唯一。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "questionDescription": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "FieldRow": {
+      "additionalProperties": false,
+      "description": "段落内部字段行。",
+      "properties": {
+        "fields": {
+          "description": "本行的 1 到 4 个顶层字段。",
+          "items": {
+            "$ref": "#/$defs/TopField"
+          },
+          "maxItems": 4,
+          "minItems": 1,
+          "type": "array"
+        }
+      },
+      "required": [
+        "fields"
+      ],
+      "type": "object"
+    },
+    "FieldSelector": {
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "properties": {
+        "name": {
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;优先用于精确解析。",
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "FormulaExpression": {
+      "description": "轻流公式表达式的解码文本;字段引用形如 #queId_<queId>$,由后端 Formula 引擎解析。",
+      "minLength": 1,
+      "type": "string"
+    },
+    "JsonValue": {
+      "description": "数据关联字面量支持的任意 JSON 值。",
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "items": {
+            "$ref": "#/$defs/JsonValue"
+          },
+          "type": "array"
+        },
+        {
+          "additionalProperties": {
+            "$ref": "#/$defs/JsonValue"
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "MemberConfig": {
+      "additionalProperties": false,
+      "description": "成员字段的选择范围和默认成员。",
+      "properties": {
+        "canScan": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultMembers": {
+          "$ref": "#/$defs/MemberScope"
+        },
+        "memberScope": {
+          "$ref": "#/$defs/MemberScope"
+        },
+        "memberScopeRelation": {
+          "$ref": "#/$defs/SelectScopeRelation"
+        },
+        "noRepeat": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "MemberScope": {
+      "description": "成员字段可选范围;all 为工作区全部成员,custom 为显式成员/部门/角色或动态成员,relation 为按字段关联。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "all"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "departments": {
+              "items": {
+                "$ref": "#/$defs/DepartmentSelector"
+              },
+              "type": "array"
+            },
+            "dynamic": {
+              "items": {
+                "$ref": "#/$defs/DynamicMemberSelector"
+              },
+              "type": "array"
+            },
+            "externalDepartments": {
+              "items": {
+                "$ref": "#/$defs/ExternalDepartmentSelector"
+              },
+              "type": "array"
+            },
+            "externalMembers": {
+              "items": {
+                "$ref": "#/$defs/ExternalMemberSelector"
+              },
+              "type": "array"
+            },
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "members": {
+              "items": {
+                "$ref": "#/$defs/MemberSelector"
+              },
+              "type": "array"
+            },
+            "mode": {
+              "const": "custom"
+            },
+            "roles": {
+              "items": {
+                "$ref": "#/$defs/RoleSelector"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "departments": {
+              "items": {
+                "$ref": "#/$defs/DepartmentSelector"
+              },
+              "type": "array"
+            },
+            "dynamic": {
+              "items": {
+                "$ref": "#/$defs/DynamicMemberSelector"
+              },
+              "type": "array"
+            },
+            "externalDepartments": {
+              "items": {
+                "$ref": "#/$defs/ExternalDepartmentSelector"
+              },
+              "type": "array"
+            },
+            "externalMembers": {
+              "items": {
+                "$ref": "#/$defs/ExternalMemberSelector"
+              },
+              "type": "array"
+            },
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "members": {
+              "items": {
+                "$ref": "#/$defs/MemberSelector"
+              },
+              "type": "array"
+            },
+            "mode": {
+              "const": "relation"
+            },
+            "roles": {
+              "items": {
+                "$ref": "#/$defs/RoleSelector"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "MemberSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "nickName": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "uid": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "uid"
+      ],
+      "type": "object"
+    },
+    "NumberConfig": {
+      "additionalProperties": false,
+      "description": "数字和金额字段的数值、精度及显示格式。",
+      "properties": {
+        "canDecimal": {
+          "description": "是否允许小数;普通数字字段可显式设置。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "canScan": {
+          "description": "是否允许扫码输入。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "currencyStatus": {
+          "description": "金额字段是否显示货币符号。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "currencyType": {
+          "description": "货币类型 ID。",
+          "minimum": 1,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "decimalDigit": {
+          "description": "小数位数。",
+          "maximum": 10,
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "maxValue": {
+          "description": "允许的最大值;后端按字符串保存。",
+          "type": [
+            "string",
+            "number",
+            "null"
+          ]
+        },
+        "minValue": {
+          "description": "允许的最小值;后端按字符串保存。",
+          "type": [
+            "string",
+            "number",
+            "null"
+          ]
+        },
+        "noRepeat": {
+          "description": "是否禁止重复值。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "numberFormat": {
+          "description": "数字展示格式 ID。",
+          "minimum": 1,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "numberLimitStatus": {
+          "description": "是否启用最小值和最大值限制。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "description": "扫码类型 ID。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "PhoneConfig": {
+      "additionalProperties": false,
+      "description": "电话字段的长度、重复和校验配置。",
+      "properties": {
+        "canScan": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "fixedPhone": {
+          "description": "是否按固定电话格式校验。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "maxWordCount": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "minWordCount": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "msgValidateStatus": {
+          "description": "是否启用短信校验。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "noRepeat": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "QLinkerBinding": {
+      "additionalProperties": false,
+      "description": "Q-Linker 的输入映射、请求配置和输出映射;每个输出目标还必须满足应用级唯一性规则,不能与任何 Q-Linker 或代码块的其他输出指向同一实际字段。多个生产方需要回写时,请选择不同目标字段或合并为一个生产方。",
+      "properties": {
+        "inputs": {
+          "description": "将当前表单字段映射到请求参数的规则。query_param、header、url_encoded 会直接生成对应位置的动态参数;json_path 用于替换 request.url、request.jsonValue 或 request.xmlValue 中的 {{key}} 占位符。",
+          "items": {
+            "$ref": "#/$defs/QLinkerInputBinding"
+          },
+          "type": "array"
+        },
+        "outputs": {
+          "description": "将响应路径映射到目标字段的规则;至少一个。所有 targetField 在整个应用的 Q-Linker 和代码块输出中必须全局唯一。",
+          "items": {
+            "$ref": "#/$defs/QLinkerOutputBinding"
+          },
+          "minItems": 1,
+          "type": "array"
+        },
+        "request": {
+          "$ref": "#/$defs/QLinkerRequest",
+          "description": "远程请求配置。"
+        }
+      },
+      "required": [
+        "request",
+        "outputs"
+      ],
+      "type": "object"
+    },
+    "QLinkerConfig": {
+      "additionalProperties": false,
+      "description": "Q-Linker 的高层声明;无法无损还原为该结构时阻断处理。",
+      "properties": {
+        "qLinkerBinding": {
+          "$ref": "#/$defs/QLinkerBinding"
+        }
+      },
+      "required": [
+        "qLinkerBinding"
+      ],
+      "type": "object"
+    },
+    "QLinkerInputBinding": {
+      "additionalProperties": false,
+      "description": "一个表单字段到请求参数的映射。需要把字段值嵌入 URL、JSON 或 XML 字符串时,source 必须为 json_path,key 必须等于所选字段名,并在对应请求字符串中写 {{key}};其他 source 不会替换 {{key}}。",
+      "properties": {
+        "field": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "输入来源字段。"
+        },
+        "key": {
+          "description": "请求参数名。source 为 json_path 时必须等于 field 选中的字段名,并与请求字符串中的 {{key}} 完全一致。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "source": {
+          "description": "字段值的写入位置。query_param、header、url_encoded 分别生成动态查询参数、请求头、表单项;json_path 替换 URL、JSON 或 XML 中的 {{key}}。不要用前三种 source 提供字符串占位符。",
+          "enum": [
+            "query_param",
+            "header",
+            "url_encoded",
+            "json_path"
+          ]
+        }
+      },
+      "required": [
+        "field",
+        "key",
+        "source"
+      ],
+      "type": "object"
+    },
+    "QLinkerKeyValue": {
+      "additionalProperties": false,
+      "description": "HTTP 请求中的键值对。",
+      "properties": {
+        "key": {
+          "description": "参数名。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "value": {
+          "description": "参数值;null 表示空值。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "type": "object"
+    },
+    "QLinkerOutputBinding": {
+      "additionalProperties": false,
+      "description": "一个响应值到表单目标字段的映射;同一实际目标字段在整个应用中只能被一个 Q-Linker 或代码块输出映射写入。",
+      "properties": {
+        "alias": {
+          "description": "输出别名;用于后续数据关联引用。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "aliasId": {
+          "description": "后端生成的输出别名 ID;新增输出时省略,Builder 在首次写入后按 alias 与 path 自动回填再保存关系。更新已有输出时必须保留 get 返回值,不得自行编造或置空。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "path": {
+          "description": "从响应中取值的 JSONPath。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "接收结果的当前表单字段;该字段在整个应用的全部 Q-Linker 和代码块 outputs 中只能作为 targetField 出现一次,不得被多个输出关系重复写入。"
+        }
+      },
+      "required": [
+        "alias",
+        "path",
+        "targetField"
+      ],
+      "type": "object"
+    },
+    "QLinkerRequest": {
+      "additionalProperties": false,
+      "description": "Q-Linker 远程 HTTP 请求配置。",
+      "properties": {
+        "autoTrigger": {
+          "description": "是否在输入变化时自动触发请求。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "bodyType": {
+          "default": "url_encoded",
+          "description": "请求体格式;分别映射后端 bodyType 1、2、3。",
+          "enum": [
+            "url_encoded",
+            "json",
+            "xml"
+          ]
+        },
+        "customButtonText": {
+          "description": "自定义触发按钮文案。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customButtonTextEnabled": {
+          "description": "是否启用自定义触发按钮文案。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "headers": {
+          "description": "请求头键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "hideOnForm": {
+          "description": "是否在表单填写界面隐藏该 Q-Linker 字段。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "insertValueDirectly": {
+          "description": "是否把请求结果直接写入目标字段。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "jsonValue": {
+          "description": "bodyType 为 json 时的 JSON 请求体字符串。动态字段值写成 {{key}},且 inputs 必须存在同名 source=json_path 映射;query_param、header、url_encoded 不会替换这里的占位符。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "method": {
+          "default": "GET",
+          "description": "HTTP 方法;当前 Q-Linker 仅支持 GET 和 POST,缺失时按 GET 处理。",
+          "enum": [
+            "GET",
+            "POST"
+          ]
+        },
+        "queryParams": {
+          "description": "URL 查询参数键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "resultType": {
+          "default": "json",
+          "description": "响应解析格式;分别映射后端 resultType 1、2、3。",
+          "enum": [
+            "json",
+            "xml",
+            "text"
+          ]
+        },
+        "url": {
+          "description": "请求 URL;动态嵌入字段值时使用 {{key}},并在 inputs 中提供同名 source=json_path 映射。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "urlEncodedValue": {
+          "description": "bodyType 为 url_encoded 时的表单键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "xmlValue": {
+          "description": "bodyType 为 xml 时的 XML 请求体字符串。动态字段值写成 {{key}},且 inputs 必须存在同名 source=json_path 映射。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "type": "object"
+    },
+    "ReferenceDefaultValue": {
+      "additionalProperties": false,
+      "properties": {
+        "applyId": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "dataTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "values": {
+          "items": {
+            "$ref": "#/$defs/DefaultValues"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "RelationConfig": {
+      "additionalProperties": false,
+      "description": "引用字段配置;引用其他应用中的数据。",
+      "properties": {
+        "beingDefaultFormulaAutoFillEnabled": {
+          "description": "是否启用引用字段的默认值公式自动填充。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultValueFormula": {
+          "description": "引用字段默认值自动填充使用的公式;仅在 beingDefaultFormulaAutoFillEnabled 为 true 时执行,null 表示清除。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/FormulaExpression"
+            }
+          ]
+        },
+        "defaultValueMatchRules": {
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "defaultValues": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/DefaultValues"
+            }
+          ]
+        },
+        "displayField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "引用值的主展示字段。"
+        },
+        "relationMode": {
+          "default": "single",
+          "description": "单条引用或多条引用;缺失时按 single 处理。",
+          "enum": [
+            "single",
+            "multiple"
+          ]
+        },
+        "targetAppKey": {
+          "description": "被引用应用的 appKey。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "visibleFields": {
+          "description": "引用选择界面额外展示的字段。",
+          "items": {
+            "$ref": "#/$defs/FieldSelector"
+          },
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "targetAppKey",
+        "displayField"
+      ],
+      "type": "object"
+    },
+    "RoleSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "roleId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "roleName": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "roleId"
+      ],
+      "type": "object"
+    },
+    "RowBlock": {
+      "additionalProperties": false,
+      "description": "根级普通字段行;字段顺序即展示顺序。",
+      "properties": {
+        "fields": {
+          "description": "本行的 1 到 4 个顶层字段。",
+          "items": {
+            "$ref": "#/$defs/TopField"
+          },
+          "maxItems": 4,
+          "minItems": 1,
+          "type": "array"
+        },
+        "kind": {
+          "const": "row",
+          "description": "普通行判别值。"
+        }
+      },
+      "required": [
+        "kind",
+        "fields"
+      ],
+      "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"
+      ]
+    },
+    "SectionBlock": {
+      "additionalProperties": false,
+      "description": "段落布局容器;不是业务字段,必须独占一个根级块。",
+      "properties": {
+        "kind": {
+          "const": "section",
+          "description": "段落判别值。"
+        },
+        "rows": {
+          "description": "段落内的非空有序字段行。",
+          "items": {
+            "$ref": "#/$defs/FieldRow"
+          },
+          "minItems": 1,
+          "type": "array"
+        },
+        "sectionId": {
+          "description": "已有段落的真实身份;get 把后端数值 queId 输出为无前导零的正十进制字符串,apply 仅在构造后端 payload 时转回数值 queId,新增段落省略。",
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "title": {
+          "description": "段落标题。",
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind",
+        "title",
+        "rows"
+      ],
+      "type": "object"
+    },
+    "SelectScopeRelation": {
+      "additionalProperties": false,
+      "properties": {
+        "displayedField": {
+          "$ref": "#/$defs/FieldSelector"
+        },
+        "displayedFieldType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "matchRuleFormula": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "matchRuleType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "matchRules": {
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "targetAppKey": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetAppTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "displayedField",
+        "targetAppKey"
+      ],
+      "type": "object"
+    },
+    "SerialComponent": {
+      "description": "自定义编号的组成部分;id 仅用于复用已有组件。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "description": "后端生成的组件 ID;get 返回,新增时省略。",
+              "minimum": 1,
+              "type": "integer"
+            },
+            "length": {
+              "description": "自动计数部分的位数。",
+              "maximum": 9,
+              "minimum": 3,
+              "type": "integer"
+            },
+            "repeatPeriod": {
+              "description": "自动计数器的重置周期。",
+              "enum": [
+                "none",
+                "day",
+                "week",
+                "month",
+                "year"
+              ]
+            },
+            "type": {
+              "const": "auto_count"
+            }
+          },
+          "required": [
+            "type",
+            "length",
+            "repeatPeriod"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "dateFormat": {
+              "description": "提交时间在编号中的格式。",
+              "enum": [
+                "year",
+                "year_month",
+                "year_month_day"
+              ]
+            },
+            "id": {
+              "minimum": 1,
+              "type": "integer"
+            },
+            "type": {
+              "const": "submit_datetime"
+            }
+          },
+          "required": [
+            "type",
+            "dateFormat"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "minimum": 1,
+              "type": "integer"
+            },
+            "type": {
+              "const": "fixed_text"
+            },
+            "value": {
+              "description": "固定拼接文本。",
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "dateFormat": {
+              "description": "来源为日期字段时的格式。",
+              "enum": [
+                "year",
+                "year_month",
+                "year_month_day"
+              ]
+            },
+            "field": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "自定义编号中参与拼接的取值来源字段。"
+            },
+            "id": {
+              "minimum": 1,
+              "type": "integer"
+            },
+            "type": {
+              "const": "field"
+            }
+          },
+          "required": [
+            "type",
+            "field"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "SerialNumber": {
+      "description": "应用数据编号配置;自定义模式必须且只能包含一个自动计数组件。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "mode": {
+              "const": "default",
+              "description": "使用系统默认编号规则。"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "components": {
+              "contains": {
+                "properties": {
+                  "type": {
+                    "const": "auto_count"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "type": "object"
+              },
+              "description": "自定义编号组件的完整有序目标态。",
+              "items": {
+                "$ref": "#/$defs/SerialComponent"
+              },
+              "maxContains": 1,
+              "minContains": 1,
+              "minItems": 1,
+              "type": "array"
+            },
+            "mode": {
+              "const": "custom",
+              "description": "使用按数组顺序拼接的自定义编号组件。"
+            }
+          },
+          "required": [
+            "mode",
+            "components"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "SubField": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/SubFieldCommon"
+        },
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/TextConfig"
+                },
+                "questionType": {
+                  "enum": [
+                    "text",
+                    "long_text",
+                    "link",
+                    "email"
+                  ]
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/PhoneConfig"
+                },
+                "questionType": {
+                  "const": "phone"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/NumberConfig"
+                },
+                "questionType": {
+                  "const": "number"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/EmptyConfig"
+                },
+                "questionType": {
+                  "const": "date"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/AttachmentConfig"
+                },
+                "questionType": {
+                  "const": "attachment"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/MemberConfig"
+                },
+                "questionType": {
+                  "const": "member"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/ChoiceConfig"
+                },
+                "questionType": {
+                  "enum": [
+                    "single_choice",
+                    "single_select",
+                    "multi_select"
+                  ]
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DepartmentConfig"
+                },
+                "questionType": {
+                  "const": "department"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/RelationConfig"
+                },
+                "questionType": {
+                  "const": "relation"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DataRelationConfig"
+                },
+                "questionType": {
+                  "const": "data_relation"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "表格子字段;仅允许一期白名单类型,不包含布局宽度。",
+      "type": "object",
+      "unevaluatedProperties": false
+    },
+    "SubFieldCommon": {
+      "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": "默认值类型,与 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 时不携带字面量默认值。显式 null 表示清除默认值。"
+        },
+        "name": {
+          "description": "子字段展示名称;新增子字段必填,已有子字段可在携带 queId 时省略。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有子字段的后端 ID;更新时用于精确定位并复用,新增子字段通常省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "questionDescription": {
+          "description": "子字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "子字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "SubtableConfig": {
+      "additionalProperties": false,
+      "description": "表格行数和重复值限制。",
+      "properties": {
+        "defaultValues": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/DefaultValues"
+            }
+          ]
+        },
+        "tableNoRepeatQuestion": {
+          "items": {
+            "$ref": "#/$defs/FieldSelector"
+          },
+          "type": "array"
+        },
+        "tableNoRepeatStatus": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "tableRowHeight": {
+          "minLength": 1,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "tableRowsLimit": {
+          "minimum": 1,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "TextConfig": {
+      "additionalProperties": false,
+      "description": "文字类字段的长度限制;省略表示保留当前值。",
+      "properties": {
+        "canScan": {
+          "description": "是否允许扫码输入。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "maxWordCount": {
+          "description": "最多字数;null 表示清除限制。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "minWordCount": {
+          "description": "最少字数;null 表示清除限制。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "noRepeat": {
+          "description": "是否禁止重复值。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "description": "扫码类型 ID。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "TopField": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/FieldCommon"
+        },
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/EmptyConfig"
+                },
+                "questionType": {
+                  "enum": [
+                    "date",
+                    "datetime"
+                  ]
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/TextConfig"
+                },
+                "questionType": {
+                  "enum": [
+                    "text",
+                    "long_text",
+                    "link",
+                    "email"
+                  ]
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/PhoneConfig"
+                },
+                "questionType": {
+                  "const": "phone"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/NumberConfig"
+                },
+                "questionType": {
+                  "enum": [
+                    "number",
+                    "amount"
+                  ]
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/MemberConfig"
+                },
+                "questionType": {
+                  "const": "member"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/AddressConfig"
+                },
+                "questionType": {
+                  "const": "address"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/AttachmentConfig"
+                },
+                "questionType": {
+                  "const": "attachment"
+                }
+              },
+              "required": [
+                "questionType"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/ChoiceConfig"
+                },
+                "questionType": {
+                  "enum": [
+                    "single_choice",
+                    "single_select",
+                    "multi_select"
+                  ]
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DepartmentConfig"
+                },
+                "questionType": {
+                  "const": "department"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/RelationConfig"
+                },
+                "questionType": {
+                  "const": "relation"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/QLinkerConfig"
+                },
+                "questionType": {
+                  "const": "q_linker"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/CodeBlockConfig"
+                },
+                "questionType": {
+                  "const": "code_block"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DataRelationConfig"
+                },
+                "questionType": {
+                  "const": "data_relation"
+                }
+              },
+              "required": [
+                "questionType",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/SubtableConfig"
+                },
+                "questionType": {
+                  "const": "subtable"
+                },
+                "subfields": {
+                  "items": {
+                    "$ref": "#/$defs/SubField"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "questionType",
+                "subfields"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "顶层业务字段;questionType 决定 config 或 subfields 的结构。",
+      "type": "object",
+      "unevaluatedProperties": false
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "oneOf": [
+    {
+      "required": [
+        "appKey"
+      ]
+    },
+    {
+      "not": {
+        "required": [
+          "appKey"
+        ]
+      },
+      "properties": {
+        "spec": {
+          "required": [
+            "appName"
+          ]
+        }
+      },
+      "required": [
+        "packageId"
+      ]
+    }
+  ],
+  "properties": {
+    "apiVersion": {
+      "const": "builder.qingflow.com/v1alpha1",
+      "description": "AppForm 契约版本;当前固定为 v1alpha1。"
+    },
+    "appKey": {
+      "description": "更新已有应用的唯一标识;存在非空值即进入更新模式。",
+      "minLength": 1,
+      "type": "string"
+    },
+    "packageId": {
+      "description": "创建时指定新应用所属包;更新时确保该包引用应用,不移除其他包引用。",
+      "minimum": 1,
+      "type": "integer"
+    },
+    "spec": {
+      "$ref": "#/$defs/AppFormSpec",
+      "description": "应用表单的最终声明状态。"
+    }
+  },
+  "required": [
+    "apiVersion",
+    "spec"
+  ],
+  "title": "Qingflow AppFormApply v1alpha1",
+  "type": "object",
+  "unevaluatedProperties": false
+}