@josephyan/qingflow-app-user-mcp 0.2.0-beta.1004 → 0.2.0-beta.1005

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-user-mcp@0.2.0-beta.1004
+npm install @josephyan/qingflow-app-user-mcp@0.2.0-beta.1005
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-user-mcp@0.2.0-beta.1004 qingflow-app-user-mcp
+npx -y -p @josephyan/qingflow-app-user-mcp@0.2.0-beta.1005 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-user-mcp",
-  "version": "0.2.0-beta.1004",
+  "version": "0.2.0-beta.1005",
   "description": "Operational end-user MCP for Qingflow records, tasks, comments, and directory workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "0.2.0b1004"
+version = "0.2.0b1005"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/__init__.py

@@ -5,7 +5,7 @@ from pathlib import Path
 
 __all__ = ["__version__"]
 
-_FALLBACK_VERSION = "0.2.0b1004"
+_FALLBACK_VERSION = "0.2.0b1005"
 
 
 def _resolve_local_pyproject_version() -> str | None:

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

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import argparse
+import sys
 from typing import Any
 
 from ..context import CliContext
@@ -18,10 +19,20 @@ TASK_ACTION_LABELS = {
     "urge": "催办",
 }
 
+TASK_ACTION_SUCCESS_LABELS = {
+    "approve": "已通过",
+    "reject": "已驳回",
+    "rollback": "已退回",
+    "transfer": "已转交",
+    "save_only": "已保存",
+    "urge": "已催办",
+}
+
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
     parser = subparsers.add_parser("task", help="待办与流程上下文")
-    task_subparsers = parser.add_subparsers(dest="task_command", required=True)
+    task_subparsers = parser.add_subparsers(dest="task_command", required=False)
+    parser.set_defaults(handler=_handle_task_workbench, format_hint="task_workbench", _task_parser=parser)
 
     list_parser = task_subparsers.add_parser("list", help="列出待办")
     list_parser.add_argument("--task-box", default="todo")
@@ -90,6 +101,36 @@ def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
     )
 
 
+def _handle_task_workbench(args: argparse.Namespace, context: CliContext) -> dict:
+    if bool(args.json) or not _has_interactive_terminal(args):
+        _raise_task_subcommand_required(args)
+
+    banner: str | None = None
+    while True:
+        title = _build_task_workbench_list_title(banner)
+        selection = _choose_todo_task_interactively(args, context, tool_name="task", title=title)
+        banner = None
+        if selection.status == "empty":
+            return {"status": "success", "message": "当前没有待办"}
+        if selection.status == "cancelled":
+            return cancelled_result("已退出")
+        if selection.status != "selected":
+            _raise_task_subcommand_required(args)
+
+        args.task_id = str(selection.value or "")
+        args.app_key = ""
+        args.record_id = ""
+        args.workflow_node_id = 0
+
+        outcome, payload = _run_task_workbench_task_loop(args, context)
+        if outcome == "refresh":
+            banner = str(payload or "").strip() or None
+            continue
+        if outcome == "back":
+            continue
+        return payload if isinstance(payload, dict) else cancelled_result("已退出")
+
+
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
     selection_result = _resolve_task_locator_or_select(args, context, tool_name="task get")
     if isinstance(selection_result, dict):
@@ -165,6 +206,50 @@ def _handle_report(args: argparse.Namespace, context: CliContext) -> dict:
     )
 
 
+def _run_task_workbench_task_loop(args: argparse.Namespace, context: CliContext) -> tuple[str, dict | str]:
+    while True:
+        task_context = _load_task_workbench_context(args, context)
+        detail_selection = _show_task_workbench_detail(args, task_context)
+        if detail_selection.status == "cancelled":
+            return "back", ""
+        if str(detail_selection.value or "") == "exit":
+            return "result", cancelled_result("已退出")
+        if str(detail_selection.value or "") != "action":
+            return "back", ""
+
+        action_selection = _choose_task_action_interactively(
+            args,
+            task_context,
+            fields={},
+            title=_build_task_action_title(task_context),
+        )
+        if action_selection.status == "cancelled":
+            continue
+        if action_selection.status == "empty":
+            continue
+        if action_selection.status != "selected":
+            return "result", cancelled_result("已退出")
+
+        args.action = str(action_selection.value or "").strip()
+        payload_selection = _resolve_action_payload_or_select(args, task_context, payload={})
+        if _is_cancelled_result(payload_selection):
+            continue
+
+        result = context.task.task_action_execute(
+            profile=args.profile,
+            task_id=args.task_id,
+            app_key=args.app_key or "",
+            record_id=args.record_id or "",
+            workflow_node_id=int(args.workflow_node_id or 0),
+            action=args.action,
+            payload=payload_selection,
+            fields={},
+        )
+        if _is_success_result(result):
+            return "refresh", _task_action_success_label(str(args.action or "").strip().lower())
+        return "result", result
+
+
 def _resolve_task_locator_or_select(args: argparse.Namespace, context: CliContext, *, tool_name: str) -> dict | None:
     if (args.task_id or "").strip():
         return None
@@ -200,7 +285,13 @@ def _resolve_task_locator_or_select(args: argparse.Namespace, context: CliContex
     return None
 
 
-def _choose_todo_task_interactively(args: argparse.Namespace, context: CliContext, *, tool_name: str):
+def _choose_todo_task_interactively(
+    args: argparse.Namespace,
+    context: CliContext,
+    *,
+    tool_name: str,
+    title: str = "选择待办",
+):
     def load_options() -> list[SelectionOption[str]]:
         result = context.task.task_list(
             profile=args.profile,
@@ -244,7 +335,7 @@ def _choose_todo_task_interactively(args: argparse.Namespace, context: CliContex
 
     return resolve_interactive_selection(
         args,
-        title="选择待办",
+        title=title,
         unavailable_message=(
             f"{tool_name} requires --task-id, or --app-key together with --record-id and --workflow-node-id"
         ),
@@ -287,6 +378,18 @@ def _load_task_action_context(args: argparse.Namespace, context: CliContext) ->
     )
 
 
+def _load_task_workbench_context(args: argparse.Namespace, context: CliContext) -> dict[str, Any]:
+    return context.task.task_get(
+        profile=args.profile,
+        task_id=args.task_id,
+        app_key=args.app_key or "",
+        record_id=args.record_id or "",
+        workflow_node_id=int(args.workflow_node_id or 0),
+        include_candidates=True,
+        include_associated_reports=True,
+    )
+
+
 def _resolve_task_action_or_select(
     args: argparse.Namespace,
     task_context: dict[str, Any],
@@ -316,6 +419,7 @@ def _choose_task_action_interactively(
     task_context: dict[str, Any],
     *,
     fields: dict[str, Any],
+    title: str = "选择操作",
 ):
     data = task_context.get("data") if isinstance(task_context.get("data"), dict) else {}
     available_actions = [str(item).strip() for item in (data.get("available_actions") or []) if str(item).strip()]
@@ -349,13 +453,36 @@ def _choose_task_action_interactively(
 
     return resolve_interactive_selection(
         args,
-        title="选择操作",
+        title=title,
         unavailable_message="task action requires --action, or an interactive terminal to choose the current task action",
         empty_message="task action could not open an action selector because no interactive actions are available.",
         load_options=load_options,
     )
 
 
+def _show_task_workbench_detail(args: argparse.Namespace, task_context: dict[str, Any]):
+    has_actions = _task_has_interactive_actions(task_context)
+
+    def load_options() -> list[SelectionOption[str]]:
+        if has_actions:
+            return [
+                SelectionOption(value="action", label="执行操作", hint="查看当前节点可执行动作"),
+                SelectionOption(value="back", label="返回列表", hint="回到待办列表"),
+            ]
+        return [
+            SelectionOption(value="back", label="返回列表", hint="当前节点没有可执行动作"),
+            SelectionOption(value="exit", label="退出工作台", hint="结束当前待办工作台"),
+        ]
+
+    return resolve_interactive_selection(
+        args,
+        title=_build_task_detail_title(task_context),
+        unavailable_message="task workbench requires an interactive terminal",
+        empty_message="task workbench could not open the task detail view.",
+        load_options=load_options,
+    )
+
+
 def _resolve_action_payload_or_select(
     args: argparse.Namespace,
     task_context: dict[str, Any],
@@ -513,6 +640,100 @@ def _is_cancelled_result(value: Any) -> bool:
     return isinstance(value, dict) and str(value.get("status") or "").strip().lower() == "cancelled"
 
 
+def _is_success_result(result: dict[str, Any]) -> bool:
+    if not isinstance(result, dict):
+        return False
+    if result.get("ok") is False:
+        return False
+    return str(result.get("status") or "").strip().lower() == "success"
+
+
+def _task_action_success_label(action: str) -> str:
+    return TASK_ACTION_SUCCESS_LABELS.get(action, "已完成")
+
+
+def _build_task_workbench_list_title(banner: str | None) -> str:
+    lines = ["待办工作台", "选择一条待办后查看详情并执行操作"]
+    if banner:
+        lines.extend(["", f"上一条结果：{banner}"])
+    return "\n".join(lines)
+
+
+def _build_task_detail_title(task_context: dict[str, Any]) -> str:
+    data = task_context.get("data") if isinstance(task_context.get("data"), dict) else {}
+    task = data.get("task") if isinstance(data.get("task"), dict) else {}
+    record_summary = data.get("record_summary") if isinstance(data.get("record_summary"), dict) else {}
+    available_actions = data.get("available_actions") if isinstance(data.get("available_actions"), list) else []
+    editable_fields = data.get("editable_fields") if isinstance(data.get("editable_fields"), list) else []
+    extras = data.get("extras") if isinstance(data.get("extras"), dict) else {}
+    initiator = task.get("initiator") if isinstance(task.get("initiator"), dict) else {}
+    core_fields = record_summary.get("core_fields") if isinstance(record_summary.get("core_fields"), dict) else {}
+    action_labels = ", ".join(TASK_ACTION_LABELS.get(str(item), str(item)) for item in available_actions if str(item).strip()) or "-"
+    lines = [
+        "待办详情",
+        f"Task ID: {task.get('task_id') or '-'}",
+        f"应用: {task.get('app_name') or '-'}",
+        f"节点: {task.get('workflow_node_name') or '-'}",
+        f"发起人: {_task_initiator_label(initiator)}",
+        f"状态: {record_summary.get('apply_status') or '-'}",
+        f"可执行动作: {action_labels}",
+        f"可编辑字段: {len(editable_fields)}",
+        (
+            "附加信息: "
+            f"报表 {_count_candidate_items(extras.get('associated_reports'))} / "
+            f"退回 {_count_candidate_items(extras.get('rollback_candidates'))} / "
+            f"转交 {_count_candidate_items(extras.get('transfer_candidates'))}"
+        ),
+    ]
+    if core_fields:
+        lines.append("")
+        lines.append("摘要字段:")
+        for key, value in list(core_fields.items())[:6]:
+            lines.append(f"- {key}: {_short_display(value)}")
+    return "\n".join(lines)
+
+
+def _build_task_action_title(task_context: dict[str, Any]) -> str:
+    return _build_task_detail_title(task_context) + "\n\n选择操作"
+
+
+def _task_initiator_label(initiator: dict[str, Any]) -> str:
+    for key in ("display_name", "displayName", "name", "email", "uid"):
+        value = initiator.get(key)
+        if value not in (None, ""):
+            return str(value)
+    return "-"
+
+
+def _task_has_interactive_actions(task_context: dict[str, Any]) -> bool:
+    data = task_context.get("data") if isinstance(task_context.get("data"), dict) else {}
+    available_actions = [str(item).strip() for item in (data.get("available_actions") or []) if str(item).strip()]
+    return any(action != "save_only" for action in available_actions)
+
+
+def _short_display(value: Any, *, limit: int = 60) -> str:
+    text = str(value if value not in (None, "") else "-")
+    if len(text) <= limit:
+        return text
+    return text[: limit - 1] + "…"
+
+
+def _has_interactive_terminal(args: argparse.Namespace) -> bool:
+    input_stream = getattr(args, "_stdin", None)
+    return bool(getattr(input_stream, "isatty", lambda: False)())
+
+
+def _raise_task_subcommand_required(args: argparse.Namespace) -> None:
+    stream = getattr(args, "_stderr_stream", None) or sys.stderr
+    task_parser = getattr(args, "_task_parser", None)
+    if isinstance(task_parser, argparse.ArgumentParser):
+        task_parser.print_usage(stream)
+        stream.write(f"{task_parser.prog}: error: the following arguments are required: task_command\n")
+    else:
+        stream.write("qingflow task: error: the following arguments are required: task_command\n")
+    raise SystemExit(2)
+
+
 def _choose_associated_report_interactively(args: argparse.Namespace, context: CliContext):
     def load_options() -> list[SelectionOption[int]]:
         result = context.task.task_get(

package/src/qingflow_mcp/cli/formatters.py

@@ -296,6 +296,13 @@ def _format_task_action(result: dict[str, Any]) -> str:
     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_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 {}
@@ -588,6 +595,7 @@ _FORMATTERS = {
     "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,

package/src/qingflow_mcp/cli/main.py

@@ -56,6 +56,8 @@ def run(
         if not bool(args.json):
             _emit_cli_effective_context_notice(args, context, stream=err)
         result = handler(args, context)
+    except SystemExit as exc:
+        return int(exc.code or 0)
     except RuntimeError as exc:
         payload = trim_error_response(_parse_error_payload(exc))
         return _emit_error(payload, json_mode=bool(args.json), stdout=out, stderr=err)