@josephyan/qingflow-cli 1.0.11 → 1.1.2

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

@@ -0,0 +1 @@
+["CHART_ID_FIRST", "CHART_ID_SECOND"]

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

@@ -0,0 +1,8 @@
+[
+  {
+    "name": "示例柱状图",
+    "chart_type": "bar",
+    "group_by": ["REPLACE_WITH_DIMENSION_FIELD_NAME"],
+    "metric": "sum(REPLACE_WITH_NUMERIC_FIELD_NAME)"
+  }
+]

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

@@ -0,0 +1,37 @@
+[
+  {
+    "name": "数据总量",
+    "chart_type": "target",
+    "metric": "count(*)",
+    "visibility": {
+      "mode": "workspace",
+      "selectors": {},
+      "external_mode": "not",
+      "external_selectors": {}
+    }
+  },
+  {
+    "name": "按状态分布",
+    "chart_type": "bar",
+    "group_by": ["REPLACE_WITH_STATUS_FIELD_NAME"],
+    "metric": "count(*)",
+    "visibility": {
+      "mode": "workspace",
+      "selectors": {},
+      "external_mode": "not",
+      "external_selectors": {}
+    }
+  },
+  {
+    "name": "按时间趋势",
+    "chart_type": "line",
+    "group_by": ["REPLACE_WITH_DATE_FIELD_NAME"],
+    "metric": "count(*)",
+    "visibility": {
+      "mode": "workspace",
+      "selectors": {},
+      "external_mode": "not",
+      "external_selectors": {}
+    }
+  }
+]

package/skills/qingflow-cli/reference/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/portal_sections_all_types.example.json

@@ -0,0 +1,131 @@
+[
+  {
+    "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": {}
+  },
+  {
+    "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": 12,
+        "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": 12,
+        "rows": 6
+      },
+      "mobile": {
+        "x": 0,
+        "y": 18,
+        "cols": 6,
+        "rows": 6
+      }
+    },
+    "chart_ref": {
+      "app_key": "YOUR_APP_KEY",
+      "chart_id": "YOUR_CHART_ID"
+    }
+  }
+]

package/skills/qingflow-cli/reference/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": 8,
+        "rows": 6
+      },
+      "mobile": {
+        "x": 0,
+        "y": 6,
+        "cols": 6,
+        "rows": 6
+      }
+    },
+    "chart_ref": {
+      "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": 2
+      },
+      "mobile": {
+        "x": 0,
+        "y": 20,
+        "cols": 6,
+        "rows": 2
+      }
+    },
+    "url": "https://example.com"
+  }
+]

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

@@ -0,0 +1,128 @@
+[
+  {
+    "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_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_TOTAL"}
+  },
+  {
+    "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_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_NORMAL"}
+  },
+  {
+    "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_ref": {"app_key": "APP_KEY_DEVICE", "chart_id": "CHART_ID_REPAIRING"}
+  },
+  {
+    "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_ref": {"app_key": "APP_KEY_REPAIR", "chart_id": "CHART_ID_REPAIR_MONTH"}
+  },
+  {
+    "title": "设备状态分布",
+    "source_type": "chart",
+    "position": {
+      "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"}
+  },
+  {
+    "title": "故障类型分布",
+    "source_type": "chart",
+    "position": {
+      "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"}
+  },
+  {
+    "title": "维修完成趋势",
+    "source_type": "chart",
+    "position": {
+      "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"}
+  },
+  {
+    "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/schema_add_fields_minimal.example.json

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

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

@@ -0,0 +1,78 @@
+[
+  {
+    "name": "QFCLI_AT_text",
+    "type": "text",
+    "as_data_title": true,
+    "description": "【本文件用法】推荐一次成功：npx @qingflow-tech/qingflow-cli --profile default builder schema apply --package-id <你的包tag_id> --app-name \"新应用名\" --create-if-missing --no-publish --add-fields-file schema_apply_add_fields_all_types.json。内含19种搭建 type（另含远程查询/代码块所需辅助 text），且已在本字段标记 as_data_title。关联字段 target_app_key 默认为本仓库实测用的模板应用 ead8ims5i401（须含「单行文字」「多行文字」）；其它租户请改成你方可读的目标应用 app_key。若用 --app-key 向已有应用追加：须无「关联」字段且字段名不重复；每应用仅允许一个 relation。"
+  },
+  {"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": "多行文字"}]
+  }
+]

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

@@ -0,0 +1,7 @@
+[
+  {
+    "name": "示例表视图_CLI模板",
+    "type": "table",
+    "columns": ["单行文字", "多行文字"]
+  }
+]

package/skills/qingflow-cli/scripts/builder-package-from-app-list.py

@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+"""纯 CLI 曲线：在 **无** `package_list` / `package_resolve` 子命令时，用 `app list` + `builder app resolve` 解析包。
+
+- `app list`（`GET /tag/apps` 扁平结果）常见含 **`package_name`**（分组显示名），**不一定**含数值 **`tag_id`**。
+- `builder app resolve --app-key` 的 JSON 里常有 **`package_ids`**（与 MCP `package_get` 所用的 `tag_id` 同源）。
+
+子命令:
+  list-names              打印去重后的 `package_name` 列表（JSON 数组）
+  resolve-id <显示名>      **精确匹配** `package_name`，取该组下第一个 `app_key`，再 `builder app resolve`，打印含 `package_ids` 的 JSON object
+
+环境（可选）: `QINGFLOW_PROFILE` → 等价于 `qingflow --profile <名称>`
+
+注意:
+- 若工作区内存在 **同名分组**（多个 `tag_id` 共用显示名），本脚本 **无法**区分，请用管理端或 MCP `package_list`。
+- 某包下 **尚未有任何可见应用** 时，无法从 `app list` 曲线解析。
+
+用法:
+  ./scripts/builder-package-from-app-list.py list-names
+  ./scripts/builder-package-from-app-list.py resolve-id 'test'
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import shutil
+import subprocess
+import sys
+from typing import Any
+
+
+def _qf_base() -> list[str]:
+    cmd = ["qingflow"]
+    pf = os.environ.get("QINGFLOW_PROFILE") or os.environ.get("QING_FLOW_PROFILE")
+    if pf:
+        cmd.extend(["--profile", pf])
+    return cmd
+
+
+def _run_json(cmd: list[str]) -> dict[str, Any]:
+    proc = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=None)
+    if proc.returncode != 0:
+        sys.stdout.buffer.write(proc.stdout)
+        sys.stdout.flush()
+        raise SystemExit(proc.returncode)
+    try:
+        text = proc.stdout.decode("utf-8")
+        payload = json.loads(text)
+    except (UnicodeDecodeError, json.JSONDecodeError) as e:
+        print(f"qingflow JSON 解析失败: {e}", file=sys.stderr)
+        sys.stdout.buffer.write(proc.stdout)
+        sys.stdout.flush()
+        raise SystemExit(1) from e
+    if not isinstance(payload, dict):
+        print("qingflow JSON 根不是 object", file=sys.stderr)
+        raise SystemExit(1)
+    return payload
+
+
+def _app_list_items(payload: dict[str, Any]) -> list[dict[str, Any]]:
+    it = payload.get("items")
+    if isinstance(it, list):
+        return [x for x in it if isinstance(x, dict)]
+    nested = payload.get("data")
+    if isinstance(nested, dict):
+        it2 = nested.get("items")
+        if isinstance(it2, list):
+            return [x for x in it2 if isinstance(x, dict)]
+    return []
+
+
+def cmd_list_names() -> None:
+    if not shutil.which("qingflow"):
+        print("qingflow: command not found", file=sys.stderr)
+        sys.exit(127)
+    payload = _run_json(_qf_base() + ["--json", "app", "list"])
+    rows = _app_list_items(payload)
+    names: set[str] = set()
+    for o in rows:
+        pn = o.get("package_name")
+        if isinstance(pn, str) and pn.strip():
+            names.add(pn.strip())
+    json.dump(sorted(names), sys.stdout, ensure_ascii=False, indent=2)
+    sys.stdout.write("\n")
+
+
+def cmd_resolve_id(display_name: str) -> None:
+    if not shutil.which("qingflow"):
+        print("qingflow: command not found", file=sys.stderr)
+        sys.exit(127)
+    want = display_name.strip()
+    if not want:
+        print("显示名不能为空", file=sys.stderr)
+        sys.exit(2)
+
+    payload = _run_json(_qf_base() + ["--json", "app", "list"])
+    rows = _app_list_items(payload)
+    app_key: str | None = None
+    for o in rows:
+        pn = o.get("package_name")
+        if isinstance(pn, str) and pn.strip() == want:
+            ak = o.get("app_key")
+            if isinstance(ak, str) and ak.strip():
+                app_key = ak.strip()
+                break
+    if not app_key:
+        print(json.dumps({"error": "no_app_under_package_name", "package_name": want}, ensure_ascii=False, indent=2))
+        sys.exit(3)
+
+    resolved = _run_json(_qf_base() + ["--json", "builder", "app", "resolve", "--app-key", app_key])
+    out = {
+        "package_name": want,
+        "sample_app_key": app_key,
+        "package_ids": resolved.get("package_ids"),
+        "resolve": resolved,
+    }
+    json.dump(out, sys.stdout, ensure_ascii=False, indent=2)
+    sys.stdout.write("\n")
+
+
+def main() -> None:
+    if len(sys.argv) < 2:
+        print(__doc__.strip(), file=sys.stderr)
+        sys.exit(2)
+    sub = sys.argv[1].strip().lower()
+    if sub in {"list-names", "list_names", "names"}:
+        cmd_list_names()
+        return
+    if sub in {"resolve-id", "resolve_id", "resolve"}:
+        if len(sys.argv) != 3:
+            print("用法: … resolve-id '<package显示名>'", file=sys.stderr)
+            sys.exit(2)
+        cmd_resolve_id(sys.argv[2])
+        return
+    print(__doc__.strip(), file=sys.stderr)
+    sys.exit(2)
+
+
+if __name__ == "__main__":
+    main()