@qingflow-tech/qingflow-cli 1.1.57 → 1.1.59

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

@@ -1,50 +0,0 @@
-# Qingflow CLI：record 日志与附件参考
-
-> **适用范围**：任务需要完整数据／流程日志、附件或图片上下文时使用。普通应用数据查询使用 [`data query/get`](../core/QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md)。
-
-## record 查询链
-
-```text
-app get（解析 accessible_views，选定 VIEW_ID）
-  → record schema browse（读取该视图字段口径）
-  → record list（样本浏览或模糊定位候选）
-  → record get（可选：详情页首屏、附件与图片上下文）
-  → record logs（可选：完整数据日志与流程日志）
-```
-
-## 命令形状
-
-```bash
-qingflow --json app get --app-key APP_KEY > tmp/qingflow_app_get.json
-
-qingflow --json record schema browse \
-  --app-key APP_KEY --view-id VIEW_ID \
-  > tmp/qingflow_record_schema.json
-
-qingflow --json record list \
-  --app-key APP_KEY --view-id VIEW_ID \
-  > tmp/qingflow_record_list.json
-
-qingflow --json record get \
-  --app-key APP_KEY --record-id RECORD_ID --view-id VIEW_ID \
-  > tmp/qingflow_record_get.json
-
-qingflow --json record logs \
-  --app-key APP_KEY --record-id RECORD_ID --view-id VIEW_ID \
-  > tmp/qingflow_record_logs.json
-```
-
-`VIEW_ID` 只能来自 `app get.accessible_views`、已经确认的前端 URL 或用户明确提供的上下文。显式视图失败时不要自动换成另一系统视图。
-
-## 专有结果
-
-- `record get`：用于详情页字段、首屏日志、引用、关联资源、`media_assets` 和 `file_assets`。附件与图片优先使用返回的本地路径，不直接访问远端附件 URL。
-- `record logs`：用于完整可见数据日志和流程日志。响应只读取摘要与 JSONL 文件路径，按需筛选本地文件，不把全文放入上下文。
-- `record list`：只在用户明确指定该命令时用于样本浏览／模糊定位，不用于完整统计结论。
-
-## 边界
-
-- 统计分析仍转 `data query --all --output csv -> Python/pandas`。
-- `CUSTOM_VIEW_LIST_UNAVAILABLE` 只说明自定义视图列表读取受限；不要据此断言应用整体不可读。
-- 待办、已办和抄送属于 `task list --task-box ...`，不使用 `record list --view-id system:todo/done/cc`。
-- 所有大 JSON、附件清单和日志摘要必须落盘。

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json

@@ -1,146 +0,0 @@
-{
-  "$defs": {
-    "EmptyConfig": {
-      "additionalProperties": false,
-      "description": "该字段类型没有特殊配置。",
-      "type": "object"
-    },
-    "FieldCommon": {
-      "allOf": [
-        {
-          "if": {
-            "properties": {
-              "defaultType": {
-                "const": 2
-              }
-            },
-            "required": [
-              "defaultType"
-            ]
-          },
-          "then": {
-            "properties": {
-              "defaultValue": {
-                "type": "null"
-              }
-            }
-          }
-        },
-        {
-          "if": {
-            "properties": {
-              "defaultType": {
-                "const": 3
-              }
-            },
-            "required": [
-              "defaultType"
-            ]
-          },
-          "then": {
-            "properties": {
-              "defaultValue": {
-                "minLength": 1,
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            }
-          }
-        }
-      ],
-      "anyOf": [
-        {
-          "required": [
-            "queId"
-          ]
-        },
-        {
-          "required": [
-            "name"
-          ]
-        }
-      ],
-      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
-      "properties": {
-        "beingRequired": {
-          "description": "该字段是否必填;缺失时保留已有字段当前值。",
-          "type": "boolean"
-        },
-        "defaultType": {
-          "default": 1,
-          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
-          "enum": [
-            1,
-            2,
-            3
-          ],
-          "type": "integer"
-        },
-        "defaultValue": {
-          "$ref": "#/$defs/ScalarDefaultValue",
-          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
-        },
-        "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
-          "minLength": 1,
-          "type": "string"
-        },
-        "queId": {
-          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
-          "minimum": 1,
-          "type": "integer"
-        },
-        "questionDescription": {
-          "description": "字段说明;null 或空字符串表示清空。",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "questionType": {
-          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
-          "type": "string"
-        },
-        "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
-      "type": [
-        "null",
-        "string"
-      ]
-    }
-  },
-  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/rich_text.json",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "allOf": [
-    {
-      "$ref": "#/$defs/FieldCommon"
-    },
-    {
-      "properties": {
-        "config": {
-          "$ref": "#/$defs/EmptyConfig"
-        },
-        "questionType": {
-          "const": "rich_text"
-        }
-      },
-      "required": [
-        "questionType"
-      ]
-    }
-  ],
-  "title": "Qingflow AppForm v1alpha1 rich_text field",
-  "type": "object",
-  "unevaluatedProperties": false
-}

package/src/qingflow_mcp/cli/commands/data.py

@@ -1,134 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import textwrap
-
-from ..context import CliContext
-from .common import load_list_arg, require_list_arg, require_object_arg, raise_config_error
-
-
-def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser(
-        "data",
-        help="默认应用数据查询与直接增删改",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog=textwrap.dedent("""
-            JSON 文件约定：
-              columns.json  [101, 102]
-              where.json    [{"field_id": 101, "op": "eq", "value": "A"}]
-              sort.json     [{"field_id": 101, "direction": "asc"}]
-              items.json    [{"fields": {"101": "A"}}]
-              fields.json   {"101": "B"}
-            query/get/insert/update 默认返回 field_capabilities；可用 --no-schema 关闭。
-        """).strip(),
-    )
-    commands = parser.add_subparsers(dest="data_command", required=True, metavar="{query,get,insert,update,delete}")
-
-    query = commands.add_parser(
-        "query", help="分页查询应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='最小示例：qingflow data query --app-key APP_1 --where-file where.json\n'
-               'where.json: [{"field_id": 101, "op": "eq", "value": "A"}]',
-    )
-    query.add_argument("--app-key", required=True)
-    query.add_argument("--columns-file", help='JSON 数组，例如 [101, 102]')
-    query.add_argument(
-        "--where-file",
-        help='JSON 数组；项为 {"field_id":101,"op":"eq","value":"A"}，in/not_in 的 value 必须为数组',
-    )
-    query.add_argument("--sort-file", help='JSON 数组，例如 [{"field_id":101,"direction":"asc"}]')
-    query.add_argument("--search", default="")
-    query.add_argument("--page", type=int, default=1)
-    query.add_argument("--page-size", type=int, default=100)
-    query.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    query.add_argument("--all", action="store_true", dest="all_pages")
-    query.add_argument("--output", choices=("json", "csv"), default="json")
-    query.set_defaults(handler=_handle_query, format_hint="data_query")
-
-    get = commands.add_parser("get", help="读取单条应用数据")
-    get.add_argument("--app-key", required=True)
-    get.add_argument("--record-id", required=True)
-    get.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    get.set_defaults(handler=_handle_get, format_hint="data_get")
-
-    insert = commands.add_parser(
-        "insert", help="新增应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='最小示例：items.json = [{"fields": {"101": "A"}}]',
-    )
-    insert.add_argument("--app-key", required=True)
-    insert.add_argument("--items-file", required=True, help='JSON 数组，项为 {"fields":{"字段ID":值}}')
-    insert.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    insert.set_defaults(handler=_handle_insert, format_hint="data_insert")
-
-    update = commands.add_parser(
-        "update", help="更新应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='最小示例：fields.json = {"101": "B"}',
-    )
-    update.add_argument("--app-key", required=True)
-    update.add_argument("--record-id", required=True)
-    update.add_argument("--fields-file", required=True, help='JSON 对象，键为字符串形式 field_id')
-    update.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
-    update.set_defaults(handler=_handle_update, format_hint="data_update")
-
-    delete = commands.add_parser("delete", help="删除应用数据")
-    delete.add_argument("--app-key", required=True)
-    delete.add_argument(
-        "--record-ids", action="append", default=[], metavar="ID[,ID...]",
-        help="待删除记录 ID；支持逗号分隔，也可重复传入",
-    )
-    delete.add_argument("--record-ids-file", help="附加的记录 ID JSON 数组文件")
-    delete.set_defaults(handler=_handle_delete, format_hint="data_delete")
-
-
-def _handle_query(args: argparse.Namespace, context: CliContext) -> dict:
-    if args.all_pages != (args.output == "csv"):
-        raise_config_error(
-            "--all 与 --output csv 必须同时使用。",
-            fix_hint="使用 `qingflow data query ... --all --output csv`，普通分页查询不要传这两个参数。",
-        )
-    return context.data.data_query(
-        profile=args.profile,
-        app_key=args.app_key,
-        columns=load_list_arg(args.columns_file, option_name="--columns-file"),
-        where=load_list_arg(args.where_file, option_name="--where-file"),
-        sort=load_list_arg(args.sort_file, option_name="--sort-file"),
-        search=args.search,
-        page=args.page,
-        page_size=args.page_size,
-        include_schema=args.include_schema,
-        all_pages=args.all_pages,
-        output=args.output,
-    )
-
-
-def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.data.data_get(
-        profile=args.profile, app_key=args.app_key, record_id=args.record_id, include_schema=args.include_schema
-    )
-
-
-def _handle_insert(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.data.data_insert(
-        profile=args.profile, app_key=args.app_key,
-        items=require_list_arg(args.items_file, option_name="--items-file"), include_schema=args.include_schema,
-    )
-
-
-def _handle_update(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.data.data_update(
-        profile=args.profile, app_key=args.app_key, record_id=args.record_id,
-        fields=require_object_arg(args.fields_file, option_name="--fields-file"), include_schema=args.include_schema,
-    )
-
-
-def _handle_delete(args: argparse.Namespace, context: CliContext) -> dict:
-    record_ids = [item.strip() for group in args.record_ids for item in group.split(",") if item.strip()]
-    record_ids.extend(load_list_arg(args.record_ids_file, option_name="--record-ids-file"))
-    if not record_ids:
-        raise_config_error(
-            "至少传入一个记录 ID。",
-            fix_hint="使用 `--record-ids ID[,ID...]`；也可附加 `--record-ids-file ids.json`。",
-        )
-    return context.data.data_delete(
-        profile=args.profile, app_key=args.app_key,
-        record_ids=record_ids,
-    )

package/src/qingflow_mcp/tools/csv_export.py

@@ -1,168 +0,0 @@
-from __future__ import annotations
-
-import csv
-import json
-import time
-from pathlib import Path
-from typing import Any, Callable
-
-from ..json_types import JSONObject
-
-
-PageFetcher = Callable[[int, int], JSONObject]
-RowProjector = Callable[[JSONObject], list[str]]
-
-
-class CsvPageFailure(RuntimeError):
-    """后续分页返回结构化业务错误；已写文件保留为不完整结果。"""
-
-    def __init__(self, payload: JSONObject) -> None:
-        super().__init__(str(payload.get("message") or "分页请求失败"))
-        self.payload = payload
-
-
-class CsvShardWriter:
-    """视图无关的 UTF-8 BOM CSV 分片写入器。"""
-
-    def __init__(self, *, output_dir: Path, file_prefix: str, header: list[str], shard_rows: int) -> None:
-        self.output_dir = output_dir
-        self.file_prefix = file_prefix
-        self.header = header
-        self.shard_rows = shard_rows
-        self.files: list[JSONObject] = []
-        self.row_count = 0
-        self._part = 0
-        self._current_rows = 0
-        self._file: Any | None = None
-        self._writer: Any | None = None
-        output_dir.mkdir(parents=True, exist_ok=True)
-
-    def write(self, values: list[str]) -> None:
-        if self._current_rows >= self.shard_rows:
-            self.close_shard()
-        self._ensure_writer().writerow(values)
-        self._current_rows += 1
-        self.row_count += 1
-
-    def close_shard(self) -> None:
-        if self._file is None:
-            return
-        path = Path(self._file.name)
-        self._file.close()
-        self.files.append({"local_path": str(path), "row_count": self._current_rows, "part": len(self.files) + 1})
-        self._file = None
-        self._writer = None
-        self._current_rows = 0
-
-    def _ensure_writer(self) -> Any:
-        if self._writer is not None:
-            return self._writer
-        self._part += 1
-        path = self.output_dir / f"{self.file_prefix}-{self._part:04d}.csv"
-        self._file = path.open("w", newline="", encoding="utf-8-sig")
-        self._writer = csv.writer(self._file)
-        self._writer.writerow(self.header)
-        return self._writer
-
-
-def export_csv_pages(
-    *,
-    fetch_page: PageFetcher,
-    header: list[str],
-    project_row: RowProjector,
-    output_dir: Path,
-    file_prefix: str,
-    page_size: int,
-    shard_rows: int,
-    time_budget_seconds: float,
-) -> JSONObject:
-    """执行与业务权限无关的分页、CSV 分片和时间预算控制。"""
-    output_dir.mkdir(parents=True, exist_ok=True)
-    deadline = time.monotonic() + time_budget_seconds
-    files: list[JSONObject] = []
-    row_count = 0
-    fetched_pages = 0
-    current_page = 1
-    file_handle: Any | None = None
-    writer: Any | None = None
-    current_rows = 0
-    part = 0
-    has_more = False
-    stopped_reason: str | None = None
-    page_error: JSONObject | None = None
-
-    def close_file() -> None:
-        nonlocal file_handle, writer, current_rows
-        if file_handle is None:
-            return
-        path = Path(file_handle.name)
-        file_handle.close()
-        files.append({"local_path": str(path), "row_count": current_rows, "part": len(files) + 1})
-        file_handle = None
-        writer = None
-        current_rows = 0
-
-    def get_writer() -> Any:
-        nonlocal file_handle, writer, part
-        if writer is not None:
-            return writer
-        part += 1
-        path = output_dir / f"{file_prefix}-{part:04d}.csv"
-        file_handle = path.open("w", newline="", encoding="utf-8-sig")
-        writer = csv.writer(file_handle)
-        writer.writerow(header)
-        return writer
-
-    try:
-        while True:
-            page = fetch_page(current_page, page_size)
-            records = page.get("records") if isinstance(page, dict) else None
-            container = records if isinstance(records, dict) else page
-            raw_items = container.get("items", container.get("list", [])) if isinstance(container, dict) else []
-            items = raw_items if isinstance(raw_items, list) else []
-            has_more = bool(container.get("has_more")) if isinstance(container, dict) else False
-            for item in items:
-                if not isinstance(item, dict):
-                    continue
-                if current_rows >= shard_rows:
-                    close_file()
-                get_writer().writerow(project_row(item))
-                current_rows += 1
-                row_count += 1
-            fetched_pages += 1
-            if not has_more:
-                break
-            if time.monotonic() >= deadline:
-                stopped_reason = "TIME_BUDGET_EXCEEDED"
-                break
-            current_page += 1
-    except CsvPageFailure as exception:
-        stopped_reason = "PAGE_FETCH_FAILED"
-        page_error = exception.payload
-    except Exception:
-        # 已落盘分片仍是有效的部分结果；调用方据此禁止形成完整性结论。
-        stopped_reason = "PAGE_FETCH_FAILED"
-    finally:
-        close_file()
-
-    complete = stopped_reason is None and not has_more
-    result: JSONObject = {
-        "files": files,
-        "row_count": row_count,
-        "complete": complete,
-        "truncated": not complete,
-        "safe_for_final_conclusion": complete,
-        "fetched_pages": fetched_pages,
-        "stopped_reason": stopped_reason,
-    }
-    if page_error is not None:
-        result["page_error"] = page_error
-    return result
-
-
-def csv_cell(value: Any) -> str:
-    if value is None:
-        return ""
-    if isinstance(value, (dict, list)):
-        return json.dumps(value, ensure_ascii=False, separators=(",", ":"))
-    return str(value)