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

package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/text.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/text.json",
+  "title": "Qingflow Builder Portals Section · text (v1alpha1)",
+  "portalTextSectionDescription": "门户文本组件(text)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind text(MCP: portal_schema(schema_kind=\"text\"))。本 Schema 校验 sections[] 中单个 text 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=5。整门户声明走 summary/complete 档。",
+  "$defs": {
+    "Position": {
+      "type": "object",
+      "additionalProperties": false,
+      "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。",
+      "properties": {
+        "pc": {
+          "$ref": "#/$defs/PositionDetail"
+        },
+        "mobile": {
+          "$ref": "#/$defs/PositionDetail"
+        }
+      }
+    },
+    "PositionDetail": {
+      "type": "object",
+      "additionalProperties": false,
+      "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
+      "properties": {
+        "x": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "y": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "cols": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        },
+        "rows": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        }
+      },
+      "x-backend": "DashPosition.pc / DashPosition.mobile"
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "source_type",
+        "text"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
+          "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
+        },
+        "source_type": {
+          "const": "text",
+          "sourceTypeConstDescription": "组件类型固定为 text(文本);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(text)"
+        },
+        "role": {
+          "type": "string",
+          "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
+        },
+        "position": {
+          "$ref": "#/$defs/Position"
+        },
+        "style_config": {
+          "type": "object",
+          "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
+          "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
+        },
+        "text": {
+          "type": "string",
+          "textPropShapeDescription": "文本内容(支持富文本 HTML 片段,dataset 校准后开放结构化键)。",
+          "x-backend": "ComponentTextConfig.content"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "text",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind text",
+    "argument": "schema_kind",
+    "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。",
+    "readSources": {
+      "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
+      "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
+    }
+  },
+  "examples": [
+    {
+      "title": "使用说明",
+      "source_type": "text",
+      "position": {
+        "pc": {
+          "x": 0,
+          "y": 0,
+          "cols": 24,
+          "rows": 3
+        }
+      },
+      "text": "<p>本门户展示设备运维核心指标;数据每日 0 点刷新。</p>"
+    }
+  ]
+}

package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/view.json

@@ -0,0 +1,196 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/view.json",
+  "title": "Qingflow Builder Portals Section · view (v1alpha1)",
+  "portalViewSectionDescription": "门户数据视图组件(view)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind view(MCP: portal_schema(schema_kind=\"view\"))。本 Schema 校验 sections[] 中单个 view 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=10。整门户声明走 summary/complete 档。",
+  "$defs": {
+    "Position": {
+      "type": "object",
+      "additionalProperties": false,
+      "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。",
+      "properties": {
+        "pc": {
+          "$ref": "#/$defs/PositionDetail"
+        },
+        "mobile": {
+          "$ref": "#/$defs/PositionDetail"
+        }
+      }
+    },
+    "PositionDetail": {
+      "type": "object",
+      "additionalProperties": false,
+      "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
+      "properties": {
+        "x": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "y": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "cols": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        },
+        "rows": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        }
+      },
+      "x-backend": "DashPosition.pc / DashPosition.mobile"
+    },
+    "ViewRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "app_key"
+      ],
+      "viewRefShapeDescription": "业务视图引用。view_key 或 view_name 至少一个;view_key 为后端唯一键,优先使用;不要用「全部数据/我的数据」系统视图。",
+      "anyOf": [
+        {
+          "required": [
+            "view_key"
+          ]
+        },
+        {
+          "required": [
+            "view_name"
+          ]
+        }
+      ],
+      "properties": {
+        "app_key": {
+          "type": "string",
+          "viewRefAppKeyShapeDescription": "视图所属应用 key。别名 appKey。",
+          "x-backend": "ComponentViewConfig.appKey"
+        },
+        "view_key": {
+          "type": "string",
+          "viewRefKeyShapeDescription": "视图唯一键(viewgraphKey)。获取:qingflow builder views get --app-key APP。别名 viewKey。",
+          "x-backend": "ComponentViewConfig.viewgraphKey"
+        },
+        "view_name": {
+          "type": "string",
+          "viewRefNameShapeDescription": "视图名称(按名解析,重名有歧义风险)。别名 viewName。"
+        }
+      }
+    },
+    "ViewDisplayConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "viewDisplayShapeDescription": "视图组件展示配置。",
+      "properties": {
+        "show_title": {
+          "type": "boolean",
+          "default": true,
+          "viewShowTitleShapeDescription": "是否显示组件标题。别名 beingShowTitle。",
+          "x-backend": "ComponentViewConfig.beingShowTitle"
+        },
+        "component_title": {
+          "type": "string",
+          "viewComponentTitleShapeDescription": "组件内标题(缺省用 section.title)。",
+          "x-backend": "ComponentViewConfig.componentTitle"
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_type",
+        "view_ref"
+      ],
+      "properties": {
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "sectionTitleDescription": "组件显示标题。空标题(null)是合法存量形态(显示标题开但标题空,读链渲染时回退图表名/视图名);创建语义缺省建议显式命名。",
+          "x-backend": "组件标题(DashChartInfo.title / DashChartInfo.chartComponentTitle / gridConfig.gridTitle / componentTaskTitle 等;null 落库 NULL)"
+        },
+        "source_type": {
+          "const": "view",
+          "sourceTypeConstDescription": "组件类型固定为 view(数据视图);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(view)"
+        },
+        "role": {
+          "type": "string",
+          "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
+        },
+        "position": {
+          "$ref": "#/$defs/Position"
+        },
+        "style_config": {
+          "type": "object",
+          "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
+          "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
+        },
+        "view_ref": {
+          "$ref": "#/$defs/ViewRef",
+          "viewRefPropDescription": "业务视图引用(必填)。"
+        },
+        "view_display": {
+          "$ref": "#/$defs/ViewDisplayConfig",
+          "viewDisplayPropDescription": "视图组件展示配置(可选)。"
+        },
+        "show_title": {
+          "type": "boolean",
+          "showTitleShapeDescription": "显示标题开关(draft_dash_chart.being_show_title 落库列)。提取侧读面必有值;存量 false 必须保真(渲染语义依赖)。声明缺省时编译回落产品默认 true。",
+          "x-backend": "DashChart.beingShowTitle(chart/view 组件)"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "view",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind view",
+    "argument": "schema_kind",
+    "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。",
+    "readSources": {
+      "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
+      "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
+    }
+  },
+  "examples": [
+    {
+      "title": "异常设备",
+      "source_type": "view",
+      "position": {
+        "pc": {
+          "x": 0,
+          "y": 16,
+          "cols": 24,
+          "rows": 11
+        }
+      },
+      "view_ref": {
+        "app_key": "APP_KEY_DEVICE",
+        "view_key": "VIEW_KEY_ABNORMAL"
+      },
+      "view_display": {
+        "show_title": true
+      }
+    }
+  ]
+}