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

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

@@ -0,0 +1,265 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/grid.json",
+  "title": "Qingflow Builder Portals Section · grid (v1alpha1)",
+  "portalGridSectionDescription": "门户业务入口宫格组件(grid)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind grid(MCP: portal_schema(schema_kind=\"grid\"))。本 Schema 校验 sections[] 中单个 grid 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=2。整门户声明走 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"
+    },
+    "GridConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "items"
+      ],
+      "gridConfigShapeDescription": "业务入口宫格配置;items 必须含真实条目,不接受空宫格。声明键与后端 ComponentGridInfo 键一致(camelCase):gridTitle/beingShowTitle/items。",
+      "properties": {
+        "gridTitle": {
+          "type": "string",
+          "gridTitleShapeDescription": "宫格标题(缺省用 section.title)。",
+          "x-backend": "ComponentGridInfo.gridTitle"
+        },
+        "beingShowTitle": {
+          "type": "boolean",
+          "default": true,
+          "gridShowTitleShapeDescription": "是否显示宫格标题。",
+          "x-backend": "ComponentGridInfo.beingShowTitle"
+        },
+        "items": {
+          "type": "array",
+          "gridItemsShapeDescription": "入口条目列表(ordinal 缺省按数组顺序)。",
+          "items": {
+            "$ref": "#/$defs/GridItem"
+          }
+        }
+      },
+      "x-backend": "ComponentGridInfo"
+    },
+    "GridItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "jumpMode",
+        "title"
+      ],
+      "gridItemShapeDescription": "单个入口条目。grid 的 config 声明键与后端 ComponentGridItemInfo 键一致(camelCase);Python 端 section.config 直接透传。",
+      "properties": {
+        "type": {
+          "type": "integer",
+          "gridItemTypeDescription": "入口类型:1=应用,2=门户,3=应用包,4=外链。",
+          "x-backend": "ComponentGridItemInfo.type"
+        },
+        "jumpMode": {
+          "type": "integer",
+          "gridJumpModeDescription": "跳转方式:1=应用内页,2=新页面。",
+          "x-backend": "ComponentGridItemInfo.jumpMode"
+        },
+        "linkAppKey": {
+          "type": "string",
+          "gridItemAppKeyDescription": "目标应用 key(type=1 时使用)。",
+          "x-backend": "ComponentGridItemInfo.linkAppKey"
+        },
+        "linkFormType": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "gridItemFormTypeDescription": "目标应用页面形态(type=1 时使用)。",
+          "x-backend": "ComponentGridItemInfo.linkFormType"
+        },
+        "linkDashKey": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "gridItemDashKeyDescription": "目标门户 key(type=2 时使用)。",
+          "x-backend": "ComponentGridItemInfo.linkDashKey"
+        },
+        "linkTagId": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "gridItemTagIdDescription": "目标应用包 tagId(type=3 时使用)。",
+          "x-backend": "ComponentGridItemInfo.linkTagId"
+        },
+        "linkUrl": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "maxLength": 500,
+          "gridItemUrlDescription": "外链地址(type=4 时使用)。",
+          "x-backend": "ComponentGridItemInfo.linkUrl"
+        },
+        "title": {
+          "type": "string",
+          "gridItemTitleDescription": "入口标题。",
+          "x-backend": "ComponentGridItemInfo.title"
+        },
+        "customTitle": {
+          "type": "string",
+          "gridItemCustomTitleDescription": "自定义标题(beingCustomTitle=true 时生效)。",
+          "x-backend": "ComponentGridItemInfo.customTitle"
+        },
+        "beingCustomTitle": {
+          "type": "boolean",
+          "default": false,
+          "gridItemCustomTitleSwitchDescription": "是否启用自定义标题。",
+          "x-backend": "ComponentGridItemInfo.beingCustomTitle"
+        },
+        "iconUrl": {
+          "type": "string",
+          "gridItemIconDescription": "入口图标 URL(可选,缺省按目标解析)。",
+          "x-backend": "ComponentGridItemInfo.iconUrl"
+        },
+        "ordinal": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "gridItemOrdinalDescription": "排序(缺省按数组顺序)。",
+          "x-backend": "ComponentGridItemInfo.ordinal"
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_type",
+        "config"
+      ],
+      "properties": {
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "sectionTitleDescription": "组件显示标题。空标题(null)是合法存量形态(显示标题开但标题空,读链渲染时回退图表名/视图名);创建语义缺省建议显式命名。",
+          "x-backend": "组件标题(DashChartInfo.title / DashChartInfo.chartComponentTitle / gridConfig.gridTitle / componentTaskTitle 等;null 落库 NULL)"
+        },
+        "source_type": {
+          "const": "grid",
+          "sourceTypeConstDescription": "组件类型固定为 grid(业务入口宫格);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(grid)"
+        },
+        "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)"
+        },
+        "config": {
+          "$ref": "#/$defs/GridConfig",
+          "gridConfigPropDescription": "宫格配置(必填,items 非空)。"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "grid",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind grid",
+    "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": "grid",
+      "position": {
+        "pc": {
+          "x": 0,
+          "y": 0,
+          "cols": 24,
+          "rows": 4
+        }
+      },
+      "config": {
+        "gridTitle": "业务入口",
+        "beingShowTitle": true,
+        "items": [
+          {
+            "type": 1,
+            "title": "设备台账",
+            "jumpMode": 1,
+            "linkAppKey": "APP_KEY_DEVICE",
+            "linkFormType": 1
+          },
+          {
+            "type": 1,
+            "title": "故障报修",
+            "jumpMode": 1,
+            "linkAppKey": "APP_KEY_REPAIR",
+            "linkFormType": 1,
+            "iconUrl": "https://cdn.example.com/repair.png"
+          }
+        ]
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/link.json",
+  "title": "Qingflow Builder Portals Section · link (v1alpha1)",
+  "portalLinkSectionDescription": "门户链接组件(link)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind link(MCP: portal_schema(schema_kind=\"link\"))。本 Schema 校验 sections[] 中单个 link 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=4。整门户声明走 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",
+        "url"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
+          "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
+        },
+        "source_type": {
+          "const": "link",
+          "sourceTypeConstDescription": "组件类型固定为 link(链接);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(link)"
+        },
+        "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)"
+        },
+        "url": {
+          "type": "string",
+          "maxLength": 500,
+          "urlPropShapeDescription": "链接地址(上限 500)。",
+          "x-backend": "ComponentLinkConfig.linkUrl"
+        },
+        "login_auth": {
+          "type": "boolean",
+          "default": false,
+          "loginAuthPropShapeDescription": "链接是否需要登录鉴权。别名 beingLoginAuth。",
+          "x-backend": "ComponentLinkConfig.beingLoginAuth"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "link",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind link",
+    "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": "link",
+      "position": {
+        "pc": {
+          "x": 0,
+          "y": 30,
+          "cols": 24,
+          "rows": 4
+        }
+      },
+      "url": "https://help.example.com",
+      "login_auth": false
+    }
+  ]
+}

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

@@ -0,0 +1,199 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/task.json",
+  "title": "Qingflow Builder Portals Section · task (v1alpha1)",
+  "portalTaskSectionDescription": "门户待办组件(task)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind task(MCP: portal_schema(schema_kind=\"task\"))。本 Schema 校验 sections[] 中单个 task 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=8。整门户声明走 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"
+    },
+    "TaskConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "taskConfigShapeDescription": "待办组件配置。",
+      "properties": {
+        "show_title": {
+          "type": "boolean",
+          "default": true,
+          "taskShowTitleShapeDescription": "是否显示待办标题。别名 beingShowTitle。",
+          "x-backend": "ComponentTaskConfig.beingShowTitle"
+        },
+        "hint": {
+          "type": "string",
+          "taskHintShapeDescription": "待办提示文案。别名 componentTaskHint。",
+          "x-backend": "ComponentTaskConfig.componentTaskHint"
+        },
+        "show_hint": {
+          "type": "boolean",
+          "taskShowHintShapeDescription": "是否显示提示。别名 beingShowHint。",
+          "x-backend": "ComponentTaskConfig.beingShowHint"
+        },
+        "enabled": {
+          "type": "boolean",
+          "taskEnabledShapeDescription": "待办组件是否启用。别名 beingUsing。",
+          "x-backend": "ComponentTaskConfig.beingUsing"
+        },
+        "tasks": {
+          "type": "array",
+          "taskItemsShapeDescription": "待办任务条目(ordinal 缺省按数组顺序)。省略或空列表时编译器按前端新建缺省补 4 类标准任务(待办/已超时/即将超时/催办,全部勾选)——后端写链要求 dashTaskConfigList 非空键。",
+          "items": {
+            "$ref": "#/$defs/TaskItem"
+          },
+          "x-backend": "ComponentTaskConfig.dashTaskConfigList(DashTaskConfig)"
+        }
+      }
+    },
+    "TaskItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title"
+      ],
+      "taskItemShapeDescription": "单个待办任务条目。",
+      "properties": {
+        "title": {
+          "type": "string",
+          "taskItemTitleShapeDescription": "任务标题。",
+          "x-backend": "DashTaskConfig.title"
+        },
+        "task_type": {
+          "type": "integer",
+          "taskItemTypeShapeDescription": "任务类型。别名 type。",
+          "x-backend": "DashTaskConfig.type"
+        },
+        "ordinal": {
+          "type": "integer",
+          "taskItemOrdinalShapeDescription": "排序序号。",
+          "x-backend": "DashTaskConfig.ordinal"
+        },
+        "checked": {
+          "type": "boolean",
+          "default": false,
+          "taskItemCheckedShapeDescription": "是否默认勾选。别名 beingCheck。",
+          "x-backend": "DashTaskConfig.beingCheck"
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "source_type",
+        "task"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
+          "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
+        },
+        "source_type": {
+          "const": "task",
+          "sourceTypeConstDescription": "组件类型固定为 task(待办);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(task)"
+        },
+        "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)"
+        },
+        "task": {
+          "$ref": "#/$defs/TaskConfig",
+          "taskPropDescription": "待办配置(必填)。"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "task",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind task",
+    "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": "task",
+      "position": {
+        "pc": {
+          "x": 0,
+          "y": 11,
+          "cols": 12,
+          "rows": 8
+        }
+      },
+      "task": {
+        "show_title": true,
+        "enabled": true,
+        "tasks": [
+          {
+            "title": "待处理工单",
+            "task_type": 1,
+            "checked": true
+          }
+        ]
+      }
+    }
+  ]
+}