@qingflow-tech/qingflow-cli 1.1.61 → 1.1.62

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/README.md +3 -3
  2. package/package.json +1 -1
  3. package/pyproject.toml +3 -1
  4. package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_CHARTS_WORKFLOW.md +1 -1
  5. package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_PORTAL_WORKFLOW.md +6 -258
  6. package/skills/qingflow-cli/reference/builder/20-build-complete-system.md +2 -2
  7. package/skills/qingflow-cli/reference/builder/30-schema-fields.md +22 -5
  8. package/skills/qingflow-cli/reference/builder/70-portal.md +71 -36
  9. package/skills/qingflow-cli/reference/builder/reference/app-delivery-sop.md +3 -3
  10. package/skills/qingflow-cli/reference/examples/portal/portal_apply_v1alpha1.example.json +100 -0
  11. package/skills/qingflow-cli/reference/examples/portal/portal_sections_all_types.example.json +6 -7
  12. package/src/qingflow_mcp/app_form_compat.py +3 -0
  13. package/src/qingflow_mcp/app_form_validator.py +89 -20
  14. package/src/qingflow_mcp/builder_facade/app_form.py +629 -112
  15. package/src/qingflow_mcp/builder_facade/models.py +197 -15
  16. package/src/qingflow_mcp/builder_facade/portals_schema.py +397 -0
  17. package/src/qingflow_mcp/builder_facade/schemas/app_form/manifest.json +15 -1
  18. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json +112 -38
  19. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/address.json +31 -8
  20. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_content_classification.json +146 -0
  21. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_content_extraction.json +146 -0
  22. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_content_generation.json +146 -0
  23. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_document_parsing.json +146 -0
  24. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_image_generation.json +146 -0
  25. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_image_recognition.json +146 -0
  26. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_machine_translation.json +146 -0
  27. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_text_summary.json +146 -0
  28. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json +6 -10
  29. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/attachment.json +33 -10
  30. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/code_block.json +6 -10
  31. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/data_relation.json +11 -18
  32. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date.json +4 -8
  33. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date_duration.json +146 -0
  34. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/datetime.json +4 -8
  35. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/department.json +6 -10
  36. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/email.json +4 -8
  37. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/embed_field.json +146 -0
  38. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/image_select.json +146 -0
  39. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/link.json +4 -8
  40. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/location.json +146 -0
  41. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/long_text.json +4 -8
  42. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/member.json +6 -10
  43. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/multi_select.json +4 -8
  44. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json +6 -10
  45. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ocr.json +146 -0
  46. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/phone.json +4 -8
  47. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/q_linker.json +8 -12
  48. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/relation.json +73 -15
  49. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json +146 -0
  50. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_choice.json +4 -8
  51. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_select.json +4 -8
  52. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json +90 -29
  53. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.json +4 -8
  54. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/formula.json +43 -0
  55. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json +27 -19
  56. package/src/qingflow_mcp/builder_facade/schemas/portals/manifest.json +59 -0
  57. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/complete.json +1397 -0
  58. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/carousel.json +193 -0
  59. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/chart.json +643 -0
  60. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/favourite.json +203 -0
  61. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/filter.json +249 -0
  62. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/grid.json +265 -0
  63. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/link.json +131 -0
  64. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/task.json +199 -0
  65. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/text.json +123 -0
  66. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/view.json +196 -0
  67. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/summary.json +800 -0
  68. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json +1 -1
  69. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/display.json +1 -1
  70. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/summary.json +1 -1
  71. package/src/qingflow_mcp/builder_facade/service.py +1359 -92
  72. package/src/qingflow_mcp/cli/commands/builder.py +120 -5
  73. package/src/qingflow_mcp/public_surface.py +2 -0
  74. package/src/qingflow_mcp/server_app_builder.py +34 -5
  75. package/src/qingflow_mcp/session_store.py +14 -1
  76. package/src/qingflow_mcp/solution/compiler/icon_utils.py +73 -0
  77. package/src/qingflow_mcp/solution/executor.py +5 -2
  78. package/src/qingflow_mcp/tools/ai_builder_tools.py +118 -20
  79. package/src/qingflow_mcp/tools/portal_tools.py +4 -54
  80. package/src/qingflow_mcp/tools/portal_writer.py +59 -0
  81. package/src/qingflow_mcp/tools/solution_tools.py +2 -0
@@ -0,0 +1,146 @@
1
+ {
2
+ "$defs": {
3
+ "EmptyConfig": {
4
+ "additionalProperties": false,
5
+ "description": "该字段类型没有特殊配置。",
6
+ "type": "object"
7
+ },
8
+ "FieldCommon": {
9
+ "allOf": [
10
+ {
11
+ "if": {
12
+ "properties": {
13
+ "defaultType": {
14
+ "const": 2
15
+ }
16
+ },
17
+ "required": [
18
+ "defaultType"
19
+ ]
20
+ },
21
+ "then": {
22
+ "properties": {
23
+ "defaultValue": {
24
+ "type": "null"
25
+ }
26
+ }
27
+ }
28
+ },
29
+ {
30
+ "if": {
31
+ "properties": {
32
+ "defaultType": {
33
+ "const": 3
34
+ }
35
+ },
36
+ "required": [
37
+ "defaultType"
38
+ ]
39
+ },
40
+ "then": {
41
+ "properties": {
42
+ "defaultValue": {
43
+ "minLength": 1,
44
+ "type": [
45
+ "string",
46
+ "null"
47
+ ]
48
+ }
49
+ }
50
+ }
51
+ }
52
+ ],
53
+ "anyOf": [
54
+ {
55
+ "required": [
56
+ "queId"
57
+ ]
58
+ },
59
+ {
60
+ "required": [
61
+ "name"
62
+ ]
63
+ }
64
+ ],
65
+ "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
66
+ "properties": {
67
+ "beingRequired": {
68
+ "description": "该字段是否必填;缺失时保留已有字段当前值。",
69
+ "type": "boolean"
70
+ },
71
+ "defaultType": {
72
+ "default": 1,
73
+ "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
74
+ "enum": [
75
+ 1,
76
+ 2,
77
+ 3
78
+ ],
79
+ "type": "integer"
80
+ },
81
+ "defaultValue": {
82
+ "$ref": "#/$defs/ScalarDefaultValue",
83
+ "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
84
+ },
85
+ "name": {
86
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
87
+ "minLength": 1,
88
+ "type": "string"
89
+ },
90
+ "queId": {
91
+ "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
92
+ "minimum": 1,
93
+ "type": "integer"
94
+ },
95
+ "questionDescription": {
96
+ "description": "字段说明;null 或空字符串表示清空。",
97
+ "type": [
98
+ "string",
99
+ "null"
100
+ ]
101
+ },
102
+ "questionType": {
103
+ "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
104
+ "type": "string"
105
+ },
106
+ "width": {
107
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
108
+ "maximum": 100,
109
+ "minimum": 1,
110
+ "type": "integer"
111
+ }
112
+ },
113
+ "type": "object"
114
+ },
115
+ "ScalarDefaultValue": {
116
+ "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。",
117
+ "type": [
118
+ "null",
119
+ "string"
120
+ ]
121
+ }
122
+ },
123
+ "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/location.json",
124
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
125
+ "allOf": [
126
+ {
127
+ "$ref": "#/$defs/FieldCommon"
128
+ },
129
+ {
130
+ "properties": {
131
+ "config": {
132
+ "$ref": "#/$defs/EmptyConfig"
133
+ },
134
+ "questionType": {
135
+ "const": "location"
136
+ }
137
+ },
138
+ "required": [
139
+ "questionType"
140
+ ]
141
+ }
142
+ ],
143
+ "title": "Qingflow AppForm v1alpha1 location field",
144
+ "type": "object",
145
+ "unevaluatedProperties": false
146
+ }
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
@@ -99,13 +99,9 @@
99
99
  "type": "string"
100
100
  },
101
101
  "width": {
102
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
103
- "enum": [
104
- 25,
105
- 50,
106
- 75,
107
- 100
108
- ],
102
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
103
+ "maximum": 100,
104
+ "minimum": 1,
109
105
  "type": "integer"
110
106
  }
111
107
  },
@@ -150,7 +150,7 @@
150
150
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
151
151
  },
152
152
  "name": {
153
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
153
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
154
154
  "minLength": 1,
155
155
  "type": "string"
156
156
  },
@@ -171,13 +171,9 @@
171
171
  "type": "string"
172
172
  },
173
173
  "width": {
174
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
175
- "enum": [
176
- 25,
177
- 50,
178
- 75,
179
- 100
180
- ],
174
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
175
+ "maximum": 100,
176
+ "minimum": 1,
181
177
  "type": "integer"
182
178
  }
183
179
  },
@@ -197,10 +193,10 @@
197
193
  ]
198
194
  }
199
195
  ],
200
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
196
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
201
197
  "properties": {
202
198
  "name": {
203
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
199
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
204
200
  "minLength": 1,
205
201
  "type": "string"
206
202
  },
@@ -146,7 +146,7 @@
146
146
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
147
147
  },
148
148
  "name": {
149
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
149
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
150
150
  "minLength": 1,
151
151
  "type": "string"
152
152
  },
@@ -167,13 +167,9 @@
167
167
  "type": "string"
168
168
  },
169
169
  "width": {
170
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
171
- "enum": [
172
- 25,
173
- 50,
174
- 75,
175
- 100
176
- ],
170
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
171
+ "maximum": 100,
172
+ "minimum": 1,
177
173
  "type": "integer"
178
174
  }
179
175
  },
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
@@ -99,13 +99,9 @@
99
99
  "type": "string"
100
100
  },
101
101
  "width": {
102
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
103
- "enum": [
104
- 25,
105
- 50,
106
- 75,
107
- 100
108
- ],
102
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
103
+ "maximum": 100,
104
+ "minimum": 1,
109
105
  "type": "integer"
110
106
  }
111
107
  },
@@ -177,8 +173,8 @@
177
173
  ]
178
174
  },
179
175
  "numberFormat": {
180
- "description": "数字展示格式 ID。",
181
- "minimum": 1,
176
+ "description": "数字展示格式 ID(1 默认/2 千分位/3 百分比;0 为历史存量值——后端写链无值域校验,原样落库回读)。",
177
+ "minimum": 0,
182
178
  "type": [
183
179
  "integer",
184
180
  "null"
@@ -0,0 +1,146 @@
1
+ {
2
+ "$defs": {
3
+ "EmptyConfig": {
4
+ "additionalProperties": false,
5
+ "description": "该字段类型没有特殊配置。",
6
+ "type": "object"
7
+ },
8
+ "FieldCommon": {
9
+ "allOf": [
10
+ {
11
+ "if": {
12
+ "properties": {
13
+ "defaultType": {
14
+ "const": 2
15
+ }
16
+ },
17
+ "required": [
18
+ "defaultType"
19
+ ]
20
+ },
21
+ "then": {
22
+ "properties": {
23
+ "defaultValue": {
24
+ "type": "null"
25
+ }
26
+ }
27
+ }
28
+ },
29
+ {
30
+ "if": {
31
+ "properties": {
32
+ "defaultType": {
33
+ "const": 3
34
+ }
35
+ },
36
+ "required": [
37
+ "defaultType"
38
+ ]
39
+ },
40
+ "then": {
41
+ "properties": {
42
+ "defaultValue": {
43
+ "minLength": 1,
44
+ "type": [
45
+ "string",
46
+ "null"
47
+ ]
48
+ }
49
+ }
50
+ }
51
+ }
52
+ ],
53
+ "anyOf": [
54
+ {
55
+ "required": [
56
+ "queId"
57
+ ]
58
+ },
59
+ {
60
+ "required": [
61
+ "name"
62
+ ]
63
+ }
64
+ ],
65
+ "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
66
+ "properties": {
67
+ "beingRequired": {
68
+ "description": "该字段是否必填;缺失时保留已有字段当前值。",
69
+ "type": "boolean"
70
+ },
71
+ "defaultType": {
72
+ "default": 1,
73
+ "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
74
+ "enum": [
75
+ 1,
76
+ 2,
77
+ 3
78
+ ],
79
+ "type": "integer"
80
+ },
81
+ "defaultValue": {
82
+ "$ref": "#/$defs/ScalarDefaultValue",
83
+ "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
84
+ },
85
+ "name": {
86
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
87
+ "minLength": 1,
88
+ "type": "string"
89
+ },
90
+ "queId": {
91
+ "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
92
+ "minimum": 1,
93
+ "type": "integer"
94
+ },
95
+ "questionDescription": {
96
+ "description": "字段说明;null 或空字符串表示清空。",
97
+ "type": [
98
+ "string",
99
+ "null"
100
+ ]
101
+ },
102
+ "questionType": {
103
+ "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
104
+ "type": "string"
105
+ },
106
+ "width": {
107
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
108
+ "maximum": 100,
109
+ "minimum": 1,
110
+ "type": "integer"
111
+ }
112
+ },
113
+ "type": "object"
114
+ },
115
+ "ScalarDefaultValue": {
116
+ "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。",
117
+ "type": [
118
+ "null",
119
+ "string"
120
+ ]
121
+ }
122
+ },
123
+ "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/ocr.json",
124
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
125
+ "allOf": [
126
+ {
127
+ "$ref": "#/$defs/FieldCommon"
128
+ },
129
+ {
130
+ "properties": {
131
+ "config": {
132
+ "$ref": "#/$defs/EmptyConfig"
133
+ },
134
+ "questionType": {
135
+ "const": "ocr"
136
+ }
137
+ },
138
+ "required": [
139
+ "questionType"
140
+ ]
141
+ }
142
+ ],
143
+ "title": "Qingflow AppForm v1alpha1 ocr field",
144
+ "type": "object",
145
+ "unevaluatedProperties": false
146
+ }
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
@@ -99,13 +99,9 @@
99
99
  "type": "string"
100
100
  },
101
101
  "width": {
102
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
103
- "enum": [
104
- 25,
105
- 50,
106
- 75,
107
- 100
108
- ],
102
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
103
+ "maximum": 100,
104
+ "minimum": 1,
109
105
  "type": "integer"
110
106
  }
111
107
  },
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
@@ -99,13 +99,9 @@
99
99
  "type": "string"
100
100
  },
101
101
  "width": {
102
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
103
- "enum": [
104
- 25,
105
- 50,
106
- 75,
107
- 100
108
- ],
102
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
103
+ "maximum": 100,
104
+ "minimum": 1,
109
105
  "type": "integer"
110
106
  }
111
107
  },
@@ -125,10 +121,10 @@
125
121
  ]
126
122
  }
127
123
  ],
128
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
124
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
129
125
  "properties": {
130
126
  "name": {
131
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
127
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
132
128
  "minLength": 1,
133
129
  "type": "string"
134
130
  },
@@ -353,8 +349,8 @@
353
349
  ]
354
350
  },
355
351
  "url": {
356
- "description": "请求 URL;动态嵌入字段值时使用 {{key}},并在 inputs 中提供同名 source=json_path 映射。",
357
- "minLength": 1,
352
+ "description": "请求 URL;动态嵌入字段值时使用 {{key}},并在 inputs 中提供同名 source=json_path 映射。自定义模式(configMode=1)后端要求非空;插件模板/连接中心/轻翼智能体模式的 URL 由模板侧提供,存量声明可为空字符串(写回按读面形态透传)。",
353
+ "minLength": 0,
358
354
  "type": "string"
359
355
  },
360
356
  "urlEncodedValue": {
@@ -75,6 +75,12 @@
75
75
  "null"
76
76
  ]
77
77
  },
78
+ "auditValueDescription": {
79
+ "type": [
80
+ "string",
81
+ "null"
82
+ ]
83
+ },
78
84
  "beingCanDecrypted": {
79
85
  "type": [
80
86
  "boolean",
@@ -105,6 +111,12 @@
105
111
  "null"
106
112
  ]
107
113
  },
114
+ "dataId": {
115
+ "type": [
116
+ "integer",
117
+ "null"
118
+ ]
119
+ },
108
120
  "dateType": {
109
121
  "type": [
110
122
  "integer",
@@ -123,6 +135,15 @@
123
135
  "null"
124
136
  ]
125
137
  },
138
+ "previousTableRowOrdinalList": {
139
+ "items": {
140
+ "type": "integer"
141
+ },
142
+ "type": [
143
+ "array",
144
+ "null"
145
+ ]
146
+ },
126
147
  "queId": {
127
148
  "type": [
128
149
  "integer",
@@ -141,6 +162,12 @@
141
162
  "null"
142
163
  ]
143
164
  },
165
+ "questionOrdinal": {
166
+ "type": [
167
+ "integer",
168
+ "null"
169
+ ]
170
+ },
144
171
  "referValues": {
145
172
  "items": {
146
173
  "$ref": "#/$defs/ReferenceDefaultValue"
@@ -258,7 +285,7 @@
258
285
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
259
286
  },
260
287
  "name": {
261
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
288
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
262
289
  "minLength": 1,
263
290
  "type": "string"
264
291
  },
@@ -279,13 +306,9 @@
279
306
  "type": "string"
280
307
  },
281
308
  "width": {
282
- "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
283
- "enum": [
284
- 25,
285
- 50,
286
- 75,
287
- 100
288
- ],
309
+ "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
310
+ "maximum": 100,
311
+ "minimum": 1,
289
312
  "type": "integer"
290
313
  }
291
314
  },
@@ -305,10 +328,10 @@
305
328
  ]
306
329
  }
307
330
  ],
308
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
331
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
309
332
  "properties": {
310
333
  "name": {
311
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
334
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
312
335
  "minLength": 1,
313
336
  "type": "string"
314
337
  },
@@ -351,7 +374,7 @@
351
374
  },
352
375
  "RelationConfig": {
353
376
  "additionalProperties": false,
354
- "description": "引用字段配置;引用其他应用中的数据。",
377
+ "description": "引用字段配置;引用其他应用中的数据。展示字段与权限以 displayFields 为准(后端 referQuestions 全量有序回写,queAuth 1=可编辑/2=隐藏/3=仅可见);displayField/visibleFields 为已废弃旧形态,apply 兼容接收一个版本窗口(displayField 同时视为双向绑定目标)。",
355
378
  "properties": {
356
379
  "beingDefaultFormulaAutoFillEnabled": {
357
380
  "description": "是否启用引用字段的默认值公式自动填充。",
@@ -389,7 +412,32 @@
389
412
  },
390
413
  "displayField": {
391
414
  "$ref": "#/$defs/FieldSelector",
392
- "description": "引用值的主展示字段。"
415
+ "description": "已废弃:主展示字段;apply 兼容翻译为 twoWayBoundField + displayFields 首项,后续版本移除。"
416
+ },
417
+ "displayFields": {
418
+ "description": "有序展示字段全量列表(含隐藏字段),按 ordinal 保序回写为后端 referQuestions。可为空列表:空 = 双向绑定未配展示字段的合法存量形态(后端写链路对空 referQuestions 跳过插入、读面容忍空),round-trip 空↔空稳定;与已废弃 displayField/visibleFields 不可混用,条目 queId 不可重复。",
419
+ "items": {
420
+ "additionalProperties": false,
421
+ "properties": {
422
+ "auth": {
423
+ "default": "visible",
424
+ "description": "展示字段权限;editable=可编辑(1), hidden=隐藏(2), visible=仅可见(3);缺失按 visible。",
425
+ "enum": [
426
+ "editable",
427
+ "hidden",
428
+ "visible"
429
+ ]
430
+ },
431
+ "field": {
432
+ "$ref": "#/$defs/FieldSelector"
433
+ }
434
+ },
435
+ "required": [
436
+ "field"
437
+ ],
438
+ "type": "object"
439
+ },
440
+ "type": "array"
393
441
  },
394
442
  "relationMode": {
395
443
  "default": "single",
@@ -404,8 +452,19 @@
404
452
  "minLength": 1,
405
453
  "type": "string"
406
454
  },
455
+ "twoWayBoundField": {
456
+ "description": "双向引用绑定的目标字段(后端 referQueId);null/省略 = 单向引用。get 读面在 referQueId 非空时必产出。",
457
+ "oneOf": [
458
+ {
459
+ "type": "null"
460
+ },
461
+ {
462
+ "$ref": "#/$defs/FieldSelector"
463
+ }
464
+ ]
465
+ },
407
466
  "visibleFields": {
408
- "description": "引用选择界面额外展示的字段。",
467
+ "description": "已废弃:额外展示字段;apply 兼容翻译为 displayFields 后续项,后续版本移除。",
409
468
  "items": {
410
469
  "$ref": "#/$defs/FieldSelector"
411
470
  },
@@ -414,8 +473,7 @@
414
473
  }
415
474
  },
416
475
  "required": [
417
- "targetAppKey",
418
- "displayField"
476
+ "targetAppKey"
419
477
  ],
420
478
  "type": "object"
421
479
  },