@qingflow-tech/qingflow-cli 1.1.2 → 1.1.34

package/skills/qingflow-cli/reference/examples/charts/charts_upsert_minimal.example.json

@@ -0,0 +1,13 @@
+[
+  {
+    "name": "数据总量",
+    "chart_type": "target",
+    "metric": "count(*)",
+    "visibility": {
+      "mode": "workspace",
+      "selectors": {},
+      "external_mode": "not",
+      "external_selectors": {}
+    }
+  }
+]

package/skills/qingflow-cli/reference/examples/layout/layout_sections_full.example.json

@@ -0,0 +1,22 @@
+{
+  "app_key": "APP_KEY",
+  "mode": "merge",
+  "publish": true,
+  "sections": [
+    {
+      "title": "基础信息",
+      "rows": [
+        ["工单编号", "工单名称", "工单状态"],
+        ["负责人", "负责部门", "计划完成日期"]
+      ]
+    },
+    {
+      "title": "业务信息",
+      "rows": [
+        ["计划数量", "预算金额", "是否加急"],
+        ["业务标签", "附件资料"],
+        ["处理说明"]
+      ]
+    }
+  ]
+}

package/skills/qingflow-cli/reference/examples/portal/portal_sections_all_types.example.json

@@ -0,0 +1,145 @@
+[
+  {
+    "title": "筛选条_实验项_勿默认交付",
+    "source_type": "filter",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 0,
+        "cols": 24,
+        "rows": 2
+      },
+      "mobile": {
+        "x": 0,
+        "y": 0,
+        "cols": 6,
+        "rows": 2
+      }
+    },
+    "config": {
+      "filterConfig": [],
+      "graphList": [
+        {
+          "graphType": "CHART",
+          "graphKey": "REPLACE_WITH_QINGBI_CHART_ID",
+          "graphName": "可选_图表显示名"
+        }
+      ]
+    }
+  },
+  {
+    "title": "九宫格",
+    "source_type": "grid",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 2,
+        "cols": 24,
+        "rows": 4
+      },
+      "mobile": {
+        "x": 0,
+        "y": 2,
+        "cols": 6,
+        "rows": 4
+      }
+    },
+    "config": {
+      "gridTitle": "九宫格",
+      "beingShowTitle": true,
+      "items": [
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "YOUR_APP_KEY",
+          "linkFormType": 1,
+          "title": "应用入口",
+          "customTitle": "应用入口",
+          "beingCustomTitle": false
+        }
+      ]
+    }
+  },
+  {
+    "title": "说明文字块",
+    "source_type": "text",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 6,
+        "cols": 24,
+        "rows": 2
+      },
+      "mobile": {
+        "x": 0,
+        "y": 6,
+        "cols": 6,
+        "rows": 2
+      }
+    },
+    "text": "本文件仅用于排障/实验：filter 在当前 CLI 直写中可能不落库；稳定自动化模板请使用 portal_sections_five_types.example.json。"
+  },
+  {
+    "title": "外部链接",
+    "source_type": "link",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 8,
+        "cols": 24,
+        "rows": 2
+      },
+      "mobile": {
+        "x": 0,
+        "y": 8,
+        "cols": 6,
+        "rows": 2
+      }
+    },
+    "url": "https://example.com"
+  },
+  {
+    "title": "应用视图块",
+    "source_type": "view",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 10,
+        "cols": 24,
+        "rows": 8
+      },
+      "mobile": {
+        "x": 0,
+        "y": 10,
+        "cols": 6,
+        "rows": 8
+      }
+    },
+    "view_ref": {
+      "app_key": "YOUR_APP_KEY",
+      "view_key": "YOUR_VIEW_KEY"
+    }
+  },
+  {
+    "title": "指标图",
+    "source_type": "chart",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 18,
+        "cols": 24,
+        "rows": 6
+      },
+      "mobile": {
+        "x": 0,
+        "y": 18,
+        "cols": 6,
+        "rows": 6
+      }
+    },
+    "chart": {
+      "app_key": "YOUR_APP_KEY",
+      "chart_id": "YOUR_CHART_ID"
+    }
+  }
+]

package/skills/qingflow-cli/reference/examples/portal/portal_sections_five_types.example.json

@@ -0,0 +1,126 @@
+[
+  {
+    "title": "门户说明",
+    "source_type": "text",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 0,
+        "cols": 24,
+        "rows": 2
+      },
+      "mobile": {
+        "x": 0,
+        "y": 0,
+        "cols": 6,
+        "rows": 2
+      }
+    },
+    "text": "建议将门户设计成工作台：上方放入口，中部放指标，下方放待处理和异常列表。此文件仅演示 grid / text / link / view / chart 的稳定写法。"
+  },
+  {
+    "title": "业务入口",
+    "source_type": "grid",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 2,
+        "cols": 24,
+        "rows": 4
+      },
+      "mobile": {
+        "x": 0,
+        "y": 2,
+        "cols": 6,
+        "rows": 4
+      }
+    },
+    "config": {
+      "gridTitle": "业务入口",
+      "beingShowTitle": true,
+      "items": [
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "APP_KEY_MAIN",
+          "linkFormType": 1,
+          "title": "核心业务",
+          "customTitle": "核心业务",
+          "beingCustomTitle": false
+        },
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "APP_KEY_TASK",
+          "linkFormType": 1,
+          "title": "待处理业务",
+          "customTitle": "待处理业务",
+          "beingCustomTitle": false
+        }
+      ]
+    }
+  },
+  {
+    "title": "核心指标",
+    "source_type": "chart",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 6,
+        "cols": 24,
+        "rows": 6
+      },
+      "mobile": {
+        "x": 0,
+        "y": 6,
+        "cols": 6,
+        "rows": 6
+      }
+    },
+    "chart": {
+      "app_key": "ead8ims5i401",
+      "chart_id": "mcp_fb104267c5c249ca"
+    }
+  },
+  {
+    "title": "待处理列表",
+    "source_type": "view",
+    "position": {
+      "pc": {
+        "x": 0,
+        "y": 12,
+        "cols": 12,
+        "rows": 8
+      },
+      "mobile": {
+        "x": 0,
+        "y": 12,
+        "cols": 6,
+        "rows": 8
+      }
+    },
+    "view_ref": {
+      "app_key": "ead8ims5i401",
+      "view_key": "ead8kbf1i402"
+    }
+  },
+  {
+    "title": "帮助文档",
+    "source_type": "link",
+    "position": {
+      "pc": {
+        "x": 12,
+        "y": 12,
+        "cols": 12,
+        "rows": 8
+      },
+      "mobile": {
+        "x": 0,
+        "y": 20,
+        "cols": 6,
+        "rows": 2
+      }
+    },
+    "url": "https://example.com"
+  }
+]

package/skills/qingflow-cli/reference/examples/portal/portal_sections_standard_workbench.example.json

@@ -0,0 +1,178 @@
+[
+  {
+    "title": "业务入口",
+    "source_type": "grid",
+    "position": {
+      "pc": {"x": 0, "y": 0, "cols": 24, "rows": 4},
+      "mobile": {"x": 0, "y": 0, "cols": 6, "rows": 4}
+    },
+    "config": {
+      "gridTitle": "业务入口",
+      "beingShowTitle": true,
+      "items": [
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "APP_KEY_DEVICE",
+          "linkFormType": 1,
+          "title": "设备台账",
+          "customTitle": "设备台账",
+          "beingCustomTitle": false
+        },
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "APP_KEY_REPAIR",
+          "linkFormType": 1,
+          "title": "故障报修",
+          "customTitle": "故障报修",
+          "beingCustomTitle": false
+        },
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "APP_KEY_MAINTENANCE",
+          "linkFormType": 1,
+          "title": "保养管理",
+          "customTitle": "保养管理",
+          "beingCustomTitle": false
+        }
+      ]
+    }
+  },
+  {
+    "title": "设备总数",
+    "source_type": "chart",
+    "role": "metric",
+    "position": {
+      "pc": {"x": 0, "y": 4, "cols": 6, "rows": 5},
+      "mobile": {"x": 0, "y": 4, "cols": 6, "rows": 5}
+    },
+    "chart": {"app_key": "APP_KEY_DEVICE", "name": "设备总数", "chart_type": "target", "metric": "count(*)"}
+  },
+  {
+    "title": "正常设备",
+    "source_type": "chart",
+    "role": "metric",
+    "position": {
+      "pc": {"x": 6, "y": 4, "cols": 6, "rows": 5},
+      "mobile": {"x": 0, "y": 9, "cols": 6, "rows": 5}
+    },
+    "chart": {
+      "app_key": "APP_KEY_DEVICE",
+      "name": "正常设备",
+      "chart_type": "target",
+      "metric": "count(*)",
+      "filters": [{"field_name": "使用状态", "operator": "eq", "value": "正常"}]
+    }
+  },
+  {
+    "title": "维修中设备",
+    "source_type": "chart",
+    "role": "metric",
+    "position": {
+      "pc": {"x": 12, "y": 4, "cols": 6, "rows": 5},
+      "mobile": {"x": 0, "y": 14, "cols": 6, "rows": 5}
+    },
+    "chart": {
+      "app_key": "APP_KEY_DEVICE",
+      "name": "维修中设备",
+      "chart_type": "target",
+      "metric": "count(*)",
+      "filters": [{"field_name": "使用状态", "operator": "eq", "value": "维修中"}]
+    }
+  },
+  {
+    "title": "本月报修",
+    "source_type": "chart",
+    "role": "metric",
+    "position": {
+      "pc": {"x": 18, "y": 4, "cols": 6, "rows": 5},
+      "mobile": {"x": 0, "y": 19, "cols": 6, "rows": 5}
+    },
+    "chart": {
+      "app_key": "APP_KEY_REPAIR",
+      "name": "本月报修",
+      "chart_type": "target",
+      "metric": "count(*)",
+      "filters": [
+        {"field_name": "报修日期", "operator": "gte", "value": "2026-07-01"},
+        {"field_name": "报修日期", "operator": "lte", "value": "2026-07-31"}
+      ]
+    }
+  },
+  {
+    "title": "设备状态分布",
+    "source_type": "chart",
+    "position": {
+      "pc": {"x": 0, "y": 9, "cols": 8, "rows": 7},
+      "mobile": {"x": 0, "y": 24, "cols": 6, "rows": 7}
+    },
+    "chart": {
+      "app_key": "APP_KEY_DEVICE",
+      "name": "设备状态分布",
+      "chart_type": "ring",
+      "metric": "count(*)",
+      "group_by": ["使用状态"],
+      "filters": [
+        {"field_name": "使用状态", "operator": "not_empty"}
+      ]
+    }
+  },
+  {
+    "title": "故障类型分布",
+    "source_type": "chart",
+    "position": {
+      "pc": {"x": 8, "y": 9, "cols": 8, "rows": 7},
+      "mobile": {"x": 0, "y": 31, "cols": 6, "rows": 7}
+    },
+    "chart": {
+      "app_key": "APP_KEY_REPAIR",
+      "name": "故障类型分布",
+      "chart_type": "columnar",
+      "metric": "count(*)",
+      "group_by": ["故障类型"],
+      "filters": [
+        {"field_name": "故障类型", "operator": "in", "values": ["机械故障", "电气故障", "软件故障"]},
+        {"field_name": "处理状态", "operator": "neq", "value": "已作废"}
+      ]
+    }
+  },
+  {
+    "title": "维修完成趋势",
+    "source_type": "chart",
+    "position": {
+      "pc": {"x": 16, "y": 9, "cols": 8, "rows": 7},
+      "mobile": {"x": 0, "y": 38, "cols": 6, "rows": 7}
+    },
+    "chart": {
+      "app_key": "APP_KEY_REPAIR",
+      "name": "维修完成趋势",
+      "chart_type": "columnar",
+      "metric": "count(*)",
+      "group_by": ["完成日期"],
+      "filters": [
+        {"field_name": "维修说明", "operator": "contains", "value": "完成"},
+        {"field_name": "完成日期", "operator": "not_empty"}
+      ]
+    }
+  },
+  {
+    "title": "异常设备",
+    "source_type": "view",
+    "position": {
+      "pc": {"x": 0, "y": 16, "cols": 12, "rows": 11},
+      "mobile": {"x": 0, "y": 45, "cols": 6, "rows": 11}
+    },
+    "view_ref": {"app_key": "APP_KEY_DEVICE", "view_key": "VIEW_KEY_ABNORMAL_DEVICES"}
+  },
+  {
+    "title": "待处理工单",
+    "source_type": "view",
+    "position": {
+      "pc": {"x": 12, "y": 16, "cols": 12, "rows": 11},
+      "mobile": {"x": 0, "y": 56, "cols": 6, "rows": 11}
+    },
+    "view_ref": {"app_key": "APP_KEY_REPAIR", "view_key": "VIEW_KEY_PENDING_WORK_ORDERS"}
+  }
+]

package/skills/qingflow-cli/reference/examples/record/record_insert_all_field_types.example.json

@@ -0,0 +1,35 @@
+[
+  {
+    "fields": {
+      "文本字段": "样例文本",
+      "长文本字段": "多行说明文本",
+      "数字字段": 12,
+      "金额字段": 3800.5,
+      "日期字段": "2026-07-15",
+      "日期时间字段": "2026-07-15 09:30:00",
+      "单选字段": "启用",
+      "多选字段": ["重点", "续约"],
+      "成员字段": "张三",
+      "部门字段": "销售部",
+      "关联字段": "540000000000000001",
+      "子表字段": [
+        {
+          "子表文本": "第一行",
+          "子表数量": 2,
+          "子表单选": "正常"
+        },
+        {
+          "子表文本": "第二行",
+          "子表数量": 1,
+          "子表单选": "异常"
+        }
+      ],
+      "附件字段": [
+        {
+          "value": "UPLOADED_FILE_VALUE",
+          "name": "巡检照片.jpg"
+        }
+      ]
+    }
+  }
+]

package/skills/qingflow-cli/reference/examples/schema/_batch_schema_complex.json

@@ -0,0 +1,18 @@
+[
+  {
+    "name": "BAT_sub",
+    "type": "subtable",
+    "subfields": [
+      {"name": "BAT_sub_a", "type": "text"},
+      {"name": "BAT_sub_b", "type": "number"}
+    ]
+  },
+  {
+    "name": "BAT_rel",
+    "type": "relation",
+    "target_app_key": "ead8ims5i401",
+    "relation_mode": "single",
+    "display_field": {"name": "单行文字"},
+    "visible_fields": [{"name": "多行文字"}]
+  }
+]

package/skills/qingflow-cli/reference/examples/schema/_batch_schema_scalar.json

@@ -0,0 +1,17 @@
+[
+  {"name": "BAT_text", "type": "text", "description": "批测"},
+  {"name": "BAT_long_text", "type": "long_text"},
+  {"name": "BAT_number", "type": "number"},
+  {"name": "BAT_amount", "type": "amount"},
+  {"name": "BAT_date", "type": "date"},
+  {"name": "BAT_datetime", "type": "datetime"},
+  {"name": "BAT_member", "type": "member"},
+  {"name": "BAT_phone", "type": "phone"},
+  {"name": "BAT_email", "type": "email"},
+  {"name": "BAT_address", "type": "address"},
+  {"name": "BAT_attachment", "type": "attachment"},
+  {"name": "BAT_boolean", "type": "boolean"},
+  {"name": "BAT_single_select", "type": "single_select", "options": ["A", "B"], "required": false},
+  {"name": "BAT_multi_select", "type": "multi_select", "options": ["X", "Y"], "required": false},
+  {"name": "BAT_dept", "type": "department", "department_scope": {"mode": "all"}}
+]

package/skills/qingflow-cli/reference/examples/schema/schema_add_fields_minimal.example.json

@@ -0,0 +1,7 @@
+[
+  {
+    "name": "示例搭建_CLI单行",
+    "type": "text",
+    "as_data_title": true
+  }
+]

package/skills/qingflow-cli/reference/examples/schema/schema_apply_add_fields_all_types.json

@@ -0,0 +1,78 @@
+[
+  {
+    "name": "QFCLI_AT_text",
+    "type": "text",
+    "as_data_title": true,
+    "description": "【本文件用法】字段能力覆盖探针，不是正式新建应用主模板。正式新建应用优先使用 form；完整系统优先使用 schema_multi_app_form_relation_layout.example.json。此文件用于测试 19 种搭建 type（另含远程查询/代码块所需辅助 text），关联字段 target_app_key 默认为本仓库实测模板应用 ead8ims5i401；其它租户请改成你方可读的目标应用 app_key。"
+  },
+  {"name": "QFCLI_AT_long_text", "type": "long_text"},
+  {"name": "QFCLI_AT_number", "type": "number"},
+  {"name": "QFCLI_AT_amount", "type": "amount"},
+  {"name": "QFCLI_AT_date", "type": "date"},
+  {"name": "QFCLI_AT_datetime", "type": "datetime"},
+  {"name": "QFCLI_AT_member", "type": "member"},
+  {"name": "QFCLI_AT_department", "type": "department", "department_scope": {"mode": "all"}},
+  {"name": "QFCLI_AT_single_select", "type": "single_select", "options": ["A", "B"]},
+  {"name": "QFCLI_AT_multi_select", "type": "multi_select", "options": ["X", "Y"]},
+  {"name": "QFCLI_AT_phone", "type": "phone"},
+  {"name": "QFCLI_AT_email", "type": "email"},
+  {"name": "QFCLI_AT_address", "type": "address"},
+  {"name": "QFCLI_AT_attachment", "type": "attachment", "as_data_cover": true},
+  {"name": "QFCLI_AT_boolean", "type": "boolean"},
+  {"name": "QFCLI_AT_ql_kw", "type": "text"},
+  {"name": "QFCLI_AT_ql_v1", "type": "text"},
+  {"name": "QFCLI_AT_ql_v2", "type": "text"},
+  {"name": "QFCLI_AT_cb_in", "type": "text"},
+  {"name": "QFCLI_AT_cb_out", "type": "text"},
+  {
+    "name": "QFCLI_AT_sub",
+    "type": "subtable",
+    "subfields": [
+      {"name": "QFCLI_AT_sub_c1", "type": "text"},
+      {"name": "QFCLI_AT_sub_c2", "type": "number"}
+    ]
+  },
+  {
+    "name": "QFCLI_AT_q_linker",
+    "type": "q_linker",
+    "q_linker_binding": {
+      "inputs": [{"field": {"name": "QFCLI_AT_ql_kw"}, "key": "k", "source": "query_param"}],
+      "request": {
+        "url": "https://httpbin.org/get",
+        "method": "GET",
+        "headers": [],
+        "query_params": [],
+        "body_type": 1,
+        "url_encoded_value": [],
+        "result_type": 1,
+        "auto_trigger": false,
+        "custom_button_text_enabled": true,
+        "custom_button_text": "查"
+      },
+      "outputs": [
+        {"alias": "a", "path": "$.headers.Host", "target_field": {"name": "QFCLI_AT_ql_v1"}},
+        {"alias": "b", "path": "$.url", "target_field": {"name": "QFCLI_AT_ql_v2"}}
+      ]
+    }
+  },
+  {
+    "name": "QFCLI_AT_code_block",
+    "type": "code_block",
+    "code_block_binding": {
+      "inputs": [{"field": {"name": "QFCLI_AT_cb_in"}, "var": "x"}],
+      "code": "qf_output = {}; qf_output.r = x ? '1' : '0';",
+      "auto_trigger": false,
+      "custom_button_text_enabled": true,
+      "custom_button_text": "运行",
+      "outputs": [{"alias": "r", "path": "$.r", "target_field": {"name": "QFCLI_AT_cb_out"}}]
+    }
+  },
+  {
+    "name": "QFCLI_AT_relation",
+    "type": "relation",
+    "target_app_key": "ead8ims5i401",
+    "relation_mode": "single",
+    "display_field": {"name": "单行文字"},
+    "visible_fields": [{"name": "多行文字"}]
+  }
+]