@qingflow-tech/qingflow-app-user-mcp 1.0.2 → 1.0.4

package/src/qingflow_mcp/cli/formatters.py

@@ -1,17 +1,26 @@
 from __future__ import annotations
 
 import json
+import textwrap
 from typing import Any, TextIO
 
 
 def emit_text_result(result: dict[str, Any], *, hint: str, stream: TextIO) -> None:
-    formatter = _FORMATTERS.get(hint, _format_generic)
-    text = formatter(result)
+    text = _format_cancelled_result(result)
+    if text is None:
+        formatter = _FORMATTERS.get(hint, _format_generic)
+        text = formatter(result)
     stream.write(text)
     if not text.endswith("\n"):
         stream.write("\n")
 
 
+def _format_cancelled_result(result: dict[str, Any]) -> str | None:
+    if str(result.get("status") or "").lower() != "cancelled":
+        return None
+    return str(result.get("message") or "已取消") + "\n"
+
+
 def _format_generic(result: dict[str, Any]) -> str:
     lines: list[str] = []
     title = _first_present(result, "status", "message")
@@ -38,8 +47,19 @@ def _format_whoami(result: dict[str, Any]) -> str:
         f"User: {result.get('nick_name') or '-'} ({result.get('email') or '-'})",
         f"UID: {result.get('uid')}",
         f"Workspace: {result.get('selected_ws_name') or '-'} ({result.get('selected_ws_id') or '-'})",
-        f"QF Version: {result.get('qf_version') or '-'}",
+        f"Workspace QF Version: {result.get('qf_version') or '-'}",
     ]
+    cli_auth = result.get("cli_auth") if isinstance(result.get("cli_auth"), dict) else {}
+    if cli_auth:
+        lines.append(f"Login Flow: {cli_auth.get('flow') or '-'}")
+        if cli_auth.get("verification_uri"):
+            lines.append(f"Verification URL: {cli_auth.get('verification_uri')}")
+        if cli_auth.get("user_code"):
+            lines.append(f"User Code: {cli_auth.get('user_code')}")
+    request_route = result.get("request_route") if isinstance(result.get("request_route"), dict) else {}
+    route_qf_version = request_route.get("qf_version")
+    if route_qf_version and route_qf_version != result.get("qf_version"):
+        lines.append(f"Request Route QF Version: {route_qf_version}")
     lines.append(f"Permission Level: {result.get('permission_level') or '-'}")
     departments = result.get("departments") if isinstance(result.get("departments"), list) else []
     roles = result.get("roles") if isinstance(result.get("roles"), list) else []
@@ -82,6 +102,34 @@ def _format_workspace_list(result: dict[str, Any]) -> str:
     return _render_titled_table("Workspaces", ["ws_id", "name", "remark"], rows)
 
 
+def _format_workspace_get(result: dict[str, Any]) -> str:
+    workspace = result.get("workspace") if isinstance(result.get("workspace"), dict) else {}
+    lines = [
+        f"Workspace: {workspace.get('workspaceName') or workspace.get('wsName') or '-'} ({workspace.get('wsId') or result.get('ws_id') or '-'})",
+        f"QF Version: {result.get('qf_version') or workspace.get('systemVersion') or '-'}",
+        f"Identity: {workspace.get('identity') or '-'}",
+        f"Auth: {workspace.get('auth') if workspace.get('auth') is not None else '-'}",
+        f"State: {workspace.get('state') if workspace.get('state') is not None else '-'}",
+    ]
+    _append_warnings(lines, result.get("warnings"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_workspace_select(result: dict[str, Any]) -> str:
+    status = str(result.get("status") or "").lower()
+    if status == "cancelled":
+        return str(result.get("message") or "已取消") + "\n"
+
+    workspace = result.get("workspace") if isinstance(result.get("workspace"), dict) else {}
+    workspace_name = workspace.get("workspaceName") or workspace.get("wsName") or result.get("selected", {}).get("workspace_name") if isinstance(result.get("selected"), dict) else None
+    lines = [
+        f"已切换到: {workspace_name or '-'} ({workspace.get('wsId') or result.get('ws_id') or '-'})",
+        f"QF Version: {result.get('qf_version') or workspace.get('systemVersion') or '-'}",
+    ]
+    _append_warnings(lines, result.get("warnings"))
+    return "\n".join(lines) + "\n"
+
+
 def _format_app_items(result: dict[str, Any]) -> str:
     items = result.get("items")
     if not isinstance(items, list):
@@ -118,6 +166,7 @@ def _format_app_get(result: dict[str, Any]) -> str:
     if editability:
         lines.append(
             "Editability: "
+            f"app_base={editability.get('can_edit_app_base')} / "
             f"form={editability.get('can_edit_form')} / "
             f"flow={editability.get('can_edit_flow')} / "
             f"views={editability.get('can_edit_views')} / "
@@ -148,20 +197,24 @@ def _format_record_list(result: dict[str, Any]) -> str:
 def _format_task_list(result: dict[str, Any]) -> str:
     data = result.get("data") if isinstance(result.get("data"), dict) else {}
     items = data.get("items") if isinstance(data.get("items"), list) else []
-    rows = []
+    lines = ["Tasks"]
     for item in items:
         if not isinstance(item, dict):
             continue
-        rows.append(
-            [
-                str(item.get("app_key") or ""),
-                str(item.get("record_id") or ""),
-                str(item.get("workflow_node_id") or ""),
-                str(item.get("title") or item.get("task_name") or ""),
-            ]
-        )
-    output = _render_titled_table("Tasks", ["app_key", "record_id", "node_id", "title"], rows)
-    lines = output.rstrip("\n").split("\n")
+        header_parts = [
+            str(item.get("task_id") or "-"),
+            str(item.get("app_name") or item.get("app_key") or "-"),
+            str(item.get("workflow_node_name") or "-"),
+        ]
+        apply_time = item.get("apply_time")
+        if apply_time not in (None, ""):
+            header_parts.append(str(apply_time))
+        lines.append("- " + " / ".join(header_parts))
+        summary_fields = item.get("summary_fields") if isinstance(item.get("summary_fields"), list) else []
+        for summary in summary_fields:
+            if not isinstance(summary, dict):
+                continue
+            lines.append(f"  {summary.get('title') or '-'}: {summary.get('answer') or '-'}")
     _append_warnings(lines, result.get("warnings"))
     return "\n".join(lines) + "\n"
 
@@ -169,34 +222,150 @@ def _format_task_list(result: dict[str, Any]) -> str:
 def _format_task_get(result: dict[str, Any]) -> str:
     data = result.get("data") if isinstance(result.get("data"), dict) else {}
     task = data.get("task") if isinstance(data.get("task"), dict) else {}
-    record = data.get("record") if isinstance(data.get("record"), dict) else {}
-    capabilities = data.get("capabilities") if isinstance(data.get("capabilities"), dict) else {}
-    update_schema = data.get("update_schema") if isinstance(data.get("update_schema"), dict) else {}
-    writable_fields = update_schema.get("writable_fields") if isinstance(update_schema.get("writable_fields"), list) else []
-    lines = [
-        f"Task: {task.get('app_key') or '-'} / {task.get('record_id') or '-'} / {task.get('workflow_node_id') or '-'}",
-        f"Node: {task.get('workflow_node_name') or '-'}",
-        f"Apply Status: {record.get('apply_status')}",
-        f"Available Actions: {', '.join(str(item) for item in (capabilities.get('available_actions') or [])) or '-'}",
-        f"Editable Fields: {len(writable_fields)}",
-    ]
-    if writable_fields:
-        for item in writable_fields[:10]:
+    record_summary = data.get("record_summary") if isinstance(data.get("record_summary"), dict) else {}
+    editable_fields = data.get("editable_fields") if isinstance(data.get("editable_fields"), list) else []
+    available_actions = data.get("available_actions") if isinstance(data.get("available_actions"), list) else []
+    extras = data.get("extras") if isinstance(data.get("extras"), dict) else {}
+    initiator = task.get("initiator") if isinstance(task.get("initiator"), dict) else {}
+    initiator_label = initiator.get("displayName") or initiator.get("email") or "-"
+    lines = []
+    if task.get("task_id") not in (None, ""):
+        lines.append(f"Task ID: {task.get('task_id')}")
+    lines.extend(
+        [
+            f"Locator: {task.get('app_key') or '-'} / {task.get('record_id') or '-'} / {task.get('workflow_node_id') or '-'}",
+            f"Node: {task.get('workflow_node_name') or '-'}",
+            f"App: {task.get('app_name') or '-'}",
+            f"Initiator: {initiator_label}",
+            f"Apply Status: {record_summary.get('apply_status')}",
+            f"Apply Number: {record_summary.get('custom_apply_num') or record_summary.get('apply_num') or '-'}",
+            f"Apply Time: {record_summary.get('apply_time') or '-'}",
+            f"Available Actions: {', '.join(str(item) for item in available_actions) or '-'}",
+            f"Editable Fields: {len(editable_fields)}",
+        ]
+    )
+    all_fields = record_summary.get("all_fields") if isinstance(record_summary.get("all_fields"), dict) else {}
+    core_fields = record_summary.get("core_fields") if isinstance(record_summary.get("core_fields"), dict) else {}
+    if all_fields:
+        lines.append("Fields:")
+        for key, value in all_fields.items():
+            lines.extend(_format_field_line(key, value))
+    elif core_fields:
+        lines.append("Core Fields:")
+        for key, value in list(core_fields.items())[:12]:
+            lines.extend(_format_field_line(key, value))
+    if editable_fields:
+        lines.append("Editable Fields:")
+        for item in editable_fields[:10]:
             if isinstance(item, dict):
                 lines.append(f"- {item.get('title') or '-'} ({item.get('kind') or 'field'})")
-    blockers = update_schema.get("blockers") if isinstance(update_schema.get("blockers"), list) else []
-    if blockers:
-        lines.append("Update Schema Blockers:")
-        for item in blockers:
-            lines.append(f"- {item}")
-    schema_warnings = update_schema.get("warnings") if isinstance(update_schema.get("warnings"), list) else []
-    if schema_warnings:
-        lines.append("Update Schema Warnings:")
-        for item in schema_warnings:
+    associated_reports = extras.get("associated_reports") if isinstance(extras.get("associated_reports"), dict) else {}
+    rollback_candidates = extras.get("rollback_candidates") if isinstance(extras.get("rollback_candidates"), dict) else {}
+    transfer_candidates = extras.get("transfer_candidates") if isinstance(extras.get("transfer_candidates"), dict) else {}
+    lines.append(
+        "Extras: "
+        f"reports={associated_reports.get('count', 0)}, "
+        f"rollback={rollback_candidates.get('count', 0)}, "
+        f"transfer={transfer_candidates.get('count', 0)}"
+    )
+    transfer_items = transfer_candidates.get("items") if isinstance(transfer_candidates.get("items"), list) else []
+    if transfer_items:
+        lines.append("Transfer Candidates:")
+        for item in transfer_items:
             if isinstance(item, dict):
-                lines.append(f"- {item.get('code') or 'WARNING'}: {item.get('message') or ''}".rstrip())
-            else:
-                lines.append(f"- {item}")
+                display = item.get("name") or item.get("uid") or item
+                suffix = f" <{item.get('email')}>" if item.get("email") else ""
+                lines.append(f"- {display}{suffix} (uid={item.get('uid') or '-'})")
+    _append_warnings(lines, result.get("warnings"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_task_action(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    action = str(data.get("action") or "").strip().lower()
+    status = str(result.get("status") or "").strip().lower()
+
+    if status == "failed" or result.get("ok") is False:
+        lines = [_task_action_failure_label(action)]
+        reason = _task_action_failure_reason(result)
+        if reason:
+            lines.append(f"原因：{reason}")
+        debug_lines = _task_action_debug_lines(result)
+        if debug_lines:
+            lines.append("调试信息：")
+            lines.extend(f"- {line}" for line in debug_lines)
+        return "\n".join(lines) + "\n"
+
+    if status == "partial_success":
+        lines = [_task_action_success_label(action)]
+        lines.append(f"说明：{_task_action_partial_success_message(result)}")
+        return "\n".join(lines) + "\n"
+
+    return _task_action_success_label(action) + "\n"
+
+
+def _format_task_workbench(result: dict[str, Any]) -> str:
+    message = str(result.get("message") or "").strip()
+    if message:
+        return message + "\n"
+    return ""
+
+
+def _format_field_line(key: Any, value: Any) -> list[str]:
+    if isinstance(value, list):
+        text = " / ".join(str(item) for item in value if item not in (None, ""))
+    else:
+        text = str(value if value not in (None, "") else "-")
+    wrapped = textwrap.wrap(
+        text,
+        width=120,
+        initial_indent=f"- {key}: ",
+        subsequent_indent="  ",
+        replace_whitespace=False,
+        drop_whitespace=False,
+        break_long_words=True,
+    )
+    return wrapped or [f"- {key}: -"]
+
+
+def _format_task_associated_report_detail(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    selection = data.get("selection") if isinstance(data.get("selection"), dict) else {}
+    result_type = str(data.get("result_type") or "-")
+    context = data.get("context") if isinstance(data.get("context"), dict) else {}
+    lines = []
+    if selection.get("task_id") not in (None, ""):
+        lines.append(f"Task ID: {selection.get('task_id')}")
+    lines.extend(
+        [
+            f"Report: {selection.get('chart_name') or '-'} ({selection.get('report_id') or '-'})",
+            f"Type: {result_type}",
+        ]
+    )
+    if result_type == "view_list":
+        result_payload = data.get("result") if isinstance(data.get("result"), dict) else {}
+        items = result_payload.get("items") if isinstance(result_payload.get("items"), list) else []
+        lines.append(f"Returned Records: {len(items)}")
+        for item in items[:10]:
+            if isinstance(item, dict):
+                lines.append(json.dumps(item, ensure_ascii=False))
+        if len(items) > 10:
+            lines.append(f"... {len(items) - 10} more")
+    elif result_type == "chart_data":
+        result_payload = data.get("result") if isinstance(data.get("result"), dict) else {}
+        summary = result_payload.get("summary") if isinstance(result_payload.get("summary"), dict) else {}
+        rows = result_payload.get("rows") if isinstance(result_payload.get("rows"), list) else []
+        if summary:
+            lines.append(f"Summary: {json.dumps(summary, ensure_ascii=False)}")
+        lines.append(f"Rows: {len(rows)}")
+        for row in rows[:10]:
+            if isinstance(row, dict):
+                lines.append(json.dumps(row, ensure_ascii=False))
+        if len(rows) > 10:
+            lines.append(f"... {len(rows) - 10} more")
+    resolved_filters = context.get("resolved_filters") if isinstance(context.get("resolved_filters"), list) else []
+    if resolved_filters:
+        lines.append(f"Resolved Filters: {len(resolved_filters)}")
     _append_warnings(lines, result.get("warnings"))
     return "\n".join(lines) + "\n"
 
@@ -206,17 +375,22 @@ def _format_import_verify(result: dict[str, Any]) -> str:
         f"App Key: {result.get('app_key') or '-'}",
         f"File: {result.get('file_name') or result.get('file_path') or '-'}",
         f"Can Import: {result.get('can_import')}",
-        f"Apply Rows: {result.get('apply_rows')}",
         f"Verification ID: {result.get('verification_id') or '-'}",
     ]
-    issues = result.get("issues") if isinstance(result.get("issues"), list) else []
-    if issues:
-        lines.append("Issues:")
-        for issue in issues:
-            if isinstance(issue, dict):
-                lines.append(f"- {issue.get('code') or 'ISSUE'}: {issue.get('message') or issue}")
-            else:
-                lines.append(f"- {issue}")
+    issue_summary = result.get("issue_summary") if isinstance(result.get("issue_summary"), dict) else {}
+    if issue_summary:
+        lines.append(
+            "Issues: "
+            f"total={issue_summary.get('total', 0)}, "
+            f"errors={issue_summary.get('errors', 0)}, "
+            f"warnings={issue_summary.get('warnings', 0)}"
+        )
+        sample = issue_summary.get("sample") if isinstance(issue_summary.get("sample"), list) else []
+        if sample:
+            lines.append("Issue Samples:")
+            for item in sample:
+                if isinstance(item, dict):
+                    lines.append(f"- {item.get('code') or 'ISSUE'}: {item.get('message') or ''}".rstrip())
     _append_warnings(lines, result.get("warnings"))
     _append_verification(lines, result.get("verification"))
     return "\n".join(lines) + "\n"
@@ -227,15 +401,91 @@ def _format_import_status(result: dict[str, Any]) -> str:
         f"Status: {result.get('status') or '-'}",
         f"Import ID: {result.get('import_id') or '-'}",
         f"Process ID: {result.get('process_id_str') or '-'}",
-        f"Success Rows: {result.get('success_rows') or 0}",
-        f"Failed Rows: {result.get('failed_rows') or 0}",
+        f"Total Rows: {result.get('total') or 0}",
+        f"Finished Rows: {result.get('finished') or 0}",
+        f"Succeeded Rows: {result.get('succeeded') or 0}",
+        f"Failed Rows: {result.get('failed') or 0}",
         f"Progress: {result.get('progress') or '-'}",
     ]
+    if result.get("process_status") not in (None, ""):
+        lines.append(f"Process Status: {result.get('process_status')}")
+    error_file_urls = result.get("error_file_urls") if isinstance(result.get("error_file_urls"), list) else []
+    if error_file_urls:
+        lines.append("Error Files:")
+        for url in error_file_urls:
+            lines.append(f"- {url}")
     _append_warnings(lines, result.get("warnings"))
     _append_verification(lines, result.get("verification"))
     return "\n".join(lines) + "\n"
 
 
+def _format_export_common(result: dict[str, Any], *, title: str | None = None) -> str:
+    lines: list[str] = []
+    if title:
+        lines.append(title)
+    lines.extend(
+        [
+            f"Status: {result.get('status') or '-'}",
+            f"Export Handle: {result.get('export_handle') or '-'}",
+            f"App Key: {result.get('app_key') or '-'}",
+            f"View ID: {result.get('view_id') or '-'}",
+            f"Process Status: {result.get('process_status') or '-'}",
+            f"Rows: {result.get('num') if result.get('num') is not None else '-'}",
+        ]
+    )
+    row_scope = result.get("row_scope")
+    if row_scope not in (None, ""):
+        lines.append(f"Row Scope: {row_scope}")
+    selected_record_count = result.get("selected_record_count")
+    if selected_record_count not in (None, ""):
+        lines.append(f"Selected Rows: {selected_record_count}")
+    field_scope = result.get("field_scope")
+    if field_scope not in (None, ""):
+        lines.append(f"Field Scope: {field_scope}")
+    selected_field_count = result.get("selected_field_count")
+    if selected_field_count not in (None, ""):
+        lines.append(f"Selected Fields: {selected_field_count}")
+    include_workflow_log = result.get("include_workflow_log")
+    if include_workflow_log not in (None, ""):
+        lines.append(f"Include Workflow Log: {include_workflow_log}")
+    file_names = result.get("file_names") if isinstance(result.get("file_names"), list) else []
+    file_urls = result.get("file_urls") if isinstance(result.get("file_urls"), list) else []
+    if file_names or file_urls:
+        lines.append("Remote Files:")
+        max_items = max(len(file_names), len(file_urls))
+        for index in range(max_items):
+            name = file_names[index] if index < len(file_names) else "-"
+            url = file_urls[index] if index < len(file_urls) else "-"
+            lines.append(f"- {name}: {url}")
+    downloaded_files = result.get("downloaded_files") if isinstance(result.get("downloaded_files"), list) else []
+    if downloaded_files:
+        lines.append("Downloaded Files:")
+        for item in downloaded_files:
+            if isinstance(item, dict):
+                lines.append(f"- {item.get('file_name') or '-'}: {item.get('path') or '-'}")
+            else:
+                lines.append(f"- {item}")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_export_start(result: dict[str, Any]) -> str:
+    return _format_export_common(result, title="Export Accepted")
+
+
+def _format_export_status(result: dict[str, Any]) -> str:
+    return _format_export_common(result, title="Export Status")
+
+
+def _format_export_get(result: dict[str, Any]) -> str:
+    return _format_export_common(result, title="Export Result")
+
+
+def _format_export_direct(result: dict[str, Any]) -> str:
+    return _format_export_common(result, title="Export Direct")
+
+
 def _format_builder_summary(result: dict[str, Any]) -> str:
     lines = []
     if "status" in result:
@@ -319,16 +569,140 @@ def _first_present(payload: dict[str, Any], *keys: str) -> Any:
     return None
 
 
+def _task_action_success_label(action: str) -> str:
+    return {
+        "approve": "已通过",
+        "reject": "已驳回",
+        "rollback": "已退回",
+        "transfer": "已转交",
+        "save_only": "已保存",
+        "urge": "已催办",
+    }.get(action, "已执行")
+
+
+def _task_action_failure_label(action: str) -> str:
+    return {
+        "approve": "审批失败",
+        "reject": "驳回失败",
+        "rollback": "退回失败",
+        "transfer": "转交失败",
+        "save_only": "保存失败",
+        "urge": "催办失败",
+    }.get(action, "执行失败")
+
+
+def _task_action_partial_success_message(result: dict[str, Any]) -> str:
+    error_code = str(result.get("error_code") or "").strip().upper()
+    if error_code == "WORKFLOW_CONTINUATION_UNVERIFIED":
+        return "动作已提交，但暂未完成后续流程验证。可使用 --json 查看详细信息。"
+    if error_code == "TASK_ALREADY_PROCESSED":
+        return "当前待办已不可操作，系统判断流程可能已被其他人处理。可使用 --json 查看详细信息。"
+    warnings = result.get("warnings")
+    if isinstance(warnings, list):
+        for warning in warnings:
+            if not isinstance(warning, dict):
+                continue
+            code = str(warning.get("code") or "").strip().upper()
+            if code == "TASK_ALREADY_PROCESSED_UNCONFIRMED_ACTOR":
+                return "当前待办已不可操作，系统判断流程可能已被其他人处理。可使用 --json 查看详细信息。"
+            if code == "WORKFLOW_CONTINUATION_UNVERIFIED":
+                return "动作已提交，但暂未完成后续流程验证。可使用 --json 查看详细信息。"
+    return "动作已提交，但结果验证不完整。可使用 --json 查看详细信息。"
+
+
+def _task_action_failure_reason(result: dict[str, Any]) -> str | None:
+    error_code = str(result.get("error_code") or "").strip().upper()
+    mapped_error = {
+        "TASK_CONTEXT_VISIBILITY_UNVERIFIED": "当前待办已不可操作，且系统未能确认是否已被处理。",
+        "TASK_SAVE_ONLY_VERIFICATION_FAILED": "保存请求已发送，但未能确认字段是否全部保存成功。",
+        "WORKFLOW_CONTINUATION_UNVERIFIED": "动作已提交，但暂未验证到流程继续推进。",
+        "TASK_ALREADY_PROCESSED": "当前待办已不可操作，系统判断流程可能已被其他人处理。",
+    }.get(error_code)
+    if mapped_error:
+        return mapped_error
+
+    warnings = result.get("warnings")
+    if isinstance(warnings, list):
+        for warning in warnings:
+            if isinstance(warning, dict) and warning.get("message"):
+                return str(warning.get("message"))
+
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    transport_error = data.get("transport_error") if isinstance(data.get("transport_error"), dict) else {}
+    backend_code = transport_error.get("backend_code")
+    http_status = transport_error.get("http_status")
+    if backend_code not in (None, ""):
+        return f"后端返回错误码 {backend_code}。"
+    if http_status not in (None, ""):
+        return f"请求返回 HTTP {http_status}。"
+
+    verification = result.get("verification") if isinstance(result.get("verification"), dict) else {}
+    record_state_error = verification.get("record_state_error") if isinstance(verification.get("record_state_error"), dict) else {}
+    backend_code = record_state_error.get("backend_code")
+    http_status = record_state_error.get("http_status")
+    if backend_code not in (None, ""):
+        return f"后端返回错误码 {backend_code}。"
+    if http_status not in (None, ""):
+        return f"请求返回 HTTP {http_status}。"
+    if error_code:
+        return f"错误码：{error_code}"
+    return None
+
+
+def _task_action_debug_lines(result: dict[str, Any]) -> list[str]:
+    lines: list[str] = []
+    error_code = result.get("error_code")
+    if error_code not in (None, ""):
+        lines.append(f"error_code: {error_code}")
+
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    transport_error = data.get("transport_error") if isinstance(data.get("transport_error"), dict) else {}
+    for key in ("backend_code", "http_status", "category"):
+        value = transport_error.get(key)
+        if value not in (None, ""):
+            lines.append(f"{key}: {value}")
+
+    verification = result.get("verification") if isinstance(result.get("verification"), dict) else {}
+    for key in (
+        "runtime_continuation_verified",
+        "task_context_visibility_verified",
+        "fields_saved_verified",
+        "task_still_actionable",
+        "workflow_not_advanced",
+        "record_state_readable",
+    ):
+        if key in verification and verification.get(key) is not None:
+            lines.append(f"{key}: {verification.get(key)}")
+
+    record_state_error = verification.get("record_state_error") if isinstance(verification.get("record_state_error"), dict) else {}
+    for key in ("backend_code", "http_status", "category"):
+        value = record_state_error.get(key)
+        if value not in (None, ""):
+            entry = f"record_state_{key}: {value}"
+            if entry not in lines:
+                lines.append(entry)
+    return lines
+
+
 _FORMATTERS = {
     "auth_whoami": _format_whoami,
     "workspace_list": _format_workspace_list,
+    "workspace_get": _format_workspace_get,
+    "workspace_select": _format_workspace_select,
     "app_list": _format_app_items,
     "app_search": _format_app_items,
     "app_get": _format_app_get,
     "record_list": _format_record_list,
     "task_list": _format_task_list,
+    "task_workbench": _format_task_workbench,
     "task_get": _format_task_get,
+    "task_action_execute": _format_task_action,
+    "task_associated_report_detail_get": _format_task_associated_report_detail,
     "import_verify": _format_import_verify,
     "import_status": _format_import_status,
+    "export_start": _format_export_start,
+    "export_status": _format_export_status,
+    "export_get": _format_export_get,
+    "export_direct": _format_export_direct,
     "builder_summary": _format_builder_summary,
 }

package/src/qingflow_mcp/cli/interaction.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Callable, Generic, TypeVar
+
+from .terminal_ui import SelectionOption, select_option
+
+
+T = TypeVar("T")
+
+
+@dataclass(slots=True)
+class InteractiveSelectionResult(Generic[T]):
+    status: str
+    value: T | None = None
+    message: str | None = None
+
+
+def cancelled_result(message: str = "已取消") -> dict[str, str]:
+    return {"status": "cancelled", "message": message}
+
+
+def resolve_interactive_selection(
+    args: object,
+    *,
+    title: str,
+    unavailable_message: str,
+    empty_message: str,
+    load_options: Callable[[], list[SelectionOption[T]]],
+) -> InteractiveSelectionResult[T]:
+    input_stream = getattr(args, "_stdin", None)
+    output_stream = getattr(args, "_stderr_stream", None)
+    if input_stream is None or output_stream is None:
+        return InteractiveSelectionResult(status="unavailable", message=unavailable_message)
+    if not bool(getattr(input_stream, "isatty", lambda: False)()):
+        return InteractiveSelectionResult(status="unavailable", message=unavailable_message)
+
+    options = list(load_options())
+    if not options:
+        return InteractiveSelectionResult(status="empty", message=empty_message)
+
+    value = select_option(
+        title=title,
+        options=options,
+        input_stream=input_stream,
+        output_stream=output_stream,
+    )
+    if value is None:
+        return InteractiveSelectionResult(status="cancelled", message="已取消")
+    return InteractiveSelectionResult(status="selected", value=value)
+
+
+def resolve_interactive_text_input(
+    args: object,
+    *,
+    prompt: str,
+    unavailable_message: str,
+) -> InteractiveSelectionResult[str]:
+    input_stream = getattr(args, "_stdin", None)
+    output_stream = getattr(args, "_stderr_stream", None)
+    if input_stream is None or output_stream is None:
+        return InteractiveSelectionResult(status="unavailable", message=unavailable_message)
+    if not bool(getattr(input_stream, "isatty", lambda: False)()):
+        return InteractiveSelectionResult(status="unavailable", message=unavailable_message)
+
+    output_stream.write(prompt)
+    output_stream.flush()
+    line = input_stream.readline()
+    text = str(line or "").strip()
+    if not text:
+        return InteractiveSelectionResult(status="cancelled", message="已取消")
+    return InteractiveSelectionResult(status="selected", value=text)