@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,203 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/favourite.json",
4
+ "title": "Qingflow Builder Portals Section · favourite (v1alpha1)",
5
+ "portalFavouriteSectionDescription": "门户收藏组件(favourite)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind favourite(MCP: portal_schema(schema_kind=\"favourite\"))。本 Schema 校验 sections[] 中单个 favourite 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=7。整门户声明走 summary/complete 档。",
6
+ "$defs": {
7
+ "Position": {
8
+ "type": "object",
9
+ "additionalProperties": false,
10
+ "positionShapeDescription": "网格位置。PC 是 24 列网格(cols≤24),mobile 是 6 列网格(cols≤6);同行组件共享同一 y 与 rows,一行 cols 合计 24。mobile 可省略(缺省与 pc 同布局)。平铺别名 pc_x/pc_y/pc_w/pc_h、mobile_* 也接受(x/y 与 w/h/cols/rows 混写均认),归一为本结构。标准行高:指标卡 rows=5、BI 图表 rows=7、数据视图 rows=11、业务入口 rows=4。",
11
+ "properties": {
12
+ "pc": {
13
+ "$ref": "#/$defs/PositionDetail"
14
+ },
15
+ "mobile": {
16
+ "$ref": "#/$defs/PositionDetail"
17
+ }
18
+ }
19
+ },
20
+ "PositionDetail": {
21
+ "type": "object",
22
+ "additionalProperties": false,
23
+ "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
24
+ "properties": {
25
+ "x": {
26
+ "type": [
27
+ "integer",
28
+ "null"
29
+ ],
30
+ "minimum": 0
31
+ },
32
+ "y": {
33
+ "type": [
34
+ "integer",
35
+ "null"
36
+ ],
37
+ "minimum": 0
38
+ },
39
+ "cols": {
40
+ "type": [
41
+ "integer",
42
+ "null"
43
+ ],
44
+ "minimum": 1
45
+ },
46
+ "rows": {
47
+ "type": [
48
+ "integer",
49
+ "null"
50
+ ],
51
+ "minimum": 1
52
+ }
53
+ },
54
+ "x-backend": "DashPosition.pc / DashPosition.mobile"
55
+ },
56
+ "FavouriteConfig": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "favouriteConfigShapeDescription": "收藏组件配置。",
60
+ "properties": {
61
+ "show_title": {
62
+ "type": "boolean",
63
+ "default": true,
64
+ "favouriteShowTitleShapeDescription": "是否显示收藏标题。别名 beingShowTitle。",
65
+ "x-backend": "ComponentFavouriteConfig.beingShowTitle"
66
+ },
67
+ "enabled": {
68
+ "type": "boolean",
69
+ "favouriteEnabledShapeDescription": "收藏组件是否启用。别名 beingUsing。",
70
+ "x-backend": "ComponentFavouriteConfig.beingUsing"
71
+ },
72
+ "items": {
73
+ "type": "array",
74
+ "favouriteItemsShapeDescription": "收藏条目(用户级收藏为主,声明面预置初始条目;ordinal 缺省按数组顺序)。",
75
+ "items": {
76
+ "$ref": "#/$defs/FavouriteItem"
77
+ },
78
+ "x-backend": "ComponentFavouriteConfig.items(ComponentFavouriteItemInfo)"
79
+ }
80
+ }
81
+ },
82
+ "FavouriteItem": {
83
+ "type": "object",
84
+ "additionalProperties": false,
85
+ "required": [
86
+ "title"
87
+ ],
88
+ "favouriteItemShapeDescription": "单个收藏条目。",
89
+ "properties": {
90
+ "title": {
91
+ "type": "string",
92
+ "favouriteItemTitleShapeDescription": "条目标题。",
93
+ "x-backend": "ComponentFavouriteItemInfo.title"
94
+ },
95
+ "item_type": {
96
+ "type": "integer",
97
+ "favouriteItemTypeShapeDescription": "条目类型。别名 type。",
98
+ "x-backend": "ComponentFavouriteItemInfo.type"
99
+ },
100
+ "link_key": {
101
+ "type": "string",
102
+ "favouriteItemLinkKeyShapeDescription": "目标资源 key(应用/门户 key)。",
103
+ "x-backend": "ComponentFavouriteItemInfo.linkKey"
104
+ },
105
+ "link_id": {
106
+ "type": "integer",
107
+ "favouriteItemLinkIdShapeDescription": "目标资源 id。",
108
+ "x-backend": "ComponentFavouriteItemInfo.linkId"
109
+ },
110
+ "icon_url": {
111
+ "type": "string",
112
+ "favouriteItemIconShapeDescription": "条目图标 url。别名 iconUrl。",
113
+ "x-backend": "ComponentFavouriteItemInfo.iconUrl"
114
+ },
115
+ "jump_mode": {
116
+ "type": "integer",
117
+ "favouriteItemJumpModeShapeDescription": "跳转方式。",
118
+ "x-backend": "ComponentFavouriteItemInfo.jumpMode"
119
+ },
120
+ "ordinal": {
121
+ "type": "integer",
122
+ "favouriteItemOrdinalShapeDescription": "排序序号。",
123
+ "x-backend": "ComponentFavouriteItemInfo.ordinal"
124
+ }
125
+ }
126
+ },
127
+ "Section": {
128
+ "type": "object",
129
+ "additionalProperties": false,
130
+ "required": [
131
+ "title",
132
+ "source_type",
133
+ "favourite"
134
+ ],
135
+ "properties": {
136
+ "title": {
137
+ "type": "string",
138
+ "minLength": 1,
139
+ "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
140
+ "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
141
+ },
142
+ "source_type": {
143
+ "const": "favourite",
144
+ "sourceTypeConstDescription": "组件类型固定为 favourite(收藏);后端 type 整数见 x-backend。",
145
+ "x-backend": "DashComponentInfo.type(favourite)"
146
+ },
147
+ "role": {
148
+ "type": "string",
149
+ "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
150
+ },
151
+ "position": {
152
+ "$ref": "#/$defs/Position"
153
+ },
154
+ "style_config": {
155
+ "type": "object",
156
+ "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
157
+ "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
158
+ },
159
+ "favourite": {
160
+ "$ref": "#/$defs/FavouriteConfig",
161
+ "favouritePropDescription": "收藏配置(必填)。"
162
+ }
163
+ }
164
+ }
165
+ },
166
+ "$ref": "#/$defs/Section",
167
+ "x-qingflow-detail-query": {
168
+ "currentKind": "favourite",
169
+ "tool": "portal_schema",
170
+ "cli": "qingflow builder portal schema --schema-kind favourite",
171
+ "argument": "schema_kind",
172
+ "detailQueryDescription": "本文件是 收藏组件的自包含专项 Schema(内联全部引用定义,可独立交给 JSON Schema 校验器)。chart/view/grid/filter/text/link/carousel/task/favourite 各组件专项 Schema分别经 qingflow builder portal schema --schema-kind <类型> 获取。整门户声明用 qingflow builder portal schema --schema-kind summary|complete 获取;回读既有门户用 qingflow builder portal get --dash-key K --schema-kind complete。",
173
+ "readSources": {
174
+ "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
175
+ "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
176
+ }
177
+ },
178
+ "examples": [
179
+ {
180
+ "title": "常用入口",
181
+ "source_type": "favourite",
182
+ "position": {
183
+ "pc": {
184
+ "x": 12,
185
+ "y": 11,
186
+ "cols": 12,
187
+ "rows": 8
188
+ }
189
+ },
190
+ "favourite": {
191
+ "show_title": true,
192
+ "items": [
193
+ {
194
+ "title": "设备台账",
195
+ "item_type": 1,
196
+ "link_key": "APP_KEY_DEVICE",
197
+ "jump_mode": 1
198
+ }
199
+ ]
200
+ }
201
+ }
202
+ ]
203
+ }
@@ -0,0 +1,249 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/filter.json",
4
+ "title": "Qingflow Builder Portals Section · filter (v1alpha1)",
5
+ "portalFilterSectionDescription": "门户筛选组件(filter)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind filter(MCP: portal_schema(schema_kind=\"filter\"))。本 Schema 校验 sections[] 中单个 filter 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=6。整门户声明走 summary/complete 档。",
6
+ "$defs": {
7
+ "Position": {
8
+ "type": "object",
9
+ "additionalProperties": false,
10
+ "positionShapeDescription": "网格位置。PC 是 24 列网格(cols≤24),mobile 是 6 列网格(cols≤6);同行组件共享同一 y 与 rows,一行 cols 合计 24。mobile 可省略(缺省与 pc 同布局)。平铺别名 pc_x/pc_y/pc_w/pc_h、mobile_* 也接受(x/y 与 w/h/cols/rows 混写均认),归一为本结构。标准行高:指标卡 rows=5、BI 图表 rows=7、数据视图 rows=11、业务入口 rows=4。",
11
+ "properties": {
12
+ "pc": {
13
+ "$ref": "#/$defs/PositionDetail"
14
+ },
15
+ "mobile": {
16
+ "$ref": "#/$defs/PositionDetail"
17
+ }
18
+ }
19
+ },
20
+ "PositionDetail": {
21
+ "type": "object",
22
+ "additionalProperties": false,
23
+ "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
24
+ "properties": {
25
+ "x": {
26
+ "type": [
27
+ "integer",
28
+ "null"
29
+ ],
30
+ "minimum": 0
31
+ },
32
+ "y": {
33
+ "type": [
34
+ "integer",
35
+ "null"
36
+ ],
37
+ "minimum": 0
38
+ },
39
+ "cols": {
40
+ "type": [
41
+ "integer",
42
+ "null"
43
+ ],
44
+ "minimum": 1
45
+ },
46
+ "rows": {
47
+ "type": [
48
+ "integer",
49
+ "null"
50
+ ],
51
+ "minimum": 1
52
+ }
53
+ },
54
+ "x-backend": "DashPosition.pc / DashPosition.mobile"
55
+ },
56
+ "FilterConfig": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "required": [
60
+ "rules"
61
+ ],
62
+ "filterConfigShapeDescription": "筛选组件配置。rules 必须非空——后端读面(DashSvcImpl#getComponentFilter)按筛选组(dash_filter_group 行)反查筛选组件,空规则的 filter 组件行虽会写入但读面枚举不到,表现为「apply 成功、回读缺该组件」;规则键集为受控透传(filterGroupName/filterGroupConfig/filterItemName/que/judge 系,以 ws40013 dataset 实测形态定稿)。",
63
+ "properties": {
64
+ "graphs": {
65
+ "type": "array",
66
+ "filterGraphsShapeDescription": "筛选作用的图表引用(为空表示作用于全部图表)。",
67
+ "items": {
68
+ "$ref": "#/$defs/FilterGraphRef"
69
+ },
70
+ "x-backend": "ComponentFilter.graphList(GraphVO.graphKey/graphName/graphType)"
71
+ },
72
+ "rules": {
73
+ "type": "array",
74
+ "minItems": 1,
75
+ "filterRulesShapeDescription": "筛选规则组(至少 1 组)。组键:filterGroupName(组名,必填)、filterGroupConfig(组内筛选项列表);项键:filterItemName、que{queId}(绑定字段)、judge{judgeType,judgeValues}(默认条件)。代理键 filterGroupId/filterItemId 为后端自增位移键,读写两侧均剔除,不要携带。",
76
+ "items": {
77
+ "$ref": "#/$defs/FilterRuleGroup"
78
+ },
79
+ "x-backend": "ComponentFilter.filterConfig(List<FilterConfig>)"
80
+ }
81
+ }
82
+ },
83
+ "FilterGraphRef": {
84
+ "type": "object",
85
+ "additionalProperties": false,
86
+ "filterGraphRefShapeDescription": "受筛选作用的图表引用;chart_key 或 chart_name 至少一个。",
87
+ "anyOf": [
88
+ {
89
+ "required": [
90
+ "chart_key"
91
+ ]
92
+ },
93
+ {
94
+ "required": [
95
+ "chart_name"
96
+ ]
97
+ }
98
+ ],
99
+ "properties": {
100
+ "chart_key": {
101
+ "type": "string",
102
+ "filterGraphKeyShapeDescription": "图表 key。别名 chartKey/graphKey。",
103
+ "x-backend": "GraphVO.graphKey"
104
+ },
105
+ "chart_name": {
106
+ "type": "string",
107
+ "filterGraphNameShapeDescription": "图表名称。别名 graphName。",
108
+ "x-backend": "GraphVO.graphName"
109
+ }
110
+ }
111
+ },
112
+ "FilterRuleGroup": {
113
+ "type": "object",
114
+ "required": [
115
+ "filterGroupName"
116
+ ],
117
+ "filterRuleGroupShapeDescription": "筛选规则组。组内筛选项走 filterGroupConfig;其余后端键受控透传。",
118
+ "properties": {
119
+ "filterGroupName": {
120
+ "type": "string",
121
+ "filterRuleGroupNameShapeDescription": "组名称(读面渲染为分组标题)。",
122
+ "x-backend": "FilterConfig.filterGroupName"
123
+ },
124
+ "filterGroupConfig": {
125
+ "type": "array",
126
+ "filterRuleGroupItemsShapeDescription": "组内筛选项(绑定字段与默认条件)。",
127
+ "items": {
128
+ "$ref": "#/$defs/FilterRuleItem"
129
+ },
130
+ "x-backend": "FilterConfig.filterGroupConfig(List<FilterGroupConfig>)"
131
+ }
132
+ }
133
+ },
134
+ "FilterRuleItem": {
135
+ "type": "object",
136
+ "required": [
137
+ "filterItemName"
138
+ ],
139
+ "filterRuleItemShapeDescription": "单个筛选项(绑定一个字段)。que/judge 为后端受控透传形态;条件表达式(关联图表/字段)键集以 dataset 实测形态为准。",
140
+ "properties": {
141
+ "filterItemName": {
142
+ "type": "string",
143
+ "filterRuleItemNameShapeDescription": "筛选项名称。",
144
+ "x-backend": "FilterGroupConfig.filterItemName"
145
+ },
146
+ "que": {
147
+ "type": "object",
148
+ "filterRuleItemQueShapeDescription": "绑定的字段引用(queId 为字段唯一键)。",
149
+ "x-backend": "FilterGroupConfig.que(Question)"
150
+ },
151
+ "judge": {
152
+ "type": "object",
153
+ "filterRuleItemJudgeShapeDescription": "默认筛选条件:judgeType(比较符)+judgeValues(比较值列表)。",
154
+ "x-backend": "FilterGroupConfig.dftJudgeType/dftJudgeValue"
155
+ }
156
+ }
157
+ },
158
+ "Section": {
159
+ "type": "object",
160
+ "additionalProperties": false,
161
+ "required": [
162
+ "source_type",
163
+ "config"
164
+ ],
165
+ "properties": {
166
+ "title": {
167
+ "type": "string",
168
+ "sectionTitleShapeDescription": "组件标题(可选)。存量筛选组件合法无标题——后端筛选组件无标题存储,提取产物不带 title,不要合成(如「组件 N」)。",
169
+ "x-backend": "组件标题(筛选组件无标题存储;其余组件见 DashChartInfo.title / gridConfig.gridTitle 等)"
170
+ },
171
+ "source_type": {
172
+ "const": "filter",
173
+ "sourceTypeConstDescription": "组件类型固定为 filter(筛选);后端 type 整数见 x-backend。",
174
+ "x-backend": "DashComponentInfo.type(filter)"
175
+ },
176
+ "role": {
177
+ "type": "string",
178
+ "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
179
+ },
180
+ "position": {
181
+ "$ref": "#/$defs/Position"
182
+ },
183
+ "style_config": {
184
+ "type": "object",
185
+ "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
186
+ "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
187
+ },
188
+ "config": {
189
+ "$ref": "#/$defs/FilterConfig",
190
+ "filterConfigPropDescription": "筛选配置(必填,rules 至少 1 组)。"
191
+ }
192
+ }
193
+ }
194
+ },
195
+ "$ref": "#/$defs/Section",
196
+ "x-qingflow-detail-query": {
197
+ "currentKind": "filter",
198
+ "tool": "portal_schema",
199
+ "cli": "qingflow builder portal schema --schema-kind filter",
200
+ "argument": "schema_kind",
201
+ "detailQueryDescription": "本文件是 筛选组件的自包含专项 Schema(内联全部引用定义,可独立交给 JSON Schema 校验器)。chart/view/grid/filter/text/link/carousel/task/favourite 各组件专项 Schema分别经 qingflow builder portal schema --schema-kind <类型> 获取。整门户声明用 qingflow builder portal schema --schema-kind summary|complete 获取;回读既有门户用 qingflow builder portal get --dash-key K --schema-kind complete。",
202
+ "readSources": {
203
+ "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
204
+ "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
205
+ }
206
+ },
207
+ "examples": [
208
+ {
209
+ "source_type": "filter",
210
+ "position": {
211
+ "pc": {
212
+ "x": 0,
213
+ "y": 0,
214
+ "cols": 24,
215
+ "rows": 3
216
+ }
217
+ },
218
+ "config": {
219
+ "graphs": [
220
+ {
221
+ "chart_key": "CHART_KEY_1001"
222
+ },
223
+ {
224
+ "chart_name": "故障类型分布"
225
+ }
226
+ ],
227
+ "rules": [
228
+ {
229
+ "filterGroupName": "区域",
230
+ "filterGroupConfig": [
231
+ {
232
+ "filterItemName": "城市",
233
+ "que": {
234
+ "queId": 123456
235
+ },
236
+ "judge": {
237
+ "judgeType": 3,
238
+ "judgeValues": [
239
+ "上海"
240
+ ]
241
+ }
242
+ }
243
+ ]
244
+ }
245
+ ]
246
+ }
247
+ }
248
+ ]
249
+ }