@qingflow-tech/qingflow-cli 1.1.47 → 1.1.48-beta.2

package/src/qingflow_mcp/builder_facade/service.py

@@ -19,6 +19,7 @@ from ..backend_client import BackendRequestContext
 from ..errors import QingflowApiError, backend_code_int, backend_code_value_int, is_auth_like_error
 from ..json_types import JSONObject
 from ..list_type_labels import RECORD_LIST_TYPE_LABELS, SYSTEM_VIEW_ID_TO_LIST_TYPE
+from ..resource_uri import validate_positive_resource_id, validate_resource_identity
 from ..solution.build_assembly_store import BuildAssemblyStore, default_artifacts, default_manifest
 from ..solution.compiler.chart_compiler import qingbi_workspace_visible_auth
 from ..solution.compiler.form_compiler import build_question, default_form_payload, default_member_auth
@@ -1491,6 +1492,74 @@ class AiBuilderFacade:
                 details={"solution_key": requested_solution_key},
                 suggested_next_call={"tool_name": "solution_install", "arguments": {"profile": profile, **normalized_args}},
             )
+        raw_result = created.get("result") if isinstance(created.get("result"), dict) else {}
+        raw_tag_ids = raw_result.get("tagIds")
+        raw_app_keys = raw_result.get("appKeys")
+        tag_ids, tag_ids_complete = _unique_resource_tag_ids(raw_tag_ids)
+        app_keys, app_keys_complete = _unique_resource_app_keys(raw_app_keys)
+        resource_list_complete = tag_ids_complete and app_keys_complete
+        resources: list[JSONObject] = []
+        warnings: list[JSONObject] = []
+
+        for tag_id in tag_ids:
+            name = None
+            try:
+                detail = self.packages.package_get(profile=profile, tag_id=tag_id, include_raw=False)
+                package = detail.get("result") if isinstance(detail.get("result"), dict) else {}
+                name = str(package.get("tagName") or package.get("tag_name") or "").strip() or None
+            except (QingflowApiError, RuntimeError):
+                pass
+            if not name:
+                warnings.append(_warning("RESOURCE_NAME_UNAVAILABLE", "installed package name could not be read", package_id=tag_id))
+            resources.append(
+                _compact_dict(
+                    {
+                        "resource_type": "package",
+                        "operation": "installed",
+                        "status": "success",
+                        "id": tag_id,
+                        "key": str(tag_id),
+                        "name": name,
+                        "ids": {"package_id": tag_id},
+                    }
+                )
+            )
+
+        for app_key in app_keys:
+            name = None
+            parent = None
+            try:
+                detail = self.apps.app_get_base(profile=profile, app_key=app_key, include_raw=False)
+                app = detail.get("result") if isinstance(detail.get("result"), dict) else {}
+                name = str(app.get("formTitle") or app.get("appName") or "").strip() or None
+                matching_tag_ids = [tag_id for tag_id in _unique_positive_ints(app.get("tagIds")) if tag_id in tag_ids]
+                if len(matching_tag_ids) == 1:
+                    parent = {"resource_type": "package", "id": matching_tag_ids[0], "key": str(matching_tag_ids[0])}
+            except (QingflowApiError, RuntimeError):
+                pass
+            if not name:
+                warnings.append(_warning("RESOURCE_NAME_UNAVAILABLE", "installed application name could not be read", app_key=app_key))
+            resources.append(
+                _compact_dict(
+                    {
+                        "resource_type": "app",
+                        "operation": "installed",
+                        "status": "success",
+                        "key": app_key,
+                        "name": name,
+                        "ids": {"app_key": app_key},
+                        "parent": parent,
+                    }
+                )
+            )
+
+        if not resource_list_complete:
+            warnings.append(
+                _warning(
+                    "RESOURCE_LIST_INCOMPLETE",
+                    "solution installation succeeded, but its returned package/application identity list was incomplete",
+                )
+            )
         return {
             "status": "success",
             "error_code": None,
@@ -1503,9 +1572,15 @@ class AiBuilderFacade:
             "request_id": created.get("request_id"),
             "suggested_next_call": None,
             "noop": False,
-            "verification": {},
+            "warnings": warnings,
+            "verified": False,
+            "verification": {
+                "resource_list_complete": resource_list_complete,
+                "business_verified": False,
+            },
             "write_executed": True,
             "safe_to_retry": False,
+            "resources": resources,
         }
 
     def package_list(self, *, profile: str, trial_status: str = "all", query: str = "") -> JSONObject:
@@ -17148,6 +17223,49 @@ def _coerce_positive_int(value: Any) -> int | None:
     return None
 
 
+def _unique_positive_ints(value: Any) -> list[int]:
+    if not isinstance(value, list):
+        return []
+    result: list[int] = []
+    for item in value:
+        number = _coerce_positive_int(item)
+        if number is not None and number not in result:
+            result.append(number)
+    return result
+
+
+def _unique_resource_tag_ids(value: Any) -> tuple[list[int], bool]:
+    if not isinstance(value, list):
+        return [], False
+    result: list[int] = []
+    complete = True
+    for item in value:
+        try:
+            tag_id = validate_positive_resource_id(item, "package_id")
+        except (ValueError, UnicodeError):
+            complete = False
+            continue
+        if tag_id not in result:
+            result.append(tag_id)
+    return result, complete
+
+
+def _unique_resource_app_keys(value: Any) -> tuple[list[str], bool]:
+    if not isinstance(value, list):
+        return [], False
+    result: list[str] = []
+    complete = True
+    for item in value:
+        try:
+            app_key = validate_resource_identity(item, "app_key")
+        except (ValueError, UnicodeError):
+            complete = False
+            continue
+        if app_key not in result:
+            result.append(app_key)
+    return result, complete
+
+
 def _coerce_nonnegative_int(value: Any) -> int | None:
     if isinstance(value, bool) or value is None:
         return None

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

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

@@ -40,11 +40,19 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     whoami = auth_subparsers.add_parser("whoami", help="查看当前登录态")
     whoami.set_defaults(handler=_handle_whoami, format_hint="auth_whoami")
 
+    login_link = auth_subparsers.add_parser("login-link", help="生成当前工作区的临时一次性登录链接（不自动打开）")
+    login_link.add_argument("--redirect-path", default="", help="登录后跳转的站内路径；资源路径必须属于当前工作区，其他业务路径可包含查询参数和锚点")
+    login_link.set_defaults(handler=_handle_login_link, format_hint="login_link")
+
     logout = auth_subparsers.add_parser("logout", help="退出登录")
     logout.add_argument("--forget-persisted", action="store_true")
     logout.set_defaults(handler=_handle_logout, format_hint="")
 
 
+def _handle_login_link(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.login_link.get_login_link(profile=args.profile, redirect_path=args.redirect_path)
+
+
 def _handle_login(args: argparse.Namespace, context: CliContext) -> dict:
     if args.method == "oauth":
         return _handle_oauth_login(args, context)

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

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

package/src/qingflow_mcp/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="记录与表结构")
+    parser = subparsers.add_parser("record", help="日志、附件、导入、代码块及 record 专项能力")
     record_subparsers = parser.add_subparsers(
         dest="record_command",
         required=True,

package/src/qingflow_mcp/cli/context.py

@@ -11,10 +11,12 @@ 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
 from ..tools.import_tools import ImportTools
+from ..tools.login_link_tools import LoginLinkTools
 from ..tools.record_tools import RecordTools
 from ..tools.resource_read_tools import ResourceReadTools
 from ..tools.task_context_tools import TaskContextTools
@@ -27,10 +29,12 @@ class CliContext:
     sessions: CliSessionFacade
     backend: BackendClient
     auth: AuthTools
+    login_link: LoginLinkTools
     workspace: WorkspaceTools
     app: AppTools
     resource: ResourceReadTools
     record: RecordTools
+    data: DataTools
     code_block: CodeBlockTools
     imports: ImportTools
     exports: ExportTools
@@ -57,10 +61,12 @@ def build_cli_context() -> CliContext:
         sessions=sessions,
         backend=backend,
         auth=AuthTools(sessions, backend),
+        login_link=LoginLinkTools(sessions, backend),
         workspace=WorkspaceTools(sessions, backend),
         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,7 +8,10 @@ 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 _is_failed_result(result) and hint != "task_action_execute":
+        if hint in _DATA_FORMAT_HINTS:
+            # 数据面失败也必须保留 field_errors 与列表型 hints，不能先走通用失败裁剪。
+            text = _format_data_result(result)
+        elif _is_failed_result(result) and hint != "task_action_execute":
             text = _format_failed_result(result)
         else:
             formatter = _FORMATTERS.get(hint, _format_generic)
@@ -90,6 +93,92 @@ 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 '-'})",
@@ -191,9 +280,10 @@ def _format_app_items(result: dict[str, Any]) -> str:
                 str(item.get("app_key") or item.get("appKey") or ""),
                 str(item.get("app_name") or item.get("name") or item.get("title") or ""),
                 str(item.get("package_name") or item.get("tag_name") or ""),
+                str(item.get("uri") or ""),
             ]
         )
-    return _render_titled_table("Apps", ["app_key", "app_name", "package"], rows)
+    return _render_titled_table("Apps", ["app_key", "app_name", "package", "uri"], rows)
 
 
 def _format_app_get(result: dict[str, Any]) -> str:
@@ -201,6 +291,7 @@ def _format_app_get(result: dict[str, Any]) -> str:
     lines = [
         f"App: {data.get('app_name') or '-'}",
         f"App Key: {data.get('app_key') or '-'}",
+        f"URI: {data.get('uri') or '-'}",
         f"Can Create: {data.get('can_create')}",
     ]
     import_capability = data.get("import_capability")
@@ -224,7 +315,7 @@ def _format_app_get(result: dict[str, Any]) -> str:
     lines.append(f"Accessible Views: {len(views)}")
     for item in views[:10]:
         if isinstance(item, dict):
-            lines.append(f"- {item.get('view_id')}: {item.get('name')}")
+            lines.append(f"- {item.get('view_id')}: {item.get('name')} / {item.get('uri') or '-'}")
     _append_warnings(lines, result.get("warnings"))
     return "\n".join(lines) + "\n"
 
@@ -296,6 +387,7 @@ def _format_view_get(result: dict[str, Any]) -> str:
         f"View Key: {data.get('view_key') or '-'}",
         f"App Key: {data.get('app_key') or '-'}",
         f"View Type: {data.get('view_type') or '-'}",
+        f"URI: {data.get('uri') or '-'}",
         f"Analysis Supported: {data.get('analysis_supported')}",
     ]
     if export_capability:
@@ -1184,6 +1276,7 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
         ("view_key", "View Key"),
         ("chart_id", "Chart ID"),
         ("package_id", "Package ID"),
+        ("uri", "URI"),
         ("verified", "Verified"),
         ("write_executed", "Write Executed"),
         ("delete_executed", "Delete Executed"),
@@ -1216,6 +1309,7 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
         "associations",
         "package_ids",
         "app_keys",
+        "resources",
     ):
         value = result.get(key)
         if not isinstance(value, list) and isinstance(data, dict):
@@ -1226,6 +1320,15 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
                 lines.append("- " + _builder_item_summary(item))
             if len(value) > 8:
                 lines.append(f"... {len(value) - 8} more")
+            if key == "apps":
+                uri_lines = [
+                    line
+                    for item in value
+                    for line in _builder_batch_item_uri_lines(item)
+                ]
+                if uri_lines:
+                    lines.append("Resource URIs:")
+                    lines.extend(f"- {line}" for line in uri_lines)
     components = result.get("components") if isinstance(result.get("components"), list) else []
     if components:
         lines.append("Component Refs:")
@@ -1294,6 +1397,7 @@ def _builder_item_summary(item: Any) -> str:
         "uid",
         "userId",
         "email",
+        "uri",
     )
     parts = [
         f"{key}={item.get(key)}"
@@ -1305,6 +1409,50 @@ def _builder_item_summary(item: Any) -> str:
     return " / ".join(parts) if parts else json.dumps(item, ensure_ascii=False)
 
 
+def _builder_batch_item_uri_lines(item: Any) -> list[str]:
+    if not isinstance(item, dict):
+        return []
+    item_status = str(item.get("status") or "").lower()
+    if item_status not in {"success", "partial_success"}:
+        return []
+    data = item.get("data") if isinstance(item.get("data"), dict) else item.get("result")
+    if not isinstance(data, dict) or not _builder_uri_is_confirmed(data, fallback_status=item_status):
+        return []
+    lines: list[str] = []
+    if data.get("uri"):
+        lines.append(f"URI: {data['uri']}")
+    views = data.get("views") if isinstance(data.get("views"), list) else []
+    for view in views:
+        if (
+            isinstance(view, dict)
+            and view.get("uri")
+            and _builder_uri_is_confirmed(view, fallback_status=item_status)
+        ):
+            lines.append(f"View URI: {view['uri']}")
+    return lines
+
+
+def _builder_uri_is_confirmed(value: dict[str, Any], *, fallback_status: str) -> bool:
+    status = str(value.get("status") or fallback_status).lower()
+    operation = str(value.get("operation") or "").lower()
+    return (
+        status in {"success", "partial_success", "unchanged", "verified"}
+        and operation
+        not in {
+            "failed",
+            "pending",
+            "planned",
+            "readback_pending",
+            "pending_readback",
+            "unknown",
+            "remove",
+            "removed",
+            "delete",
+            "deleted",
+        }
+    )
+
+
 def _format_file_upload_local(result: dict[str, Any]) -> str:
     lines = [
         f"Upload Kind: {result.get('upload_kind') or result.get('requested_upload_kind') or '-'}",
@@ -1566,7 +1714,12 @@ def _task_action_debug_lines(result: dict[str, Any]) -> list[str]:
     return lines
 
 
+def _format_login_link(result: dict[str, Any]) -> str:
+    return f"登录链接：{result['url']}\n过期时间（Unix 毫秒）：{result['expires_at']}\n链接只能使用一次，请勿泄露；仅在用户要求打开时才打开。\n"
+
+
 _FORMATTERS = {
+    "login_link": _format_login_link,
     "auth_whoami": _format_whoami,
     "workspace_list": _format_workspace_list,
     "workspace_get": _format_workspace_get,
@@ -1604,4 +1757,11 @@ _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/cli/main.py

@@ -2,11 +2,13 @@ from __future__ import annotations
 
 import argparse
 import json
+import os
 import sys
 from typing import Any, Callable, TextIO
 
 from ..errors import QingflowApiError, backend_code_value_int, message_looks_like_invalid_token
 from ..public_surface import cli_public_tool_spec_from_namespace
+from ..resource_uri import cli_resource_base_url
 from ..response_trim import resolve_cli_tool_name, trim_error_response, trim_public_response
 from ..tools.ai_builder_tools import _attach_builder_apply_envelope
 from ..version import get_cli_version, get_cli_version_info
@@ -94,7 +96,8 @@ def run(
         context = context_factory()
         if not bool(args.json):
             _emit_cli_effective_context_notice(args, context, stream=err)
-        result = handler(args, context)
+        with cli_resource_base_url(os.getenv("QINGFLOW_BASE_URL") or ""):
+            result = handler(args, context)
     except SystemExit as exc:
         return int(exc.code or 0)
     except RuntimeError as exc: