@qingflow-tech/qingflow-cli 1.1.50-beta.5 → 1.1.51

package/src/qingflow_mcp/builder_facade/workflow_spec.py

@@ -13,7 +13,7 @@ WORKFLOW_SPEC_APPLY_PATH = "/api/workflow/spec:apply"
 # 若后端实际路径有出入，只需改这里的两个常量。
 WORKFLOW_SPEC_VERSIONS_PATH = "/api/workflow/spec/versions"
 WORKFLOW_SPEC_RESTORE_PATH = "/api/workflow/spec:restore"
-DEFAULT_SCHEMA_VERSION = "vnext-2026-06"
+DEFAULT_SCHEMA_VERSION = "vnext-2026-09"
 
 
 def fetch_schema(

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

@@ -4,30 +4,24 @@ import argparse
 from copy import deepcopy
 from pathlib import Path
 
+from ..context import CliContext
 from ...app_form_validator import (
     AppFormValidationError,
     build_encoded_id_map,
+    referenced_formula_field_ids,
+    translate_formula_test_case_values,
     encode_code_block_field_ids,
     referenced_code_block_field_ids,
-    referenced_formula_field_ids,
     restore_decimal_ids_in_text,
     strip_placeholder_quotes,
-    translate_formula_test_case_values,
     translate_select_test_case_values,
     validate_code_block_static,
     validate_declaration,
     validate_formula_expression,
 )
-from ...builder_facade.views_schema import VIEWS_SUPPORTED_SCHEMA_KINDS
-from ..context import CliContext
 from ..json_io import load_json_value
-from .common import (
-    load_list_arg,
-    load_object_arg,
-    parse_bool_text,
-    raise_config_error,
-    require_list_arg,
-)
+from .common import load_list_arg, load_object_arg, parse_bool_text, raise_config_error, require_list_arg
+
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
     parser = subparsers.add_parser("builder", aliases=["build"], help="稳定 builder 命令")
@@ -225,7 +219,6 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     button_get.add_argument("--app-key", default="")
     button_get.add_argument("--app-keys", default="", help="逗号分隔的多应用 app_key；用于批量读取按钮配置")
     button_get.add_argument("--app-keys-file", help="JSON 字符串数组；用于批量读取按钮配置")
-    button_get.add_argument("--button-text", default="", help="按按钮文案精确查重；命中复用其 button_id，未命中再创建")
     button_get.set_defaults(handler=_handle_button_get, format_hint="builder_summary")
 
     button_apply = button_subparsers.add_parser("apply", help="声明式创建、更新或删除自定义按钮")
@@ -289,32 +282,14 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     views_apply = builder_subparsers.add_parser("views", help="视图")
     views_apply_subparsers = views_apply.add_subparsers(dest="builder_views_command", required=True)
-    views_schema = views_apply_subparsers.add_parser("schema", help="读取视图声明 Schema")
-    views_schema.add_argument("--schema-version")
-    views_schema.add_argument(
-        "--schema-kind",
-        choices=VIEWS_SUPPORTED_SCHEMA_KINDS,
-    )
-    views_schema.set_defaults(handler=_handle_views_schema, format_hint="builder_summary", force_json_output=True)
-
-    views_get = views_apply_subparsers.add_parser("get", help="读取 canonical 视图声明")
-    views_get.add_argument("--app-key", required=True)
-    views_get.add_argument("--schema-version")
-    views_get.add_argument("--schema-kind", choices=("summary", "complete"), help="summary＝投影字段；complete＝逐视图读 viewConfig 反向编译（含覆盖度 gaps）")
-    views_get.set_defaults(handler=_handle_views_get, format_hint="builder_summary", force_json_output=True)
-
-    views_validate = views_apply_subparsers.add_parser("validate", help="只校验视图声明，不访问后端")
-    views_validate.add_argument("--file", required=True, help="视图声明 JSON 文件，- 表示 stdin")
-    views_validate.add_argument("--schema-version", help="固定使用的视图 Schema 版本；缺省读文件内 schema_version，再缺省 latest")
-    views_validate.set_defaults(handler=_handle_views_validate, format_hint="builder_summary", force_json_output=True)
-
     views_apply_apply = views_apply_subparsers.add_parser("apply", help="执行视图变更")
-    views_apply_apply.add_argument("--app-key", required=True)
+    views_apply_apply.add_argument("--app-key", default="")
+    views_apply_apply.add_argument("--views-file", help='推荐批量视图 JSON 对象：{"views":[...]}；每项包含 app_key、operation、视图配置')
+    views_apply_apply.add_argument("--apps-file", help="多应用视图 JSON 数组；每项包含 app_key 和 upsert/patch/remove payload")
     views_apply_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
-    views_apply_apply.add_argument("--view-file", help="单条新建或完整更新视图的 JSON 对象")
+    views_apply_apply.add_argument("--upsert-views-file")
     views_apply_apply.add_argument("--patch-views-file")
     views_apply_apply.add_argument("--remove-views-file")
-    views_apply_apply.add_argument("--schema-version", help="声明使用的 Schema 版本；缺省 latest，信封回显 schemaVersion")
     views_apply_apply.set_defaults(handler=_handle_views_apply, format_hint="builder_summary", force_json_output=True)
 
     flow_apply = builder_subparsers.add_parser("flow", help="流程")
@@ -899,13 +874,12 @@ def _handle_associated_resource_apply(args: argparse.Namespace, context: CliCont
 
 
 def _handle_button_get(args: argparse.Namespace, context: CliContext) -> dict:
-    button_text = str(getattr(args, "button_text", "") or "").strip() or None
     app_keys = _app_keys_from_args(args)
     if app_keys is not None:
-        return context.builder.app_get_buttons(profile=args.profile, app_key="", app_keys=app_keys, button_text=button_text)
+        return context.builder.app_get_buttons(profile=args.profile, app_key="", app_keys=app_keys)
     if not (args.app_key or "").strip():
         raise_config_error("builder button get requires --app-key unless --app-keys or --app-keys-file is provided")
-    return context.builder.app_get_buttons(profile=args.profile, app_key=args.app_key, button_text=button_text)
+    return context.builder.app_get_buttons(profile=args.profile, app_key=args.app_key)
 
 
 def _handle_associated_resource_get(args: argparse.Namespace, context: CliContext) -> dict:
@@ -1213,6 +1187,30 @@ def _coerce_apps_file_bool(value: object, *, field_name: str, default: bool) ->
     )
 
 
+def _load_views_file_arg(path: str | None) -> list[object] | None:
+    if not path:
+        return None
+    payload = load_json_value(path, option_name="--views-file")
+    if isinstance(payload, dict):
+        views = payload.get("views")
+        if not isinstance(views, list):
+            raise_config_error(
+                "--views-file JSON object must contain a views array.",
+                fix_hint='Use {"views": [{"operation": "upsert", "app_key": "...", "name": "...", "type": "table", "columns": [...]}]}.',
+                error_code="VIEWS_FILE_SHAPE_INVALID",
+                details={"expected": '{"views": [...]}', "actual_type": type(views).__name__},
+            )
+        return views
+    if isinstance(payload, list):
+        return payload
+    raise_config_error(
+        "--views-file must be a JSON object with views[] or a JSON array.",
+        fix_hint='Prefer {"views": [...]} for new automation. A bare array is accepted only for compatibility.',
+        error_code="VIEWS_FILE_SHAPE_INVALID",
+        details={"actual_type": type(payload).__name__},
+    )
+
+
 def _handle_layout_apply(args: argparse.Namespace, context: CliContext) -> dict:
     apps = load_list_arg(args.apps_file, option_name="--apps-file") if getattr(args, "apps_file", None) else None
     if apps is None and not (args.app_key or "").strip():
@@ -1237,53 +1235,34 @@ def _handle_layout_apply(args: argparse.Namespace, context: CliContext) -> dict:
     )
 
 
-def _handle_views_schema(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_views_schema(
-        schema_version=args.schema_version,
-        schema_kind=args.schema_kind,
-    )
-
-
-def _handle_views_get(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_views_get(
-        profile=args.profile,
-        app_key=args.app_key,
-        schema_version=args.schema_version,
-        schema_kind=getattr(args, "schema_kind", None) or "summary",
-    )
-
-
-def _handle_views_validate(args: argparse.Namespace, context: CliContext) -> dict:
-    payload = load_json_value(
-        args.file,
-        option_name="--file",
-        max_bytes=2 * 1024 * 1024,
-        max_depth=64,
-    )
-    if not isinstance(payload, dict):
-        raise_config_error("builder views validate --file must contain a JSON object")
-    return context.builder.app_views_validate(
-        declaration=payload,
-        schema_version=args.schema_version,
-    )
-
-
 def _handle_views_apply(args: argparse.Namespace, context: CliContext) -> dict:
-    view = load_object_arg(args.view_file, option_name="--view-file") if getattr(args, "view_file", None) else None
-    if view is None and not (getattr(args, "patch_views_file", None) or getattr(args, "remove_views_file", None)):
-        raise_config_error(
-            "builder views apply requires --view-file, --patch-views-file, or --remove-views-file.",
-            fix_hint="Pass one JSON object through --view-file to create or fully update one view.",
-            error_code="ARGUMENT_ERROR",
+    views = _load_views_file_arg(args.views_file) if getattr(args, "views_file", None) else None
+    apps = load_list_arg(args.apps_file, option_name="--apps-file") if getattr(args, "apps_file", None) else None
+    if views is not None:
+        if apps is not None or (args.app_key or "").strip() or getattr(args, "upsert_views_file", None) or getattr(args, "patch_views_file", None) or getattr(args, "remove_views_file", None):
+            raise_config_error(
+                "builder views apply --views-file cannot be mixed with --app-key, --apps-file, --upsert-views-file, --patch-views-file, or --remove-views-file.",
+                fix_hint="Use one shape: preferred --views-file for flat batch jobs, or legacy --app-key/--apps-file for grouped payloads.",
+            )
+        return context.builder.app_views_apply(
+            profile=args.profile,
+            app_key="",
+            publish=bool(args.publish),
+            upsert_views=[],
+            patch_views=[],
+            remove_views=[],
+            views=views,
         )
+    if apps is None and not (args.app_key or "").strip():
+        raise_config_error("builder views apply requires --views-file, --apps-file, or --app-key")
     return context.builder.app_views_apply(
         profile=args.profile,
         app_key=args.app_key,
         publish=bool(args.publish),
-        upsert_view=view,
+        upsert_views=load_list_arg(args.upsert_views_file, option_name="--upsert-views-file"),
         patch_views=load_list_arg(args.patch_views_file, option_name="--patch-views-file"),
         remove_views=load_list_arg(args.remove_views_file, option_name="--remove-views-file"),
-        schema_version=getattr(args, "schema_version", None),
+        apps=apps,
     )
 
 

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/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),
@@ -178,9 +173,6 @@ BUILDER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_list_versions", ("app_flow_list_versions",), ("builder", "flow", "versions"), has_contract=True, cli_show_effective_context=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_restore_version", ("app_flow_restore_version",), ("builder", "flow", "restore"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_apply", ("app_flow_apply",), ("builder", "flow", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_views_schema", ("app_views_schema",), ("builder", "views", "schema")),
-    PublicToolSpec(BUILDER_DOMAIN, "app_views_get", ("app_views_get",), ("builder", "views", "get"), cli_show_effective_context=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_views_validate", (), ("builder", "views", "validate"), mcp_public=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_views_apply", ("app_views_apply",), ("builder", "views", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_charts_apply", ("app_charts_apply",), ("builder", "charts", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "portal_apply", ("portal_apply",), ("builder", "portal", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),

package/src/qingflow_mcp/response_trim.py

@@ -51,15 +51,9 @@ 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",
-    "builder:app_flow_validate",
-    "builder:app_views_validate",
-}
+_KEEP_OK_TOOLS = {"builder:app_form_validate_formula", "builder:app_form_validate_code_block", "builder:app_flow_validate"}
 
 
 def trim_public_response(tool_name: str | None, payload: dict[str, Any]) -> dict[str, Any]:
@@ -1316,9 +1310,6 @@ _register_policy(
         "app_flow_validate",
         "app_flow_list_versions",
         "app_flow_restore_version",
-        "app_views_schema",
-        "app_views_get",
-        "app_views_validate",
         "app_get_charts",
         "app_get_buttons",
         "app_get_associated_resources",

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_builder.py

@@ -56,8 +56,8 @@ def build_builder_server() -> FastMCP:
             "For builder delete/remove apply results, separate delete execution from readback verification: after DELETE is sent, resources expose delete_executed, readback_status, and safe_to_retry_delete=false. If readback_status is unavailable or still_exists, do not blindly repeat the delete; confirm later with app_get/view_get/chart_get or the relevant apply readback. Views/buttons use single-item readback; associated resources use one app-level resource-pool readback because there is no confirmed single-item GET. "
             "For builder write/apply results, separate write execution from final readback verification: status=partial_success with write_executed=true and safe_to_retry=false means the write was sent or succeeded, while final readback, publish verification, or metadata confirmation is pending or permission-restricted. Report it as written but unverified; do not repeat the same write blindly. "
             "For app_form_apply, pin the version from app_form_schema, preserve the complete body and existing IDs from a draft get, and configure data display through app-level spec.dataTitleField/spec.dataCoverField selectors rather than booleans on fields; App Builder MCP validates the declaration inside app_form_apply, while the CLI route has a separate static validate command. dataTitleField must resolve to exactly one top-level field for a non-empty body, while dataCoverField is optional and must resolve to a top-level attachment field. A root appKey means update and may include packageId; no appKey means create and requires packageId plus spec.appName. AppForm does not accept spec.icon or spec.color; creation derives a stable default icon and color from spec.appName. "
-            "For app_views_apply, keep fixed saved filters in filters and configure the frontend query panel separately with query_conditions; query_conditions.rows accepts field names, field IDs, or queIds and compiles them to backend queryCondition queIds, with queIds preferred. New views default associated report/view display to visible with limit_type=all; existing views preserve their current associated display unless associated_resources is explicitly patched. View writes use ViewManagementAuth (beingViewManageStatus), falling back to DataManageAuth when advanced app permissions are not enabled. "
-            "For ordinary business buttons, declare them on a new or full view with app_views_apply.upsert_view.action_buttons; app_views_apply writes the view first, then creates/binds the button. For an existing view, use patch_views[].set.action_buttons. Use app_custom_buttons_apply only when the user explicitly asks to maintain existing standalone buttons outside view design, such as custom style/icon changes, cross-view reuse, deleting button bodies, bulk binding reorder, or exact qRobot/wings config. Button body writes require EditAppAuth; view_configs placement writes require ViewManagementAuth, matching the backend viewConfig route. For addData buttons, prefer action_buttons.target_app_key + field_mappings/default_values on the view path; do not ask agents to write raw que_relation unless maintaining a legacy config. field_mappings.source_field accepts source schema fields and supported system fields: 数据ID/row_record_id/apply_id/_id means current record id (-17), 编号/record_number means visible record number (0). To fill a target relation with the current record, map {'source_field': '数据ID', 'target_field': '目标引用字段'}; default_values is only for static constants. View button bindings merge by default; standalone view_configs are only for explicit maintenance. Builder view_key arguments are raw keys from app_get.views[].view_key and must not be prefixed with custom:. "
+            "For app_views_apply, keep fixed saved filters in filters and configure the frontend query panel separately with query_conditions; query_conditions.rows is a matrix of field names compiled to backend queryCondition queIds. New views default associated report/view display to visible with limit_type=all; existing views preserve their current associated display unless associated_resources is explicitly patched. View writes use ViewManagementAuth (beingViewManageStatus), falling back to DataManageAuth when advanced app permissions are not enabled. "
+            "For ordinary business buttons, declare them on the target view with app_views_apply.views[].action_buttons; app_views_apply writes the view first, then creates/binds the button. Use app_custom_buttons_apply only when the user explicitly asks to maintain existing standalone buttons outside view design, such as custom style/icon changes, cross-view reuse, deleting button bodies, bulk binding reorder, or exact qRobot/wings config. Button body writes require EditAppAuth; view_configs placement writes require ViewManagementAuth, matching the backend viewConfig route. For addData buttons, prefer action_buttons.target_app_key + field_mappings/default_values on the view path; do not ask agents to write raw que_relation unless maintaining a legacy config. field_mappings.source_field accepts source schema fields and supported system fields: 数据ID/row_record_id/apply_id/_id means current record id (-17), 编号/record_number means visible record number (0). To fill a target relation with the current record, map {'source_field': '数据ID', 'target_field': '目标引用字段'}; default_values is only for static constants. View button bindings merge by default; standalone view_configs are only for explicit maintenance. Builder view_key arguments are raw keys from app_get.views[].view_key and must not be prefixed with custom:. "
             "For BI reports, keep report-body development separate from Qingflow in-app display: use app_charts_apply to create, update, remove, or reorder app-source QingBI chart bodies/configs with dataSourceType=qingflow; chart dimension/metric/filter/query fields must come from app_get_fields.chart_fields, not record schema or form-only fields; dataset BI reports are not created or edited by app_charts_apply yet and should be created in QingBI first, then attached with app_associated_resources_apply using report_source=dataset. "
             "For associated views/reports, use app_associated_resources_apply. Use match_mappings for filtering associated resources: dynamic current-record conditions use source_field, static conditions use value. match_mappings also supports 数据ID(-17) and 编号(0). Do not ask agents to write raw match_rules unless preserving a legacy backend config. "
             "For associated reports/views, use app_associated_resources_apply for both the app-level associated_resources pool and per-view display config; associated_item_id is the app-level form_asos_chart.id, and view_configs/remove/reorder may also pass an existing resource's chart_id/chart_key/view_key because the tool resolves those to the internal id. Before creating an associated resource, read app_get.associated_resources and reuse an existing matching target_app_key + view_key/chart_key through patch_resources; client_key only works inside one apply call and is not persisted. Do not ask agents to pass backend raw sourceType: views infer the internal Qingflow view source, reports default to BI app reports, and dataset reports use report_source=dataset. "
@@ -231,32 +231,6 @@ def build_builder_server() -> FastMCP:
     ) -> dict:
         return ai_builder.app_form_apply(profile=profile, spec=spec or {})
 
-    @server.tool()
-    def app_views_schema(
-        schema_version: str | None = None,
-        schema_kind: str | None = None,
-    ) -> dict:
-        """Get a complete views schema or a focused detail schema such as display or button-config."""
-        return ai_builder.app_views_schema(schema_version=schema_version, schema_kind=schema_kind)
-
-    @server.tool()
-    def app_views_get(
-        profile: str = DEFAULT_PROFILE,
-        app_key: str = "",
-        schema_version: str | None = None,
-        schema_kind: str | None = None,
-    ) -> dict:
-        return ai_builder.app_views_get(
-            profile=profile, app_key=app_key, schema_version=schema_version, schema_kind=schema_kind
-        )
-
-    @server.tool()
-    def app_views_validate(
-        declaration: dict | None = None,
-        schema_version: str | None = None,
-    ) -> dict:
-        return ai_builder.app_views_validate(declaration=declaration or {}, schema_version=schema_version)
-
     @server.tool(description=ai_builder._high_risk_tool_description(operation="delete", target="app configuration"))
     def app_delete(
         profile: str = DEFAULT_PROFILE,
@@ -471,8 +445,8 @@ def build_builder_server() -> FastMCP:
         return ai_builder.app_get_charts(profile=profile, app_key=app_key, app_keys=app_keys)
 
     @server.tool()
-    def app_get_buttons(profile: str = DEFAULT_PROFILE, app_key: str = "", app_keys: list[str] | None = None, button_text: str | None = None) -> dict:
-        return ai_builder.app_get_buttons(profile=profile, app_key=app_key, app_keys=app_keys, button_text=button_text)
+    def app_get_buttons(profile: str = DEFAULT_PROFILE, app_key: str = "", app_keys: list[str] | None = None) -> dict:
+        return ai_builder.app_get_buttons(profile=profile, app_key=app_key, app_keys=app_keys)
 
     @server.tool()
     def app_get_associated_resources(profile: str = DEFAULT_PROFILE, app_key: str = "", app_keys: list[str] | None = None) -> dict:
@@ -572,19 +546,21 @@ def build_builder_server() -> FastMCP:
         profile: str = DEFAULT_PROFILE,
         app_key: str = "",
         publish: bool = True,
-        upsert_view: dict | None = None,
+        upsert_views: list[dict] | None = None,
         patch_views: list[dict] | None = None,
         remove_views: list[str] | None = None,
-        schema_version: str | None = None,
+        apps: list[dict] | None = None,
+        views: list[dict] | None = None,
     ) -> dict:
         return ai_builder.app_views_apply(
             profile=profile,
             app_key=app_key,
             publish=publish,
-            upsert_view=upsert_view,
+            upsert_views=upsert_views or [],
             patch_views=patch_views or [],
             remove_views=remove_views or [],
-            schema_version=schema_version,
+            apps=apps,
+            views=views,
         )
 
     @server.tool()

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/solution/compiler/view_compiler.py

@@ -12,7 +12,6 @@ VIEW_TYPE_MAP = {
     ViewType.board: "boardView",
     ViewType.gantt: "ganttView",
     ViewType.hierarchy: "hierarchyView",
-    ViewType.calendar: "calendarView",
 }
 
 
@@ -33,7 +32,7 @@ def compile_views(entity: EntitySpec) -> list[dict[str, Any]]:
                     "viewgraphQueIds": list(view.field_ids),
                     "viewgraphQuestions": [],
                     "ordinal": ordinal,
-                    "beingShowTitleQue": view.type in (ViewType.card, ViewType.board, ViewType.gantt, ViewType.hierarchy, ViewType.calendar),
+                    "beingShowTitleQue": view.type in (ViewType.card, ViewType.board, ViewType.gantt, ViewType.hierarchy),
                     "beingShowCover": False,
                     "viewgraphLimitType": 1,
                     "viewgraphLimit": view.filters,