@qingflow-tech/qingflow-cli 1.1.50 → 1.1.51

package/src/qingflow_mcp/cli/formatters.py

@@ -8,10 +8,7 @@ from typing import Any, TextIO
 def emit_text_result(result: dict[str, Any], *, hint: str, stream: TextIO) -> None:
     text = _format_cancelled_result(result)
     if text is None:
-        if hint in _DATA_FORMAT_HINTS:
-            # 数据面失败也必须保留 field_errors 与列表型 hints，不能先走通用失败裁剪。
-            text = _format_data_result(result)
-        elif _is_failed_result(result) and hint != "task_action_execute":
+        if _is_failed_result(result) and hint != "task_action_execute":
             text = _format_failed_result(result)
         else:
             formatter = _FORMATTERS.get(hint, _format_generic)
@@ -93,92 +90,6 @@ def _format_generic(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
-def _format_data_result(result: dict[str, Any]) -> str:
-    lines = [f"Status: {result.get('status') or ('success' if result.get('ok') is not False else 'failed')}"]
-    if result.get("format") == "csv":
-        files = result.get("files") if isinstance(result.get("files"), list) else []
-        lines.extend(
-            [
-                f"Local dir: {result.get('local_dir') or '-'}",
-                f"Files: {len(files)}",
-            ]
-        )
-        for item in files:
-            if isinstance(item, dict):
-                lines.append(
-                    f"- part {item.get('part')}: {item.get('local_path')} ({item.get('row_count')} rows)"
-                )
-        lines.extend(
-            [
-                f"Rows: {result.get('row_count')}",
-                f"Complete: {result.get('complete')}",
-                f"Truncated: {result.get('truncated')}",
-                f"Safe for final conclusion: {result.get('safe_for_final_conclusion')}",
-                f"Stopped reason: {result.get('stopped_reason') or '-'}",
-            ]
-        )
-    access = result.get("access") if isinstance(result.get("access"), dict) else {}
-    if access:
-        sources = access.get("scope_sources") if isinstance(access.get("scope_sources"), list) else []
-        lines.append(
-            f"Access: level={access.get('level') or '-'} / can_write={access.get('can_write')}"
-            f" / scope_sources={','.join(str(item) for item in sources) or '-'}"
-        )
-
-    records = result.get("records") if isinstance(result.get("records"), dict) else {}
-    if records:
-        items = records.get("items") if isinstance(records.get("items"), list) else []
-        lines.append(
-            "Pagination: "
-            f"page={records.get('page')} / requested_page_size={records.get('requested_page_size')} / "
-            f"page_size={records.get('page_size')} / total={records.get('total')} / "
-            f"has_more={records.get('has_more')} / returned={len(items)}"
-        )
-    record = result.get("record") if isinstance(result.get("record"), dict) else {}
-    if record:
-        lines.append(f"Record ID: {record.get('record_id') or '-'}")
-    items = result.get("items") if isinstance(result.get("items"), list) else []
-    if items:
-        lines.append(f"Items: {len(items)}")
-
-    for key, label in (
-        ("error_code", "Error Code"),
-        ("message", "Message"),
-        ("write_executed", "Write Executed"),
-        ("retry_safe", "Retry Safe"),
-    ):
-        if key in result:
-            lines.append(f"{label}: {result.get(key)}")
-
-    field_errors = result.get("field_errors") if isinstance(result.get("field_errors"), list) else []
-    if field_errors:
-        lines.append("Field Errors:")
-        _append_data_field_errors(lines, field_errors)
-    for index, item in enumerate(items):
-        if not isinstance(item, dict) or not isinstance(item.get("field_errors"), list):
-            continue
-        lines.append(f"Item {index} Field Errors:")
-        _append_data_field_errors(lines, item["field_errors"])
-
-    hints = result.get("hints") if isinstance(result.get("hints"), list) else []
-    lines.append(f"Hints: {len(hints)}")
-    for hint in hints:
-        if isinstance(hint, dict):
-            lines.append(f"- {hint.get('code') or '-'}: {hint.get('message') or '-'}")
-        else:
-            lines.append(f"- {hint}")
-    return "\n".join(lines) + "\n"
-
-
-def _append_data_field_errors(lines: list[str], field_errors: list[Any]) -> None:
-    for error in field_errors:
-        if isinstance(error, dict):
-            lines.append(
-                f"- {error.get('path') or '-'}: {error.get('message') or '-'}"
-                f" / fix_hint={error.get('fix_hint') or '-'}"
-            )
-
-
 def _format_whoami(result: dict[str, Any]) -> str:
     lines = [
         f"User: {result.get('nick_name') or '-'} ({result.get('email') or '-'})",
@@ -1758,11 +1669,4 @@ _FORMATTERS = {
     "builder_summary": _format_builder_summary,
     "file_upload_local": _format_file_upload_local,
     "feedback_submit": _format_feedback_submit,
-    "data_query": _format_data_result,
-    "data_get": _format_data_result,
-    "data_insert": _format_data_result,
-    "data_update": _format_data_result,
-    "data_delete": _format_data_result,
 }
-
-_DATA_FORMAT_HINTS = {"data_query", "data_get", "data_insert", "data_update", "data_delete"}

package/src/qingflow_mcp/config.py

@@ -26,6 +26,7 @@ DEFAULT_REPOSITORY_PROD_BRANCH = "prod"
 DEFAULT_REPOSITORY_AUTHOR_NAME = "qingflow-mcp"
 DEFAULT_REPOSITORY_AUTHOR_EMAIL = "qingflow-mcp@local.invalid"
 DEFAULT_REPOSITORY_INTERNAL_SHARE_TOKEN_KEY = "tokenKey"
+DEFAULT_MEMBER_CREDIT_AVAILABILITY_PATH = "/credit/member/availability"
 DEFAULT_CREDIT_USAGE_RECORD_PATH = "/user/credit/usage"
 DEFAULT_MCPORTER_CONFIG_PATH = "~/.openclaw/workspace/config/mcporter.json"
 DEFAULT_CLOUD_AUTH_CONTEXT_TTL_SECONDS = 604800

package/src/qingflow_mcp/public_surface.py

@@ -40,11 +40,6 @@ USER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(USER_DOMAIN, "workspace_select", ("workspace_select",), ("workspace", "select")),
     PublicToolSpec(USER_DOMAIN, "app_list", ("app_list",), ("app", "list"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "app_get", ("app_get",), ("app", "get"), cli_show_effective_context=True),
-    PublicToolSpec(USER_DOMAIN, "data_query", ("data_query",), ("data", "query"), cli_show_effective_context=True),
-    PublicToolSpec(USER_DOMAIN, "data_get", ("data_get",), ("data", "get"), cli_show_effective_context=True),
-    PublicToolSpec(USER_DOMAIN, "data_insert", ("data_insert",), ("data", "insert"), cli_show_effective_context=True, cli_context_write=True),
-    PublicToolSpec(USER_DOMAIN, "data_update", ("data_update",), ("data", "update"), cli_show_effective_context=True, cli_context_write=True),
-    PublicToolSpec(USER_DOMAIN, "data_delete", ("data_delete",), ("data", "delete"), cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(USER_DOMAIN, "portal_list", ("portal_list",), ("portal", "list"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "portal_get", ("portal_get",), ("portal", "get"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "view_get", ("view_get",), ("view", "get"), cli_show_effective_context=True),

package/src/qingflow_mcp/server.py

@@ -7,7 +7,6 @@ from mcp.server.fastmcp import FastMCP
 from .backend_client import BackendClient
 from .session_store import SessionStore
 from .tools.app_tools import AppTools
-from .tools.data_tools import DataTools
 from .tools.auth_tools import AuthTools
 from .tools.code_block_tools import CodeBlockTools
 from .tools.feedback_tools import FeedbackTools
@@ -250,7 +249,6 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     TaskContextTools(sessions, backend).register(server)
     RoleTools(sessions, backend).register(server)
     AppTools(sessions, backend).register(server)
-    DataTools(sessions, backend).register(server)
     QingbiReportTools(sessions, backend).register(server)
     PackageTools(sessions, backend).register(server)
     NavigationTools(sessions, backend).register(server)

package/src/qingflow_mcp/server_app_user.py

@@ -10,7 +10,6 @@ from .config import DEFAULT_PROFILE
 from .response_trim import USER_SERVER_METHOD_MAP, trim_error_response, trim_public_response, wrap_trimmed_methods
 from .session_store import SessionStore
 from .tools.app_tools import AppTools
-from .tools.data_tools import DataTools
 from .tools.auth_tools import AuthTools
 from .tools.code_block_tools import CodeBlockTools
 from .tools.directory_tools import DirectoryTools
@@ -243,7 +242,6 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     backend = BackendClient()
     auth = wrap_trimmed_methods(AuthTools(sessions, backend), USER_SERVER_METHOD_MAP)
     apps = wrap_trimmed_methods(AppTools(sessions, backend), USER_SERVER_METHOD_MAP)
-    data_tools = wrap_trimmed_methods(DataTools(sessions, backend), USER_SERVER_METHOD_MAP)
     workspace = wrap_trimmed_methods(WorkspaceTools(sessions, backend), USER_SERVER_METHOD_MAP)
     file_tools = wrap_trimmed_methods(FileTools(sessions, backend), USER_SERVER_METHOD_MAP)
     imports = wrap_trimmed_methods(ImportTools(sessions, backend), USER_SERVER_METHOD_MAP)
@@ -397,8 +395,6 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
     def app_get(profile: str = DEFAULT_PROFILE, app_key: str = "") -> dict:
         return apps.app_get(profile=profile, app_key=app_key)
 
-    data_tools.register(server)
-
     @server.tool()
     def portal_list(profile: str = DEFAULT_PROFILE) -> dict:
         return resources.portal_list(profile=profile)

package/src/qingflow_mcp/tools/base.py

@@ -8,6 +8,7 @@ from ..backend_client import BackendRequestContext, BackendClient
 from ..auth_provider import CliSessionFacade
 from ..cloud_context import current_call_platform, current_cloud_context
 from ..config import (
+    DEFAULT_MEMBER_CREDIT_AVAILABILITY_PATH,
     get_credit_meter_enabled,
     get_credit_usage_base_url,
     get_credit_usage_path,
@@ -19,6 +20,16 @@ from ..session_store import BackendSession, SessionProfile, SessionStore
 
 T = TypeVar("T")
 _RUN_DEPTH: ContextVar[int] = ContextVar("qingflow_mcp_tool_run_depth", default=0)
+_MEMBER_CREDIT_DENIAL_MESSAGES = {
+    "WORKSPACE_EXHAUSTED": "当前工作区流币余额不足，请充值后再使用 MCP",
+    "MEMBER_MONTHLY_EXHAUSTED": "本月个人流币额度已用完，请联系工作区管理员调整额度",
+    "MEMBER_TOTAL_EXHAUSTED": "个人流币总额度已用完，请联系工作区管理员调整额度",
+    "MEMBER_MONTHLY_AND_TOTAL_EXHAUSTED": (
+        "本月和个人总流币额度均已用完，请联系工作区管理员调整额度"
+    ),
+    "MEMBER_QUOTA_NOT_CONFIGURED": "当前成员尚未配置流币额度，请联系工作区管理员",
+    "MEMBER_USAGE_QUERY_FAILED": "成员流币额度校验失败，请稍后重试",
+}
 
 
 class ToolBase:
@@ -332,28 +343,49 @@ class ToolBase:
         if context.ws_id is None:
             raise_tool_error(QingflowApiError(category="payment", message="credit meter requires wsId in current session context"))
 
+        credit_context = BackendRequestContext(
+            base_url=get_credit_usage_base_url() or context.base_url,
+            token=context.token,
+            ws_id=context.ws_id,
+            qf_request_id=context.qf_request_id,
+            qf_version=context.qf_version,
+            qf_version_source=context.qf_version_source,
+        )
+        self._require_member_credit_available(context=credit_context)
         self._record_credit_usage(
             tool_name=tool_name,
-            context=context,
+            context=credit_context,
         )
 
+    def _require_member_credit_available(self, *, context: BackendRequestContext) -> None:
+        availability = self.backend.request("GET", context, DEFAULT_MEMBER_CREDIT_AVAILABILITY_PATH)
+        if not isinstance(availability, dict) or not isinstance(availability.get("allowed"), bool):
+            raise_tool_error(QingflowApiError(
+                category="payment",
+                message="成员流币额度校验失败，请稍后重试",
+            ))
+        if availability["allowed"]:
+            return
+
+        deny_reason = self._normalize_text(availability.get("denyReason")) or "UNKNOWN"
+        raise_tool_error(QingflowApiError(
+            category="payment",
+            message=_MEMBER_CREDIT_DENIAL_MESSAGES.get(
+                deny_reason,
+                "当前成员无法使用流币，请联系工作区管理员",
+            ),
+            details={"deny_reason": deny_reason},
+        ))
+
     def _record_credit_usage(
         self,
         *,
         tool_name: str,
         context: BackendRequestContext,
     ) -> None:
-        usage_context = BackendRequestContext(
-            base_url=get_credit_usage_base_url() or context.base_url,
-            token=context.token,
-            ws_id=context.ws_id,
-            qf_request_id=context.qf_request_id,
-            qf_version=context.qf_version,
-            qf_version_source=context.qf_version_source,
-        )
         self.backend.request(
             "POST",
-            usage_context,
+            context,
             get_credit_usage_path(),
             json_body={
                 "skuType": "MCP",

package/src/qingflow_mcp/tools/record_tools.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import csv
 import html
 import mimetypes
 import json
@@ -33,7 +34,6 @@ from ..list_type_labels import (
 )
 from .base import ToolBase
 from .directory_tools import _directory_has_more, _directory_items
-from .csv_export import CsvShardWriter
 
 
 DEFAULT_QUERY_PAGE_SIZE = 50
@@ -2284,22 +2284,57 @@ class RecordTools(ToolBase):
                 }
 
             run_dir = _record_access_run_dir()
+            run_dir.mkdir(parents=True, exist_ok=True)
             header = ["record_id"] + [str(field["column_name"]) for field in fields_payload]
-            shard_writer = CsvShardWriter(
-                output_dir=run_dir,
-                file_prefix="records",
-                header=header,
-                shard_rows=DEFAULT_RECORD_ACCESS_SHARD_ROWS,
-            )
+            files: list[JSONObject] = []
+            shard_part = 0
+            shard_rows = 0
+            row_count = 0
+            file_handle: Any | None = None
+            writer: Any | None = None
+
+            def close_shard() -> None:
+                nonlocal file_handle, writer, shard_rows
+                if file_handle is None:
+                    return
+                path = Path(file_handle.name)
+                file_handle.close()
+                files.append(
+                    {
+                        "local_path": str(path),
+                        "row_count": shard_rows,
+                        "part": len(files) + 1,
+                    }
+                )
+                file_handle = None
+                writer = None
+                shard_rows = 0
+
+            def ensure_writer() -> Any:
+                nonlocal file_handle, writer, shard_part
+                if writer is not None:
+                    return writer
+                shard_part += 1
+                path = run_dir / f"records-{shard_part:04d}.csv"
+                file_handle = path.open("w", newline="", encoding="utf-8-sig")
+                writer = csv.writer(file_handle)
+                writer.writerow(header)
+                return writer
 
             def write_record(apply_id: int | None, answer_list: list[JSONValue]) -> None:
+                nonlocal row_count, shard_rows
                 if apply_id is None:
                     return
+                if shard_rows >= DEFAULT_RECORD_ACCESS_SHARD_ROWS:
+                    close_shard()
+                csv_writer = ensure_writer()
                 values: list[str] = [_public_record_id_text(apply_id) or ""]
                 for field in selected_fields:
                     answer = _find_answer_for_field(answer_list, field)
                     values.append(_record_access_csv_cell(_normalize_answer_field_value_for_output(answer, field)))
-                shard_writer.write(values)
+                csv_writer.writerow(values)
+                row_count += 1
+                shard_rows += 1
 
             current_page = 1
             has_more = False
@@ -2339,7 +2374,7 @@ class RecordTools(ToolBase):
                         break
                     page = fetch_page(current_page, BACKEND_RECORD_ACCESS_PAGE_SIZE)
             finally:
-                shard_writer.close_shard()
+                close_shard()
 
             if stopped_reason == "TIME_BUDGET_EXCEEDED":
                 warnings.append(_record_access_time_budget_warning(reported_total=reported_total, fetched_pages=fetched_pages))
@@ -2364,11 +2399,11 @@ class RecordTools(ToolBase):
                 "view_id": view_route.view_id,
                 "format": "csv",
                 "local_dir": str(run_dir),
-                "row_count": shard_writer.row_count,
+                "row_count": row_count,
                 "complete": complete,
                 "truncated": not complete,
                 "safe_for_final_conclusion": safe_for_final_conclusion,
-                "files": shard_writer.files,
+                "files": files,
                 "fields": fields_payload,
                 "warnings": warnings,
                 "verification": verification_payload,

package/skills/qingflow-cli/reference/data/README.md

@@ -1,32 +0,0 @@
-# Qingflow CLI 直接数据操作
-
-直接查询、读取、新增、更新和删除分别使用：
-
-- `qingflow data query`
-- `qingflow data get`
-- `qingflow data insert`
-- `qingflow data update`
-- `qingflow data delete`
-
-参数、JSON 文件形状和可选项必须来自当前工具 schema、当次 `--help` 或响应字段能力，不得从其他命令推测。
-
-## 字段能力合同
-
-1. 首次操作当前应用时，只通过只读 `data query/get` 请求 `include_schema=true`，读取同一次响应中的 `schema` 与递归 `field_capabilities`；不得用 insert/update 探测能力。
-2. 构造 `where` 时，只使用目标字段 `filter_operators` 实际暴露的 `op`，并匹配对应 `value_shape`；不要在本文复制操作符矩阵。
-3. 写入前优先执行不设置 `columns` 的只读 `data query` 并请求 schema，检查响应中的 `access`，再检查 `insertable`、`updatable` 与 `required_on_insert`。
-4. `write_kind`、schema 与当次 `--help` 共同决定 payload 形状；运行时字段错误和权限结果优先于预检。
-
-## 执行与恢复
-
-- 已知 `app_key` 时直接执行目标业务命令；只有业务命令明确报告会话或工作区错误后才恢复认证上下文。
-- 定位目标记录时先 query，再按需 get。字段只使用当前 schema 与字段能力允许的 id、能力和形状。
-- insert、update、delete 会改变真实业务数据。删除、覆盖已有值或批量写入前，必须确认目标和影响范围。
-- 返回后先检查 `write_executed`、`retry_safe`、字段错误和 hints。已执行、部分成功或状态不明时不得重放原请求。
-- data 命令失败时只修正响应明确指出的问题，不得切换其他数据入口绕过权限或校验。
-
-## 任务分流
-
-- 批量导入：阅读 [批量导入 SOP](../record/QINGFLOW_CLI_RECORD_IMPORT_WORKFLOW.md)。
-- 统计分析：阅读 [数据分析说明](../record/analysis/README.md)，使用 `data query --all --output csv` 并读取全部 CSV 分片。
-- 待办和流程动作：阅读 [任务上下文 SOP](../task/QINGFLOW_CLI_TASK_CONTEXT_WORKFLOW.md)。

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/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,
-    )