@qingflow-tech/qingflow-cli 1.1.57 → 1.1.58

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json

@@ -136,10 +136,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
           "minLength": 1,
           "type": "string"
         },
@@ -258,9 +258,13 @@
           "type": "array"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
           "type": "integer"
         }
       },
@@ -330,10 +334,11 @@
           "description": "段落判别值。"
         },
         "rows": {
-          "description": "段落内的有序字段行;可为空数组(空 = 存量空段落形态,后端容忍,round-trip 空↔空稳定)。",
+          "description": "段落内的非空有序字段行。",
           "items": {
             "$ref": "#/$defs/FieldRow"
           },
+          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -378,6 +383,7 @@
             ],
             "type": "object"
           },
+          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -689,7 +695,6 @@
   "x-qingflow-supported-field-types": [
     "text",
     "long_text",
-    "rich_text",
     "number",
     "amount",
     "link",

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json

@@ -75,7 +75,7 @@
               }
             ]
           },
-          "filtersDescription": "数据范围规则，仅 type=custom 且 scope=custom 时生效，编译为 viewgraphLimit。不会叠在 config 或 all/oneself/dept/subordinate 上。扁平 [rule,...]=单组 AND;嵌套 [[rule,...],...]=组间 OR、组内 AND。",
+          "filtersDescription": "数据范围规则，仅 type=custom 且 scope=custom 时生效，编译为 viewgraphLimit。不会叠在 config 或 all/oneself/dept 上。扁平 [rule,...]=单组 AND;嵌套 [[rule,...],...]=组间 OR、组内 AND。",
           "x-backend": "viewgraphLimitType=1 + viewgraphLimit(List<List<MatchRule>> 单组);公式形态(scope=custom 的 OR 组)列 v1alpha2"
         },
         "sort": {
@@ -330,12 +330,11 @@
             "all",
             "oneself",
             "dept",
-            "subordinate",
             "custom"
           ],
           "default": "all",
-          "dataScopeDescription": "写出 data_permission 时必填，且只在 type=custom 时生效。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；subordinate=下属发起；custom=用 filters 作为数据范围。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。",
-          "x-backend": "dataScope(ALL|ONESELF|DEPT|SUBORDINATE|CUSTOM)"
+          "dataScopeDescription": "写出 data_permission 时必填，且只在 type=custom 时生效。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；custom=用 filters 作为数据范围。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。",
+          "x-backend": "dataScope(ALL|ONESELF|DEPT|CUSTOM)"
         }
       }
     },

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/data-permission.json

@@ -39,13 +39,13 @@
   "x-qingflow-apply-semantics": "写出 data_permission 时 type 与 scope 都必填，优先 type=custom、scope=all。整段省略时创建路径才按 custom + all。只有要跟随应用成员授权时才用 type=config，此时不要用 scope 表达范围。filters 仅在 type=custom 且 scope=custom 时作为数据范围；省略 filters 表示保留现有规则，空数组表示清空。",
   "x-qingflow-mode-requirements": {
     "default": "未声明 data_permission 时按 custom + all 创建。需要限制行时再改 scope，不要默认改成 config。",
-    "config": "跟随应用成员授权的数据权限。视图上的 scope、filters 不参与查询。应用授权组自己可以是全部、自己、部门、下属或自定义公式，那些规则写在成员授权上，不写在视图声明里。",
-    "custom": "使用视图自己的 dataScope。scope=all 不追加范围；oneself/dept/subordinate 用预设的申请人范围，不读 filters；scope=custom 时 filters 才是数据范围规则。",
+    "config": "跟随应用成员授权的数据权限。视图上的 scope、filters 不参与查询。应用授权组的范围写在成员授权上，不写在视图声明里。",
+    "custom": "使用视图自己的 dataScope。scope=all 不追加范围；oneself/dept 用预设的申请人范围，不读 filters；scope=custom 时 filters 才是数据范围规则。",
     "filters": "只在 type=custom 且 scope=custom 时作为数据权限生效。扁平数组表示一组 AND；嵌套数组表示组间 OR、组内 AND。不是叠在 config 或预设范围上的第二层筛选。"
   },
   "x-qingflow-backend-semantics": {
     "data_permission.type": "dataPermissionType(CONFIG/CUSTOM)",
-    "data_permission.scope": "dataScope(ALL/ONESELF/DEPT/SUBORDINATE/CUSTOM)",
+    "data_permission.scope": "dataScope(ALL/ONESELF/DEPT/CUSTOM)",
     "filters": "viewgraphLimitType=1 + viewgraphLimit；空数组清除简易条件。"
   },
   "x-qingflow-unsupported": {

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/summary.json

@@ -218,12 +218,11 @@
             "all",
             "oneself",
             "dept",
-            "subordinate",
             "custom"
           ],
           "default": "all",
-          "dataScopeDescription": "写出 data_permission 时必填，且只在 type=custom 时生效。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；subordinate=下属发起；custom=用 filters 作为数据范围(规则在 complete 或 schema_kind=data-permission)。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。dataset-v0 实测分布:all×560 / custom×74 / oneself×71。",
-          "x-backend": "viewgraph.dataScope(ALL|ONESELF|DEPT|SUBORDINATE|CUSTOM)"
+          "dataScopeDescription": "写出 data_permission 时必填，且只在 type=custom 时生效。all=不追加数据范围；oneself=仅自己发起；dept=所在部门发起；custom=用 filters 作为数据范围(规则在 complete 或 schema_kind=data-permission)。type=config 时不要用 scope 选择应用权限，应用授权组的范围写在成员授权上。dataset-v0 实测分布:all×560 / custom×74 / oneself×71。",
+          "x-backend": "viewgraph.dataScope(ALL|ONESELF|DEPT|CUSTOM)"
         }
       }
     }

package/src/qingflow_mcp/builder_facade/service.py

@@ -163,14 +163,9 @@ FIELD_TYPE_TO_QUESTION_TYPE: dict[str, int] = {
     FieldType.relation.value: 25,
 }
 
-# code_block / q_linker 输出目标字段类型。后端写链无类型白名单(FormSvcImpl 原样
-# 落库),运行时 DataSvcImpl.getAnswerValueByString:attachment 按拆分 URL 写入、
-# subtable 整表组装(均有专门分支),rich_text/data_relation 走 Question.canImport
-# 兜底按字符串写入(不报错)——四者为存量合法配置,与 validator 侧白名单同口径。
 INTEGRATION_OUTPUT_TARGET_FIELD_TYPES: tuple[str, ...] = (
     FieldType.text.value,
     FieldType.long_text.value,
-    "rich_text",
     FieldType.number.value,
     FieldType.amount.value,
     FieldType.date.value,
@@ -178,9 +173,6 @@ INTEGRATION_OUTPUT_TARGET_FIELD_TYPES: tuple[str, ...] = (
     FieldType.single_select.value,
     FieldType.multi_select.value,
     FieldType.boolean.value,
-    FieldType.attachment.value,
-    "data_relation",
-    FieldType.subtable.value,
 )
 
 MATCH_TYPE_ACCURACY = 1
@@ -13776,7 +13768,7 @@ class AiBuilderFacade:
                 schema_version=schema_version,
             )
         projected: list[dict[str, Any]] = []
-        scope_map = {"ALL": "all", "ONESELF": "oneself", "DEPT": "dept", "SUBORDINATE": "subordinate", "CUSTOM": "custom"}
+        scope_map = {"ALL": "all", "ONESELF": "oneself", "DEPT": "dept", "CUSTOM": "custom"}
         for view in views if isinstance(views, list) else []:
             if not isinstance(view, dict):
                 continue
@@ -13805,10 +13797,12 @@ class AiBuilderFacade:
             if title_que_id is not None and title_que_id in name_by_que_id:
                 entry.setdefault("title_field", name_by_que_id[title_que_id])
             data_permission_type = view.get("dataPermissionType")
-            if data_permission_type:
+            raw_scope = str(view.get("dataScope") or "").upper()
+            public_scope = scope_map.get(raw_scope)
+            if data_permission_type and (not raw_scope or public_scope):
                 entry["data_permission"] = {
                     "type": "config" if str(data_permission_type).upper() == "CONFIG" else "custom",
-                    "scope": scope_map.get(str(view.get("dataScope") or "").upper(), "all"),
+                    "scope": public_scope or "all",
                 }
             projected.append(entry)
         return {
@@ -23243,23 +23237,6 @@ def _apply_field_mutation(field: dict[str, Any], mutation: Any) -> None:
         field.pop("_question_rebuild_required", None)
 
 
-class AmbiguousFieldSelector(ValueError):
-    """name-only selector 命中多个同名字段。
-
-    方案 A(duplicate-field-name):后端以 queId 为字段身份、允许同父级同名;
-    name 命中多个字段时禁止静默取第一个,必须显式失败并给出候选 queId。
-    compiler 包装层(app_form)把它转写为 AMBIGUOUS_FIELD_SELECTOR 错误码。
-    """
-
-    def __init__(self, location: str, candidates: list[int]) -> None:
-        self.location = location
-        self.candidates = candidates
-        super().__init__(
-            f"{location} matches multiple fields with the same name; "
-            f"use queId to disambiguate (candidate queIds: {sorted(candidates)})"
-        )
-
-
 def _resolve_field_selector_with_uniqueness(
     *,
     fields: list[dict[str, Any]],
@@ -23275,12 +23252,7 @@ def _resolve_field_selector_with_uniqueness(
         name = str(selector.name or "").strip()
         matched = [field for field in fields if str(field.get("name") or "").strip() == name]
         if len(matched) > 1:
-            candidate_ids = [
-                ref
-                for candidate in matched
-                if (ref := _coerce_any_int(candidate.get("que_id"))) is not None
-            ]
-            raise AmbiguousFieldSelector(location, candidate_ids)
+            raise ValueError(f"{location} matched multiple fields with the same name; use field_id or que_id")
     else:
         matched = []
     if len(matched) != 1:
@@ -29960,14 +29932,6 @@ def _build_view_update_payload(
         payload["viewgraphType"] = "calendarView"
         payload["beingShowTitleQue"] = True
         payload.pop("groupQueId", None)
-    elif normalized_type == "hierarchy":
-        payload["viewgraphType"] = "hierarchyView"
-        payload["beingShowTitleQue"] = True
-        payload.pop("groupQueId", None)
-    elif normalized_type == "calendar":
-        payload["viewgraphType"] = "calendarView"
-        payload["beingShowTitleQue"] = True
-        payload.pop("groupQueId", None)
     return _hydrate_view_backend_payload(
         payload=payload,
         view_type=normalized_type,
@@ -30221,7 +30185,6 @@ _DATA_PERMISSION_SCOPE_MAP = {
     "all": "ALL",
     "oneself": "ONESELF",
     "dept": "DEPT",
-    "subordinate": "SUBORDINATE",
     "custom": "CUSTOM",
 }
 

package/src/qingflow_mcp/builder_facade/views_extract.py

@@ -34,7 +34,6 @@ _DATA_SCOPE_TO_PUBLIC = {
     "ALL": "all",
     "ONESELF": "oneself",
     "DEPT": "dept",
-    "SUBORDINATE": "subordinate",
     "CUSTOM": "custom",
 }
 
@@ -470,7 +469,18 @@ def extract_complete_view_declaration(
         declaration["filters"] = filters
 
     data_permission_type = str(view_info.get("dataPermissionType") or "").strip().upper()
-    data_scope = _DATA_SCOPE_TO_PUBLIC.get(str(view_info.get("dataScope") or "").strip().upper())
+    raw_scope = str(view_info.get("dataScope") or "").strip().upper()
+    if raw_scope and raw_scope not in _DATA_SCOPE_TO_PUBLIC:
+        gaps.append(
+            _gap(
+                "data_permission.scope",
+                "unsupported_data_scope",
+                "dataScope is outside the public view contract",
+                value_preview=raw_scope,
+            )
+        )
+        return {}, gaps
+    data_scope = _DATA_SCOPE_TO_PUBLIC.get(raw_scope)
     if data_permission_type or data_scope:
         declaration["data_permission"] = {
             "type": "config" if data_permission_type == "CONFIG" else "custom",

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

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import argparse
 
-from . import app, auth, builder, chart, data, exports, imports, portal, record, task, view, workspace
+from . import app, auth, builder, chart, exports, imports, portal, record, task, view, workspace
 
 
 def register_all_commands(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
@@ -13,7 +13,6 @@ def register_all_commands(subparsers: argparse._SubParsersAction[argparse.Argume
     view.register(subparsers)
     chart.register(subparsers)
     record.register(subparsers)
-    data.register(subparsers)
     imports.register(subparsers)
     exports.register(subparsers)
     task.register(subparsers)

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

@@ -9,7 +9,7 @@ from .common import load_list_arg, load_object_arg, raise_config_error, require_
 
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser("record", help="日志、附件、导入、代码块及 record 专项能力")
+    parser = subparsers.add_parser("record", help="记录与表结构")
     record_subparsers = parser.add_subparsers(
         dest="record_command",
         required=True,

package/src/qingflow_mcp/cli/context.py

@@ -11,7 +11,6 @@ from ..tools.ai_builder_tools import AiBuilderTools
 from ..tools.app_tools import AppTools
 from ..tools.auth_tools import AuthTools
 from ..tools.code_block_tools import CodeBlockTools
-from ..tools.data_tools import DataTools
 from ..tools.export_tools import ExportTools
 from ..tools.feedback_tools import FeedbackTools
 from ..tools.file_tools import FileTools
@@ -34,7 +33,6 @@ class CliContext:
     app: AppTools
     resource: ResourceReadTools
     record: RecordTools
-    data: DataTools
     code_block: CodeBlockTools
     imports: ImportTools
     exports: ExportTools
@@ -66,7 +64,6 @@ def build_cli_context() -> CliContext:
         app=AppTools(sessions, backend),
         resource=ResourceReadTools(sessions, backend),
         record=RecordTools(sessions, backend),
-        data=DataTools(sessions, backend),
         code_block=CodeBlockTools(sessions, backend),
         imports=ImportTools(sessions, backend),
         exports=ExportTools(sessions, backend),

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/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/response_trim.py

@@ -51,9 +51,8 @@ COMMON_ERROR_DROP_TOP = {
 
 SUCCESS_POLICY_BY_TOOL: dict[str, TransformFn] = {}
 
-#: 这些校验命令的产出契约明确包含 ok 字段（供阶段 2 SKILL.md 引用），
+#: 这两个校验命令的产出契约明确包含 ok 字段（供阶段 2 SKILL.md 引用），
 #: 需在 success 裁剪时保留 ok（默认 COMMON_SUCCESS_DROP_TOP 会丢弃 ok）。
-#: `builder:app_views_validate`（views 声明式校验）同属校验类工具，ok 同样进产出契约。
 _KEEP_OK_TOOLS = {
     "builder:app_form_validate_formula",
     "builder:app_form_validate_code_block",

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/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` 时直接执行目标业务命令；只有应用名称时先用 `app list --query` 查找并核对 `app_name/title`，目标明确且唯一时取其 `app_key`，否则请用户确认。不能把名称传给 `--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)。