@qingflow-tech/qingflow-cli 1.1.56 → 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": {
@@ -311,7 +311,8 @@
     "DataPermission": {
       "type": "object",
       "additionalProperties": false,
-      "dataPermissionDescription": "先选来源 type，再在 type=custom 时选 scope。默认且优先写 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
+      "required": ["type", "scope"],
+      "dataPermissionDescription": "写出本对象时 type 与 scope 都必填。优先写 custom + all。整段 data_permission 省略时，创建路径才按 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
       "properties": {
         "type": {
           "type": "string",
@@ -320,7 +321,7 @@
             "custom"
           ],
           "default": "custom",
-          "dataPermissionDescription": "数据权限来源，默认 custom。未声明时按 custom + all 创建。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
+          "dataPermissionDescription": "数据权限来源。写出 data_permission 时必填。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
           "x-backend": "dataPermissionType(CONFIG|CUSTOM)"
         },
         "scope": {
@@ -329,18 +330,45 @@
             "all",
             "oneself",
             "dept",
-            "subordinate",
             "custom"
           ],
           "default": "all",
-          "dataScopeDescription": "仅 type=custom 时生效，默认 all。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)"
         }
       }
     },
     "Visibility": {
       "type": "object",
       "additionalProperties": false,
+      "required": ["mode"],
+      "visibilityDescription": "写出 visibility 时 mode 必填。mode=specific 时必须带 selectors；selectors 各列表都不是单独必填，空对象表示指定范围但尚未配置成员。mode=everyone 时 external_mode 必须为 workspace。external_mode=specific 时必须带 external_selectors。整段省略时创建路径按 workspace + external_mode=not。",
+      "allOf": [
+        {
+          "if": {
+            "properties": { "mode": { "const": "specific" } },
+            "required": ["mode"]
+          },
+          "then": { "required": ["selectors"] }
+        },
+        {
+          "if": {
+            "properties": { "mode": { "const": "everyone" } },
+            "required": ["mode"]
+          },
+          "then": {
+            "required": ["external_mode"],
+            "properties": { "external_mode": { "const": "workspace" } }
+          }
+        },
+        {
+          "if": {
+            "properties": { "external_mode": { "const": "specific" } },
+            "required": ["external_mode"]
+          },
+          "then": { "required": ["external_selectors"] }
+        }
+      ],
       "properties": {
         "mode": {
           "type": "string",
@@ -373,6 +401,7 @@
     "VisibilitySelectors": {
       "type": "object",
       "additionalProperties": false,
+      "visibilitySelectorsDescription": "成员、部门、角色用不同列表表达，没有任何一个列表单独必填。mode=specific 时本对象本身必填；空对象是合法回读，表示指定范围但尚未配置成员。要真正授权时，至少填一个非空列表。",
       "properties": {
         "member_uids": {
           "type": "array",

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://qingflow.com/schemas/builder/views/v1alpha1/details/data-permission.json",
   "title": "Qingflow Views data permission configuration",
-  "dataPermissionDescription": "视图数据权限片段(schema_kind=data-permission)。默认且优先写 data_permission {type: custom, scope: all}。type 选来源，scope 只在 type=custom 时生效；filters 只在 type=custom 且 scope=custom 时作为数据范围。字段直接并入完整视图声明。",
+  "dataPermissionDescription": "视图数据权限片段(schema_kind=data-permission)。写出 data_permission 时 type 与 scope 都必填，优先 {type: custom, scope: all}。整段省略时创建路径才按 custom + all。type 选来源，scope 只在 type=custom 时生效；filters 只在 type=custom 且 scope=custom 时作为数据范围。字段直接并入完整视图声明。",
   "type": "object",
   "additionalProperties": false,
   "properties": {
@@ -36,16 +36,16 @@
       "fieldSchema": "字段类型、默认值等表单侧细节用 app_form_schema 传 schema_kind=field 和 field_type 获取(CLI: builder app-form schema --schema-kind field --field-type TYPE)。"
     }
   },
-  "x-qingflow-apply-semantics": "新建视图默认且应优先写 data_permission type=custom、scope=all。只有要跟随应用成员授权时才用 type=config，此时不要用 scope 表达范围。filters 仅在 type=custom 且 scope=custom 时作为数据范围；省略 filters 表示保留现有规则，空数组表示清空。",
+  "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

@@ -199,7 +199,8 @@
     "DataPermission": {
       "type": "object",
       "additionalProperties": false,
-      "dataPermissionDescription": "先选来源 type，再在 type=custom 时选 scope。默认且优先写 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
+      "required": ["type", "scope"],
+      "dataPermissionDescription": "写出本对象时 type 与 scope 都必填。优先写 custom + all。整段 data_permission 省略时，创建路径才按 custom + all。filters 只在 type=custom 且 scope=custom 时作为数据范围，不会叠在 config 或预设范围上。",
       "properties": {
         "type": {
           "type": "string",
@@ -208,7 +209,7 @@
             "custom"
           ],
           "default": "custom",
-          "dataPermissionDescription": "数据权限来源，默认 custom。未声明时按 custom + all 创建。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
+          "dataPermissionDescription": "数据权限来源。写出 data_permission 时必填。config=跟随应用成员授权的数据权限，本视图的 scope 与 filters 不参与查询。custom=使用本视图自己的数据范围(scope)。别名 dataPermissionType(CONFIG/CUSTOM)。",
           "x-backend": "viewgraph.dataPermissionType(CONFIG|CUSTOM)"
         },
         "scope": {
@@ -217,12 +218,11 @@
             "all",
             "oneself",
             "dept",
-            "subordinate",
             "custom"
           ],
           "default": "all",
-          "dataScopeDescription": "仅 type=custom 时生效，默认 all。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)