@qingflow-tech/qingflow-app-builder-mcp 1.0.1 → 1.0.3

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

@@ -1,8 +1,12 @@
 from __future__ import annotations
 
 import argparse
+import getpass
+import sys
 
+from ...errors import QingflowApiError
 from ..context import CliContext
+from ..qingflow_login import login_with_qingflow_password
 from .common import read_secret_arg
 
 
@@ -10,6 +14,15 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     parser = subparsers.add_parser("auth", help="认证与会话")
     auth_subparsers = parser.add_subparsers(dest="auth_command", required=True)
 
+    login = auth_subparsers.add_parser("login", help="登录 CLI：轻流账号密码交互")
+    login.add_argument("--base-url")
+    login.add_argument("--qf-version")
+    login.add_argument("--email", help="轻流账号邮箱；不传时在交互终端提示输入")
+    login.add_argument("--password", help="轻流账号密码；建议仅用于本地调试，脚本请优先使用 --password-stdin")
+    login.add_argument("--password-stdin", action="store_true", help="从标准输入读取轻流账号密码")
+    login.add_argument("--persist", action=argparse.BooleanOptionalAction, default=True)
+    login.set_defaults(handler=_handle_login, format_hint="auth_whoami")
+
     use_credential = auth_subparsers.add_parser("use-credential", help="直接注入 credential")
     use_credential.add_argument("--base-url")
     use_credential.add_argument("--qf-version")
@@ -25,8 +38,63 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     logout.add_argument("--forget-persisted", action="store_true")
     logout.set_defaults(handler=_handle_logout, format_hint="")
 
+
+def _handle_login(args: argparse.Namespace, context: CliContext) -> dict:
+    email = _resolve_login_email(args)
+    password = _resolve_login_password(args)
+    login_result = login_with_qingflow_password(
+        base_url=args.base_url,
+        email=email,
+        password=password,
+    )
+    result = context.auth.auth_use_token(
+        profile=args.profile,
+        base_url=args.base_url,
+        qf_version=args.qf_version,
+        token=login_result.token,
+        login_token=login_result.login_token,
+        user_info=login_result.user_info,
+        persist=bool(args.persist),
+    )
+    warnings = list(result.get("warnings") or []) if isinstance(result, dict) else []
+    if isinstance(result, dict):
+        result["cli_auth"] = {"flow": login_result.flow}
+        if warnings:
+            result["warnings"] = warnings
+    return result
+
+
+def _resolve_login_email(args: argparse.Namespace) -> str:
+    email = str(args.email or "").strip()
+    if email:
+        return email
+    if sys.stdin.isatty():
+        return input("Qingflow email: ").strip()
+    raise QingflowApiError.config_error(
+        "qingflow auth login needs an interactive terminal, or pass --email with --password-stdin."
+    )
+
+
+def _resolve_login_password(args: argparse.Namespace) -> str:
+    if args.password or bool(args.password_stdin):
+        return read_secret_arg(
+            args.password,
+            stdin_enabled=bool(args.password_stdin),
+            label="password",
+        )
+    if sys.stdin.isatty():
+        return getpass.getpass("Qingflow password: ")
+    raise QingflowApiError.config_error(
+        "qingflow auth login needs an interactive terminal or --password-stdin."
+    )
+
+
 def _handle_use_credential(args: argparse.Namespace, context: CliContext) -> dict:
-    credential = read_secret_arg(args.credential, stdin_enabled=bool(args.credential_stdin), label="credential")
+    credential = (
+        read_secret_arg(args.credential, stdin_enabled=bool(args.credential_stdin), label="credential")
+        if args.credential or bool(args.credential_stdin)
+        else ""
+    )
     return context.auth.auth_use_credential(
         profile=args.profile,
         base_url=args.base_url,

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

@@ -101,7 +101,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     app_release_lock.add_argument("--lock-owner-name", required=True)
     app_release_lock.set_defaults(handler=_handle_app_release_edit_lock_if_mine, format_hint="builder_summary")
 
-    app_get = app_subparsers.add_parser("get", help="读取应用配置")
+    app_get = app_subparsers.add_parser("get", help="读取应用配置（字段请使用: builder app get --app-key APP fields）")
     app_get.add_argument(
         "builder_app_get_section",
         nargs="?",
@@ -160,7 +160,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     portal_apply.add_argument("--dash-name", default="")
     portal_apply.add_argument("--package-id", type=int)
     portal_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
-    portal_apply.add_argument("--sections-file", required=True)
+    portal_apply.add_argument("--sections-file")
     portal_apply.add_argument("--visibility-file")
     portal_apply.add_argument("--auth-file")
     portal_apply.add_argument("--icon")
@@ -513,13 +513,14 @@ def _handle_portal_apply(args: argparse.Namespace, context: CliContext) -> dict:
             "portal apply requires either --dash-key, or --package-id together with --dash-name.",
             fix_hint="Use `--dash-key` for an existing portal. For create mode, pass `--package-id --dash-name`.",
         )
+    sections = [] if not args.sections_file else require_list_arg(args.sections_file, option_name="--sections-file")
     return context.builder.portal_apply(
         profile=args.profile,
         dash_key=args.dash_key,
         dash_name=args.dash_name,
         package_id=args.package_id,
         publish=bool(args.publish),
-        sections=require_list_arg(args.sections_file, option_name="--sections-file"),
+        sections=sections,
         visibility=load_object_arg(args.visibility_file, option_name="--visibility-file"),
         auth=load_object_arg(args.auth_file, option_name="--auth-file"),
         icon=args.icon,

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

@@ -32,7 +32,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     schema_update = schema_subparsers.add_parser("update", help="读取更新记录表结构")
     schema_update.add_argument("--app-key", required=True)
-    schema_update.add_argument("--record-id", required=True, type=int)
+    schema_update.add_argument("--record-id", required=True)
     schema_update.set_defaults(handler=_handle_schema_update, format_hint="")
 
     schema_import = schema_subparsers.add_parser("import", help="读取导入表结构")
@@ -59,7 +59,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     get = record_subparsers.add_parser("get", help="读取单条记录")
     get.add_argument("--app-key", required=True)
-    get.add_argument("--record-id", required=True, type=int)
+    get.add_argument("--record-id", required=True)
     get.add_argument("--column", dest="columns", action="append", type=int, default=[])
     get.add_argument("--columns-file")
     get.add_argument("--view-id")
@@ -73,7 +73,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     update = record_subparsers.add_parser("update", help="更新记录")
     update.add_argument("--app-key", required=True)
-    update.add_argument("--record-id", type=int)
+    update.add_argument("--record-id")
     update.add_argument("--fields-file")
     update.add_argument("--items-file")
     update.add_argument("--dry-run", action=argparse.BooleanOptionalAction, default=False)
@@ -82,7 +82,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     delete = record_subparsers.add_parser("delete", help="删除记录")
     delete.add_argument("--app-key", required=True)
-    delete.add_argument("--record-id", type=int)
+    delete.add_argument("--record-id")
     delete.add_argument("--record-ids-file")
     delete.set_defaults(handler=_handle_delete, format_hint="")
 
@@ -102,7 +102,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     code_block = record_subparsers.add_parser("code-block-run", help="执行代码块字段")
     code_block.add_argument("--app-key", required=True)
-    code_block.add_argument("--record-id", required=True, type=int)
+    code_block.add_argument("--record-id", required=True)
     code_block.add_argument("--code-block-field", required=True)
     code_block.add_argument("--role", type=int, default=1)
     code_block.add_argument("--workflow-node-id", type=int)

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

@@ -15,32 +15,52 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     list_parser.add_argument("--flow-status", default="all")
     list_parser.add_argument("--app-key")
     list_parser.add_argument("--workflow-node-id", type=int)
-    list_parser.add_argument("--query")
+    list_parser.add_argument(
+        "--query",
+        help="先走后端待办检索；当后端返回零结果时，公开 task_list 会回退到本地匹配 app_name / workflow_node_name / app_key / record_id。",
+    )
     list_parser.add_argument("--page", type=int, default=1)
     list_parser.add_argument("--page-size", type=int, default=20)
     list_parser.set_defaults(handler=_handle_list, format_hint="task_list")
 
-    get = task_subparsers.add_parser("get", help="读取待办详情")
-    get.add_argument("--app-key", required=True)
-    get.add_argument("--record-id", required=True, type=int)
-    get.add_argument("--workflow-node-id", required=True, type=int)
+    get = task_subparsers.add_parser("get", help="读取待办详情；推荐直接传 --task-id")
+    get.add_argument("--task-id")
+    get.add_argument("--app-key")
+    get.add_argument("--record-id")
+    get.add_argument("--workflow-node-id", type=int)
     get.add_argument("--include-candidates", action=argparse.BooleanOptionalAction, default=True)
     get.add_argument("--include-associated-reports", action=argparse.BooleanOptionalAction, default=True)
     get.set_defaults(handler=_handle_get, format_hint="task_get")
 
     action = task_subparsers.add_parser("action", help="执行待办动作")
-    action.add_argument("--app-key", required=True)
-    action.add_argument("--record-id", required=True, type=int)
-    action.add_argument("--workflow-node-id", required=True, type=int)
+    action.add_argument("--task-id")
+    action.add_argument("--app-key")
+    action.add_argument("--record-id")
+    action.add_argument("--workflow-node-id", type=int)
     action.add_argument("--action", required=True)
     action.add_argument("--payload-file")
     action.add_argument("--fields-file")
-    action.set_defaults(handler=_handle_action, format_hint="")
+    action.set_defaults(
+        handler=_handle_action,
+        format_hint="task_action_execute",
+        hide_effective_context_line=True,
+    )
 
-    log = task_subparsers.add_parser("log", help="读取流程日志")
-    log.add_argument("--app-key", required=True)
-    log.add_argument("--record-id", required=True, type=int)
-    log.add_argument("--workflow-node-id", required=True, type=int)
+    report = task_subparsers.add_parser("report", help="读取待办关联报表详情；推荐直接传 --task-id")
+    report.add_argument("--task-id")
+    report.add_argument("--app-key")
+    report.add_argument("--record-id")
+    report.add_argument("--workflow-node-id", type=int)
+    report.add_argument("--report-id", required=True, type=int)
+    report.add_argument("--page", type=int, default=1)
+    report.add_argument("--page-size", type=int, default=20)
+    report.set_defaults(handler=_handle_report, format_hint="task_associated_report_detail_get")
+
+    log = task_subparsers.add_parser("log", help="读取流程日志；推荐直接传 --task-id")
+    log.add_argument("--task-id")
+    log.add_argument("--app-key")
+    log.add_argument("--record-id")
+    log.add_argument("--workflow-node-id", type=int)
     log.set_defaults(handler=_handle_log, format_hint="")
 
 
@@ -58,22 +78,32 @@ def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
 
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    if not args.task_id and not (args.app_key and args.record_id and args.workflow_node_id):
+        raise RuntimeError(
+            '{"category":"config","message":"task get requires --task-id, or --app-key together with --record-id and --workflow-node-id"}'
+        )
     return context.task.task_get(
         profile=args.profile,
-        app_key=args.app_key,
-        record_id=args.record_id,
-        workflow_node_id=args.workflow_node_id,
+        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=bool(args.include_candidates),
         include_associated_reports=bool(args.include_associated_reports),
     )
 
 
 def _handle_action(args: argparse.Namespace, context: CliContext) -> dict:
+    if not args.task_id and not (args.app_key and args.record_id and args.workflow_node_id):
+        raise RuntimeError(
+            '{"category":"config","message":"task action requires --task-id, or --app-key together with --record-id and --workflow-node-id"}'
+        )
     return context.task.task_action_execute(
         profile=args.profile,
-        app_key=args.app_key,
-        record_id=args.record_id,
-        workflow_node_id=args.workflow_node_id,
+        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=load_object_arg(args.payload_file, option_name="--payload-file") or {},
         fields=load_object_arg(args.fields_file, option_name="--fields-file") or {},
@@ -81,9 +111,31 @@ def _handle_action(args: argparse.Namespace, context: CliContext) -> dict:
 
 
 def _handle_log(args: argparse.Namespace, context: CliContext) -> dict:
+    if not args.task_id and not (args.app_key and args.record_id and args.workflow_node_id):
+        raise RuntimeError(
+            '{"category":"config","message":"task log requires --task-id, or --app-key together with --record-id and --workflow-node-id"}'
+        )
     return context.task.task_workflow_log_get(
         profile=args.profile,
-        app_key=args.app_key,
-        record_id=args.record_id,
-        workflow_node_id=args.workflow_node_id,
+        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),
+    )
+
+
+def _handle_report(args: argparse.Namespace, context: CliContext) -> dict:
+    if not args.task_id and not (args.app_key and args.record_id and args.workflow_node_id):
+        raise RuntimeError(
+            '{"category":"config","message":"task report requires --task-id, or --app-key together with --record-id and --workflow-node-id"}'
+        )
+    return context.task.task_associated_report_detail_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),
+        report_id=int(args.report_id),
+        page=int(args.page),
+        page_size=int(args.page_size),
     )

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

@@ -15,6 +15,14 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     list_parser.add_argument("--include-external", action="store_true")
     list_parser.set_defaults(handler=_handle_list, format_hint="workspace_list")
 
+    get_parser = workspace_subparsers.add_parser("get", help="读取工作区详情")
+    get_parser.add_argument("--ws-id", type=int, default=0)
+    get_parser.set_defaults(handler=_handle_get, format_hint="workspace_get")
+
+    select_parser = workspace_subparsers.add_parser("select", help="切换当前工作区")
+    select_parser.add_argument("--ws-id", type=int, required=True)
+    select_parser.set_defaults(handler=_handle_select, format_hint="workspace_get")
+
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
     return context.workspace.workspace_list(
@@ -23,3 +31,17 @@ def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
         page_size=args.page_size,
         include_external=bool(args.include_external),
     )
+
+
+def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.workspace.workspace_get(
+        profile=args.profile,
+        ws_id=args.ws_id if int(args.ws_id or 0) > 0 else None,
+    )
+
+
+def _handle_select(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.workspace.workspace_select(
+        profile=args.profile,
+        ws_id=int(args.ws_id),
+    )