@qingflow-tech/qingflow-app-builder-mcp 1.0.18 → 1.0.20

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.18
+npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.20
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.18 qingflow-app-builder-mcp
+npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.20 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-builder-mcp",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "Builder MCP for Qingflow app/package/system design and staged solution workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

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

@@ -20,7 +20,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     file_upload_local.add_argument("--bucket-type")
     file_upload_local.add_argument("--path-id", type=int)
     file_upload_local.add_argument("--file-related-url")
-    file_upload_local.set_defaults(handler=_handle_file_upload_local, format_hint="generic")
+    file_upload_local.set_defaults(handler=_handle_file_upload_local, format_hint="file_upload_local")
 
     feedback = builder_subparsers.add_parser("feedback", help="builder 侧反馈提交")
     feedback_subparsers = feedback.add_subparsers(dest="builder_feedback_command", required=True)

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

@@ -82,7 +82,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     log = task_subparsers.add_parser("log", help="读取流程日志；--task-id 必须来自 task list 的 data.items[].task_id")
     log.add_argument("--task-id", help="来自 `qingflow --json task list` 的 data.items[].task_id；不是列表序号")
-    log.set_defaults(handler=_handle_log, format_hint="", app_key="", record_id="", workflow_node_id=0)
+    log.set_defaults(handler=_handle_log, format_hint="task_workflow_log_get", app_key="", record_id="", workflow_node_id=0)
 
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:

package/src/qingflow_mcp/cli/formatters.py

@@ -566,6 +566,50 @@ def _format_task_get(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_task_workflow_log(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 {}
+    visibility = data.get("visibility") if isinstance(data.get("visibility"), dict) else {}
+    items = data.get("items") if isinstance(data.get("items"), list) else []
+    lines: list[str] = []
+    if selection.get("task_id") not in (None, ""):
+        lines.append(f"Task ID: {selection.get('task_id')}")
+    locator = " / ".join(
+        str(value or "-")
+        for value in (
+            selection.get("app_key"),
+            selection.get("record_id"),
+            selection.get("workflow_node_id"),
+        )
+    )
+    if locator != "- / - / -":
+        lines.append(f"Locator: {locator}")
+    if visibility:
+        lines.append(
+            "Visibility: "
+            f"audit_record={visibility.get('audit_record_visible')} / "
+            f"qrobot_record={visibility.get('qrobot_record_visible')}"
+        )
+    lines.append(f"Workflow Logs: {len(items)}")
+    for item in items[:20]:
+        if not isinstance(item, dict):
+            continue
+        operator = item.get("operator") if isinstance(item.get("operator"), dict) else {}
+        operator_name = operator.get("name") or operator.get("email") or operator.get("uid") or "-"
+        parts = [
+            str(item.get("operation_time") or "-"),
+            str(item.get("node_name") or item.get("node_id") or "-"),
+            str(operator_name),
+            str(item.get("remark") or item.get("operation") or "-"),
+        ]
+        lines.append("- " + " / ".join(parts))
+    if len(items) > 20:
+        lines.append(f"... {len(items) - 20} more")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    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()
@@ -882,6 +926,47 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+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 '-'}",
+        f"Effective Upload Kind: {result.get('effective_upload_kind') or result.get('upload_kind') or '-'}",
+    ]
+    if "upload_fallback_applied" in result:
+        lines.append(f"Fallback Applied: {result.get('upload_fallback_applied')}")
+    if result.get("upload_fallback_reason"):
+        lines.append(f"Fallback Reason: {result.get('upload_fallback_reason')}")
+    if result.get("file_name"):
+        lines.append(f"File: {result.get('file_name')}")
+    if result.get("file_size") is not None:
+        lines.append(f"Size: {result.get('file_size')}")
+    if result.get("content_type"):
+        lines.append(f"Content Type: {result.get('content_type')}")
+    if result.get("upload_protocol"):
+        lines.append(f"Protocol: {result.get('upload_protocol')}")
+    if result.get("download_url"):
+        lines.append(f"Download URL: {result.get('download_url')}")
+
+    attachment_value = result.get("attachment_value") if isinstance(result.get("attachment_value"), dict) else {}
+    if attachment_value:
+        lines.append("Attachment Value:")
+        for key in ("value", "name", "otherInfo"):
+            value = attachment_value.get(key)
+            if value not in (None, ""):
+                lines.append(f"- {key}: {value}")
+
+    comment_file_info = result.get("comment_file_info") if isinstance(result.get("comment_file_info"), dict) else {}
+    if comment_file_info:
+        lines.append("Comment File:")
+        for key in ("url", "name", "uploadFileSize"):
+            value = comment_file_info.get(key)
+            if value not in (None, ""):
+                lines.append(f"- {key}: {value}")
+
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
 def emit_json_result(result: dict[str, Any], *, stream: TextIO) -> None:
     json.dump(result, stream, ensure_ascii=False, indent=2)
     stream.write("\n")
@@ -1078,6 +1163,7 @@ _FORMATTERS = {
     "task_list": _format_task_list,
     "task_workbench": _format_task_workbench,
     "task_get": _format_task_get,
+    "task_workflow_log_get": _format_task_workflow_log,
     "task_action_execute": _format_task_action,
     "task_associated_report_detail_get": _format_task_associated_report_detail,
     "import_template": _format_import_template,
@@ -1090,4 +1176,5 @@ _FORMATTERS = {
     "export_get": _format_export_get,
     "export_direct": _format_export_direct,
     "builder_summary": _format_builder_summary,
+    "file_upload_local": _format_file_upload_local,
 }