@qingflow-tech/qingflow-cli 1.1.42 → 1.1.43-beta.1

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

@@ -0,0 +1,1766 @@
+{
+  "$defs": {
+    "AliasSelector": {
+      "additionalProperties": false,
+      "description": "Q-Linker 或代码块输出别名;已有输出优先携带 aliasId。",
+      "properties": {
+        "aliasId": {
+          "description": "后端生成的别名 ID;新增输出时可省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "name": {
+          "description": "输出别名名称。",
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "AppFormSpec": {
+      "additionalProperties": false,
+      "description": "表单基础配置与字段布局目标态;除 body 外,缺失属性表示保留当前值。",
+      "properties": {
+        "appName": {
+          "description": "应用名称;缺失时保留当前名称。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "attachments": {
+          "description": "应用附件完整目标态;空数组表示删除全部应用附件。",
+          "items": {
+            "$ref": "#/$defs/Attachment"
+          },
+          "type": "array"
+        },
+        "body": {
+          "$ref": "#/$defs/Body",
+          "description": "业务字段与布局的完整目标态;缺失字段或段落表示删除。"
+        },
+        "color": {
+          "description": "新应用图标颜色;仅创建分支允许,必须来自 workspace icon color catalog。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "description": {
+          "description": "应用描述;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "icon": {
+          "description": "新应用图标;仅创建分支允许,必须来自 workspace icon catalog 且不得为 template。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "serialNumber": {
+          "$ref": "#/$defs/SerialNumber",
+          "description": "应用编号规则;支持默认编号或自定义组件编号。"
+        },
+        "style": {
+          "description": "应用样式;对象内缺失属性保留当前值,null 表示清除全部自定义样式。",
+          "oneOf": [
+            {
+              "$ref": "#/$defs/Style"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "theme": {
+          "description": "应用主题 ID;null 表示清除自定义主题。",
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "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"
+    },
+    "Body": {
+      "description": "有序表单内容块;空数组表示删除全部业务字段和段落。",
+      "items": {
+        "$ref": "#/$defs/BodyBlock"
+      },
+      "type": "array"
+    },
+    "BodyBlock": {
+      "description": "根级普通行或独占外层位置的段落。",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/RowBlock"
+        },
+        {
+          "$ref": "#/$defs/SectionBlock"
+        }
+      ]
+    },
+    "ChoiceConfig": {
+      "additionalProperties": false,
+      "description": "选择类字段配置。",
+      "properties": {
+        "options": {
+          "description": "非空有序选项文案;缺失选项表示从该字段配置中删除。",
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "minItems": 1,
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "options"
+      ],
+      "type": "object"
+    },
+    "CodeBlockBinding": {
+      "additionalProperties": false,
+      "description": "代码块的输入、代码和输出映射。",
+      "properties": {
+        "autoTrigger": {
+          "description": "是否在输入变化时自动执行代码块。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "code": {
+          "description": "代码块源码;MCP/CLI 仅保存,不执行。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "customButtonText": {
+          "description": "自定义触发按钮文案。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customButtonTextEnabled": {
+          "description": "是否启用自定义触发按钮文案。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "hideOnForm": {
+          "description": "是否在表单填写界面隐藏该代码块字段。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "inputs": {
+          "description": "当前表单字段到代码变量的映射。",
+          "items": {
+            "$ref": "#/$defs/CodeBlockInputBinding"
+          },
+          "type": "array"
+        },
+        "outputs": {
+          "description": "代码输出路径到目标字段的映射。",
+          "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": "一个表单字段到代码变量的映射。",
+      "properties": {
+        "field": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "输入来源字段。"
+        },
+        "var": {
+          "description": "代码中的变量名;null 表示沿用后端默认变量名。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "field"
+      ],
+      "type": "object"
+    },
+    "CodeBlockOutputBinding": {
+      "additionalProperties": false,
+      "description": "一个代码输出值到表单字段的映射。",
+      "properties": {
+        "alias": {
+          "description": "输出别名;用于后续数据关联引用。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "aliasId": {
+          "description": "后端生成的输出别名 ID;新增输出时可省略,get 返回后必须保留。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "path": {
+          "description": "从 qf_output 中取值的 JSONPath。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "接收结果的当前表单字段。"
+        }
+      },
+      "required": [
+        "alias",
+        "path",
+        "targetField"
+      ],
+      "type": "object"
+    },
+    "DataRelationCondition": {
+      "additionalProperties": false,
+      "description": "一条数据关联过滤条件。",
+      "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 模式使用完整公式。",
+      "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": "字面量值列表。",
+              "items": {
+                "$ref": "#/$defs/JsonValue"
+              },
+              "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"
+        }
+      ]
+    },
+    "DepartmentConfig": {
+      "additionalProperties": false,
+      "description": "部门字段的可选范围配置。",
+      "properties": {
+        "departmentScope": {
+          "$ref": "#/$defs/DepartmentScope"
+        }
+      },
+      "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"
+        }
+      ]
+    },
+    "DepartmentSelector": {
+      "additionalProperties": false,
+      "description": "部门身份;deptId 必填,deptName 仅用于展示。",
+      "properties": {
+        "deptId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "deptName": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "deptId"
+      ],
+      "type": "object"
+    },
+    "EmptyConfig": {
+      "additionalProperties": false,
+      "description": "该字段类型没有特殊配置。",
+      "type": "object"
+    },
+    "FieldCommon": {
+      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
+      "properties": {
+        "dataCover": {
+          "description": "是否作为数据封面;仅顶层附件字段可设为 true。",
+          "type": "boolean"
+        },
+        "dataTitle": {
+          "description": "是否作为数据标题;整个 body 最多且必须按规则存在一个。",
+          "type": "boolean"
+        },
+        "description": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "字段展示名称;同一父级内唯一,不单独作为字段身份。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;get 返回,新增字段省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "required": {
+          "description": "是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比;同一行要么全部提供且合计 100,要么全部省略。",
+          "maximum": 100,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "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"
+    },
+    "JsonValue": {
+      "description": "数据关联字面量支持的任意 JSON 值。",
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "items": {
+            "$ref": "#/$defs/JsonValue"
+          },
+          "type": "array"
+        },
+        {
+          "additionalProperties": {
+            "$ref": "#/$defs/JsonValue"
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "QLinkerBinding": {
+      "additionalProperties": false,
+      "description": "Q-Linker 的输入映射、请求配置和输出映射。",
+      "properties": {
+        "inputs": {
+          "description": "将当前表单字段映射到请求参数的规则。",
+          "items": {
+            "$ref": "#/$defs/QLinkerInputBinding"
+          },
+          "type": "array"
+        },
+        "outputs": {
+          "description": "将响应路径映射到目标字段的规则;至少一个。",
+          "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": "一个表单字段到请求参数的映射。",
+      "properties": {
+        "field": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "输入来源字段。"
+        },
+        "key": {
+          "description": "请求中的参数名。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "source": {
+          "description": "参数写入请求的位置。",
+          "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": "一个响应值到表单目标字段的映射。",
+      "properties": {
+        "alias": {
+          "description": "输出别名;用于后续数据关联引用。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "aliasId": {
+          "description": "后端生成的输出别名 ID;新增输出时可省略,get 返回后必须保留。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "path": {
+          "description": "从响应中取值的 JSONPath。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "接收结果的当前表单字段。"
+        }
+      },
+      "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 请求体字符串。",
+          "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。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "urlEncodedValue": {
+          "description": "bodyType 为 url_encoded 时的表单键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "xmlValue": {
+          "description": "bodyType 为 xml 时的 XML 请求体字符串。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "type": "object"
+    },
+    "RelationConfig": {
+      "additionalProperties": false,
+      "description": "引用字段配置;引用其他应用中的数据。",
+      "properties": {
+        "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"
+    },
+    "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"
+    },
+    "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"
+    },
+    "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"
+        }
+      ]
+    },
+    "Style": {
+      "additionalProperties": false,
+      "description": "表单背景和头部视觉样式;颜色使用 CSS 颜色字符串。",
+      "properties": {
+        "bgColor": {
+          "description": "表单背景色;null 表示清除。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "bgImage": {
+          "description": "表单背景图片 URL;null 表示清除。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "fontColor": {
+          "description": "表单头部字体颜色;null 表示清除。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "headerColor": {
+          "description": "表单头部背景色;null 表示清除。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "headerImage": {
+          "description": "表单头图 URL;null 表示清除。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "opacity": {
+          "description": "背景透明度,取值 0 到 1;null 表示清除。",
+          "maximum": 1,
+          "minimum": 0,
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "SubField": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/SubFieldCommon"
+        },
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/EmptyConfig"
+                },
+                "type": {
+                  "enum": [
+                    "text",
+                    "long_text",
+                    "number",
+                    "link",
+                    "date",
+                    "phone",
+                    "email",
+                    "attachment",
+                    "member"
+                  ]
+                }
+              },
+              "required": [
+                "type"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/ChoiceConfig"
+                },
+                "type": {
+                  "enum": [
+                    "single_choice",
+                    "single_select",
+                    "multi_select"
+                  ]
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DepartmentConfig"
+                },
+                "type": {
+                  "const": "department"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/RelationConfig"
+                },
+                "type": {
+                  "const": "relation"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DataRelationConfig"
+                },
+                "type": {
+                  "const": "data_relation"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "表格子字段;仅允许一期白名单类型,不包含布局宽度。",
+      "type": "object",
+      "unevaluatedProperties": false
+    },
+    "SubFieldCommon": {
+      "description": "表格子字段的公共属性;不允许 dataTitle、dataCover 或 width。",
+      "properties": {
+        "description": {
+          "description": "子字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "子字段展示名称;在所属表格内唯一。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有子字段的后端 ID;新增时省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "required": {
+          "description": "是否必填;缺失时保留当前值。",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "TopField": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/FieldCommon"
+        },
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/EmptyConfig"
+                },
+                "type": {
+                  "enum": [
+                    "text",
+                    "long_text",
+                    "number",
+                    "amount",
+                    "link",
+                    "date",
+                    "datetime",
+                    "member",
+                    "phone",
+                    "email",
+                    "address",
+                    "attachment"
+                  ]
+                }
+              },
+              "required": [
+                "type"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/ChoiceConfig"
+                },
+                "type": {
+                  "enum": [
+                    "single_choice",
+                    "single_select",
+                    "multi_select"
+                  ]
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DepartmentConfig"
+                },
+                "type": {
+                  "const": "department"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/RelationConfig"
+                },
+                "type": {
+                  "const": "relation"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/QLinkerConfig"
+                },
+                "type": {
+                  "const": "q_linker"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/CodeBlockConfig"
+                },
+                "type": {
+                  "const": "code_block"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DataRelationConfig"
+                },
+                "type": {
+                  "const": "data_relation"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/EmptyConfig"
+                },
+                "subfields": {
+                  "items": {
+                    "$ref": "#/$defs/SubField"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "type": {
+                  "const": "subtable"
+                }
+              },
+              "required": [
+                "type",
+                "subfields"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "顶层业务字段;type 决定 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": [
+    {
+      "properties": {
+        "spec": {
+          "not": {
+            "anyOf": [
+              {
+                "required": [
+                  "icon"
+                ]
+              },
+              {
+                "required": [
+                  "color"
+                ]
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "appKey"
+      ]
+    },
+    {
+      "not": {
+        "required": [
+          "appKey"
+        ]
+      },
+      "properties": {
+        "spec": {
+          "required": [
+            "appName",
+            "icon",
+            "color"
+          ]
+        }
+      },
+      "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
+}