@qingflow-tech/qingflow-cli 1.1.2 → 1.1.34

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

@@ -0,0 +1,166 @@
+{
+  "package_id": 123456,
+  "apps": [
+    {
+      "client_key": "customer",
+      "app_name": "客户",
+      "icon": "view-grid",
+      "color": "blue",
+      "form": [
+        {
+          "section": "客户基础信息",
+          "rows": [
+            [
+              {
+                "name": "客户编号",
+                "type": "text",
+                "data_title": true,
+                "required": true
+              },
+              {
+                "name": "客户名称",
+                "type": "text",
+                "required": true
+              },
+              {
+                "name": "客户状态",
+                "type": "select",
+                "options": ["潜在", "合作中", "暂停", "终止"]
+              }
+            ],
+            [
+              {
+                "name": "客户负责人",
+                "type": "member"
+              },
+              {
+                "name": "所属部门",
+                "type": "department"
+              }
+            ]
+          ]
+        }
+      ]
+    },
+    {
+      "client_key": "order",
+      "app_name": "销售订单",
+      "icon": "inbox",
+      "color": "emerald",
+      "form": [
+        {
+          "section": "订单基础信息",
+          "rows": [
+            [
+              {
+                "name": "订单编号",
+                "type": "text",
+                "data_title": true,
+                "required": true
+              },
+              {
+                "name": "关联客户",
+                "type": "relation",
+                "target_app_ref": "customer",
+                "relation_mode": "single",
+                "display_field": {
+                  "name": "客户编号"
+                },
+                "visible_fields": [
+                  {
+                    "name": "客户名称"
+                  },
+                  {
+                    "name": "客户状态"
+                  }
+                ]
+              },
+              {
+                "name": "订单状态",
+                "type": "select",
+                "options": ["草稿", "执行中", "已完成", "已取消"]
+              }
+            ],
+            [
+              {
+                "name": "订单金额",
+                "type": "amount"
+              },
+              {
+                "name": "签约日期",
+                "type": "date"
+              }
+            ]
+          ]
+        }
+      ]
+    },
+    {
+      "client_key": "payment",
+      "app_name": "回款记录",
+      "icon": "share",
+      "color": "azure",
+      "form": [
+        {
+          "section": "回款基础信息",
+          "rows": [
+            [
+              {
+                "name": "回款编号",
+                "type": "text",
+                "data_title": true,
+                "required": true
+              },
+              {
+                "name": "关联订单",
+                "type": "relation",
+                "target_app_ref": "order",
+                "relation_mode": "single",
+                "display_field": {
+                  "name": "订单编号"
+                },
+                "visible_fields": [
+                  {
+                    "name": "订单金额"
+                  },
+                  {
+                    "name": "订单状态"
+                  }
+                ]
+              },
+              {
+                "name": "关联客户",
+                "type": "relation",
+                "target_app_ref": "customer",
+                "relation_mode": "single",
+                "display_field": {
+                  "name": "客户编号"
+                },
+                "visible_fields": [
+                  {
+                    "name": "客户名称"
+                  }
+                ]
+              }
+            ],
+            [
+              {
+                "name": "回款金额",
+                "type": "amount"
+              },
+              {
+                "name": "回款日期",
+                "type": "date"
+              },
+              {
+                "name": "回款状态",
+                "type": "select",
+                "options": ["待确认", "已确认", "异常"]
+              }
+            ]
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,95 @@
+[
+  {
+    "section": "基础信息",
+    "rows": [
+      [
+        {
+          "name": "工单编号",
+          "type": "text",
+          "data_title": true,
+          "required": true,
+          "description": "唯一业务编号"
+        },
+        {
+          "name": "工单名称",
+          "type": "text",
+          "required": true
+        },
+        {
+          "name": "工单状态",
+          "type": "select",
+          "required": true,
+          "options": ["待处理", "处理中", "已完成", "已关闭"]
+        }
+      ],
+      [
+        {
+          "name": "负责人",
+          "type": "member"
+        },
+        {
+          "name": "负责部门",
+          "type": "department",
+          "department_scope": {"mode": "all"}
+        },
+        {
+          "name": "计划完成日期",
+          "type": "date"
+        }
+      ]
+    ]
+  },
+  {
+    "section": "业务信息",
+    "rows": [
+      [
+        {
+          "name": "计划数量",
+          "type": "number"
+        },
+        {
+          "name": "预算金额",
+          "type": "amount"
+        },
+        {
+          "name": "是否加急",
+          "type": "boolean"
+        }
+      ],
+      [
+        {
+          "name": "业务标签",
+          "type": "multi_select",
+          "options": ["重点", "风险", "跨部门", "需复核"]
+        },
+        {
+          "name": "附件资料",
+          "type": "attachment",
+          "data_cover": true
+        }
+      ],
+      [
+        {
+          "name": "处理说明",
+          "type": "multiline"
+        }
+      ]
+    ]
+  },
+  {
+    "section": "明细信息",
+    "rows": [
+      [
+        {
+          "name": "处理明细",
+          "type": "subtable",
+          "subfields": [
+            {"name": "明细事项", "type": "text"},
+            {"name": "明细数量", "type": "number"},
+            {"name": "明细备注", "type": "multiline"}
+          ]
+        }
+      ]
+    ]
+  }
+]

package/skills/qingflow-cli/reference/examples/views/views_batch_full.example.json

@@ -0,0 +1,159 @@
+{
+  "views": [
+    {
+      "operation": "upsert",
+      "app_key": "WORK_ORDER_APP_KEY",
+      "name": "生产工单执行视图",
+      "type": "table",
+      "columns": ["工单编号", "产品", "工单状态", "负责人", "计划完成日期"],
+      "filters": [
+        {"field_name": "工单状态", "operator": "in", "values": ["待排产", "生产中"]},
+        {"field_name": "产品", "operator": "contains", "value": "标准"},
+        {"field_name": "计划完成日期", "operator": "lte", "value": "2026-07-31"}
+      ],
+      "query_conditions": {
+        "enabled": true,
+        "exact": false,
+        "hide_before_query": false,
+        "rows": [["工单编号", "工单状态"], ["负责人", "计划完成日期"]]
+      },
+      "visibility": {
+        "mode": "workspace",
+        "selectors": {},
+        "external_mode": "not",
+        "external_selectors": {}
+      },
+      "action_buttons": [
+        {
+          "client_key": "create_quality_from_list",
+          "text": "行内创建质检",
+          "action": "add_data",
+          "target_app_key": "QUALITY_APP_KEY",
+          "field_mappings": [
+            {"source_field": "数据ID", "target_field": "关联工单"}
+          ],
+          "default_values": {"处理状态": "待处理"},
+          "placement": "list",
+          "primary": true,
+          "style_preset": "primary_blue",
+          "visible_when": [
+            {"field_name": "工单状态", "operator": "eq", "value": "生产中"}
+          ]
+        },
+        {
+          "client_key": "create_quality_from_detail",
+          "text": "详情创建质检",
+          "action": "add_data",
+          "target_app_key": "QUALITY_APP_KEY",
+          "field_mappings": [
+            {"source_field": "数据ID", "target_field": "关联工单"}
+          ],
+          "default_values": {"处理状态": "待处理"},
+          "placement": "detail",
+          "style_preset": "neutral_outline"
+        },
+        {
+          "client_key": "open_work_order_sop",
+          "text": "打开SOP",
+          "action": "link",
+          "url": "https://example.com/sop/work-order",
+          "placement": "header",
+          "style_preset": "text_blue"
+        }
+      ]
+    },
+    {
+      "operation": "upsert",
+      "app_key": "WORK_ORDER_APP_KEY",
+      "name": "工单状态看板",
+      "type": "board",
+      "columns": ["工单编号", "产品", "负责人", "计划完成日期"],
+      "group_by": "工单状态",
+      "filters": [
+        {"field_name": "工单状态", "operator": "not_empty"},
+        {"field_name": "关闭日期", "operator": "is_empty"}
+      ],
+      "query_conditions": {
+        "enabled": true,
+        "rows": [["工单编号", "负责人"], ["计划完成日期"]]
+      },
+      "action_buttons": [
+        {
+          "text": "看板行内创建质检",
+          "action": "add_data",
+          "target_app_key": "QUALITY_APP_KEY",
+          "field_mappings": [
+            {"source_field": "数据ID", "target_field": "关联工单"}
+          ],
+          "placement": "list",
+          "visible_when": [
+            {"field_name": "工单状态", "operator": "eq", "value": "已完工"}
+          ]
+        },
+        {
+          "text": "看板详情创建质检",
+          "action": "add_data",
+          "target_app_key": "QUALITY_APP_KEY",
+          "field_mappings": [
+            {"source_field": "数据ID", "target_field": "关联工单"}
+          ],
+          "placement": "detail"
+        }
+      ]
+    },
+    {
+      "operation": "upsert",
+      "app_key": "WORK_ORDER_APP_KEY",
+      "name": "工单计划甘特图",
+      "type": "gantt",
+      "columns": ["工单编号", "产品", "工单状态", "计划开始日期", "计划完成日期"],
+      "start_field": "计划开始日期",
+      "end_field": "计划完成日期",
+      "title_field": "工单编号",
+      "filters": [
+        {"field_name": "计划开始日期", "operator": "gte", "value": "2026-07-01"}
+      ],
+      "query_conditions": {
+        "enabled": true,
+        "rows": [["工单编号", "工单状态"], ["计划开始日期", "计划完成日期"]]
+      },
+      "action_buttons": [
+        {
+          "text": "详情查看排产说明",
+          "action": "link",
+          "url": "https://example.com/sop/schedule",
+          "placement": "detail"
+        }
+      ]
+    },
+    {
+      "operation": "patch",
+      "app_key": "WORK_ORDER_APP_KEY",
+      "view_key": "RAW_VIEW_KEY_TO_PATCH",
+      "set": {
+        "columns": ["工单编号", "工单状态", "负责人"],
+        "filters": [
+          {"field_name": "工单状态", "operator": "neq", "value": "已关闭"}
+        ],
+        "query_conditions": {
+          "enabled": true,
+          "rows": [["工单编号", "工单状态"], ["负责人"]]
+        },
+        "action_buttons": [
+          {
+            "text": "补充详情按钮",
+            "action": "link",
+            "url": "https://example.com/detail-help",
+            "placement": "detail"
+          }
+        ],
+        "action_buttons_mode": "merge"
+      }
+    },
+    {
+      "operation": "remove",
+      "app_key": "WORK_ORDER_APP_KEY",
+      "view_key": "RAW_VIEW_KEY_TO_REMOVE"
+    }
+  ]
+}

package/skills/qingflow-cli/reference/examples/views/views_upsert_table_minimal.example.json

@@ -0,0 +1,42 @@
+{
+  "views": [
+    {
+      "operation": "upsert",
+      "app_key": "APP_KEY",
+      "name": "示例业务操作视图_CLI模板",
+      "type": "table",
+      "columns": ["主记录编号", "主记录名称", "状态", "负责人"],
+      "filters": [
+        {"field_name": "状态", "operator": "neq", "value": "已关闭"}
+      ],
+      "query_conditions": {
+        "enabled": true,
+        "exact": false,
+        "hide_before_query": false,
+        "rows": [["主记录编号", "主记录名称"], ["状态", "负责人"]]
+      },
+      "action_buttons": [
+        {
+          "text": "行内创建子记录",
+          "action": "add_data",
+          "target_app_key": "TARGET_APP_KEY",
+          "field_mappings": [
+            {"source_field": "数据ID", "target_field": "关联主记录"}
+          ],
+          "default_values": {"目标状态字段": "REPLACE_WITH_TARGET_OPTION_LABEL"},
+          "placement": "list"
+        },
+        {
+          "text": "详情创建子记录",
+          "action": "add_data",
+          "target_app_key": "TARGET_APP_KEY",
+          "field_mappings": [
+            {"source_field": "数据ID", "target_field": "关联主记录"}
+          ],
+          "default_values": {"目标状态字段": "REPLACE_WITH_TARGET_OPTION_LABEL"},
+          "placement": "detail"
+        }
+      ]
+    }
+  ]
+}

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

@@ -44,7 +44,21 @@
         "rows": 4
       }
     },
-    "config": {}
+    "config": {
+      "gridTitle": "九宫格",
+      "beingShowTitle": true,
+      "items": [
+        {
+          "type": 1,
+          "jumpMode": 1,
+          "linkAppKey": "YOUR_APP_KEY",
+          "linkFormType": 1,
+          "title": "应用入口",
+          "customTitle": "应用入口",
+          "beingCustomTitle": false
+        }
+      ]
+    }
   },
   {
     "title": "说明文字块",
@@ -72,7 +86,7 @@
       "pc": {
         "x": 0,
         "y": 8,
-        "cols": 12,
+        "cols": 24,
         "rows": 2
       },
       "mobile": {
@@ -113,7 +127,7 @@
       "pc": {
         "x": 0,
         "y": 18,
-        "cols": 12,
+        "cols": 24,
         "rows": 6
       },
       "mobile": {
@@ -123,7 +137,7 @@
         "rows": 6
       }
     },
-    "chart_ref": {
+    "chart": {
       "app_key": "YOUR_APP_KEY",
       "chart_id": "YOUR_CHART_ID"
     }

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

@@ -67,7 +67,7 @@
       "pc": {
         "x": 0,
         "y": 6,
-        "cols": 8,
+        "cols": 24,
         "rows": 6
       },
       "mobile": {
@@ -77,7 +77,7 @@
         "rows": 6
       }
     },
-    "chart_ref": {
+    "chart": {
       "app_key": "ead8ims5i401",
       "chart_id": "mcp_fb104267c5c249ca"
     }
@@ -112,7 +112,7 @@
         "x": 12,
         "y": 12,
         "cols": 12,
-        "rows": 2
+        "rows": 8
       },
       "mobile": {
         "x": 0,

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

@@ -48,7 +48,7 @@
       "pc": {"x": 0, "y": 4, "cols": 6, "rows": 5},
       "mobile": {"x": 0, "y": 4, "cols": 6, "rows": 5}
     },
-    "chart_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_TOTAL"}
+    "chart": {"app_key": "APP_KEY_DEVICE", "name": "设备总数", "chart_type": "target", "metric": "count(*)"}
   },
   {
     "title": "正常设备",
@@ -58,7 +58,13 @@
       "pc": {"x": 6, "y": 4, "cols": 6, "rows": 5},
       "mobile": {"x": 0, "y": 9, "cols": 6, "rows": 5}
     },
-    "chart_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_NORMAL"}
+    "chart": {
+      "app_key": "APP_KEY_DEVICE",
+      "name": "正常设备",
+      "chart_type": "target",
+      "metric": "count(*)",
+      "filters": [{"field_name": "使用状态", "operator": "eq", "value": "正常"}]
+    }
   },
   {
     "title": "维修中设备",
@@ -68,7 +74,13 @@
       "pc": {"x": 12, "y": 4, "cols": 6, "rows": 5},
       "mobile": {"x": 0, "y": 14, "cols": 6, "rows": 5}
     },
-    "chart_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_REPAIRING"}
+    "chart": {
+      "app_key": "APP_KEY_DEVICE",
+      "name": "维修中设备",
+      "chart_type": "target",
+      "metric": "count(*)",
+      "filters": [{"field_name": "使用状态", "operator": "eq", "value": "维修中"}]
+    }
   },
   {
     "title": "本月报修",
@@ -78,7 +90,16 @@
       "pc": {"x": 18, "y": 4, "cols": 6, "rows": 5},
       "mobile": {"x": 0, "y": 19, "cols": 6, "rows": 5}
     },
-    "chart_ref": {"app_key": "APP_KEY_REPAIR", "chart_id": "CHART_ID_REPAIR_MONTH"}
+    "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": "设备状态分布",
@@ -87,7 +108,16 @@
       "pc": {"x": 0, "y": 9, "cols": 8, "rows": 7},
       "mobile": {"x": 0, "y": 24, "cols": 6, "rows": 7}
     },
-    "chart_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_STATUS_DIST"}
+    "chart": {
+      "app_key": "APP_KEY_DEVICE",
+      "name": "设备状态分布",
+      "chart_type": "ring",
+      "metric": "count(*)",
+      "group_by": ["使用状态"],
+      "filters": [
+        {"field_name": "使用状态", "operator": "not_empty"}
+      ]
+    }
   },
   {
     "title": "故障类型分布",
@@ -96,7 +126,17 @@
       "pc": {"x": 8, "y": 9, "cols": 8, "rows": 7},
       "mobile": {"x": 0, "y": 31, "cols": 6, "rows": 7}
     },
-    "chart_ref": {"app_key": "APP_KEY_REPAIR", "chart_id": "CHART_ID_FAULT_DIST"}
+    "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": "维修完成趋势",
@@ -105,7 +145,17 @@
       "pc": {"x": 16, "y": 9, "cols": 8, "rows": 7},
       "mobile": {"x": 0, "y": 38, "cols": 6, "rows": 7}
     },
-    "chart_ref": {"app_key": "APP_KEY_REPAIR", "chart_id": "CHART_ID_REPAIR_TREND"}
+    "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": "异常设备",

package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_CREATE_WORKFLOW.md

@@ -0,0 +1,22 @@
+# Qingflow CLI：创建记录 SOP（申请节点）
+
+---
+
+**创建记录详细规则见**：[record/insert/README.md](./insert/README.md)。
+
+CLI 对应主路径：
+
+```bash
+qingflow --json record schema insert --app-key <APP_KEY> > tmp/qingflow_insert_schema.json
+qingflow --json record insert --app-key <APP_KEY> --items-file tmp/records.json > tmp/qingflow_insert_result.json
+```
+
+不要用 `record schema applicant` 代替 `record schema insert` 的主路径；新建记录需要 insert-ready schema 里的 `required_fields`、`optional_fields`、`payload_template`、`format_hint`、`expected_format`、`example_value` 和字段级 `options`。
+
+成员、部门、关联记录、选项、附件等特殊字段按 [record/insert/README.md](./insert/README.md) 写：先读 insert schema；部门/成员不能自造候选；选项值必须来自 schema `options` 的文本或 id；关联记录批量写入优先 `record_id`，自然名称只在唯一匹配时使用；附件先上传再写返回值。
+
+字段类型写法和一份可复制的全类型 `items` 形状见 [record/insert/README.md](./insert/README.md) 与 [record_insert_all_field_types.example.json](../examples/record/record_insert_all_field_types.example.json)。示例只表达 JSON 形状；真实写入必须替换成目标应用 schema 里的字段标题、选项文本、候选值和真实 `record_id`。
+
+追加样例数据时也必须 schema-first：按 `required_fields` 补齐必填；按 `expected_format/example_value` 选择数值、金额、日期等格式；按 `options` 生成选项值。不要按业务常识自造“正常/已完成/高优先级”等 schema 里不存在的选项。比例、完成率、评分、百分比等字段也按 schema 示例写；即使 builder 字段类型看起来是 `number`，写入时仍以 insert schema 的 `expected_format` 为准。若返回 `INVALID_AMOUNT_VALUE`、`requires an integer amount`、或 schema 显示 `allow_decimal=false`，只修失败行，把小数改成整数，或回到 builder 阶段重建为允许小数的字段；不要强塞 decimal，也不要重试整批已成功行。
+
+录入数据时不要填写轻流系统字段：`数据ID`、`编号`、`申请人`、`申请时间`、`创建人`、`创建时间`、`提交人`、`提交时间`、`更新时间`、`更新人`、`当前流程状态`、`当前处理人`、`当前处理节点`、`流程标题`。这些字段由平台生成；需要确认时在创建成功后读取记录详情，不要把它们写进 `fields` / `items[].fields`。