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

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

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import argparse
 
-from . import app, auth, builder, chart, imports, portal, record, task, view, workspace
+from . import app, auth, builder, chart, exports, imports, portal, record, task, view, workspace
 
 
 def register_all_commands(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
@@ -14,5 +14,6 @@ def register_all_commands(subparsers: argparse._SubParsersAction[argparse.Argume
     chart.register(subparsers)
     record.register(subparsers)
     imports.register(subparsers)
+    exports.register(subparsers)
     task.register(subparsers)
     builder.register(subparsers)

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

@@ -3,6 +3,9 @@ from __future__ import annotations
 import argparse
 
 from ..context import CliContext
+from ..interaction import cancelled_result, resolve_interactive_selection
+from ..terminal_ui import SelectionOption
+from .common import raise_config_error
 
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
@@ -19,7 +22,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     search.set_defaults(handler=_handle_search, format_hint="app_search")
 
     get = app_subparsers.add_parser("get", help="读取应用可访问视图与导入能力")
-    get.add_argument("--app-key", required=True)
+    get.add_argument("--app-key", help="不传时在交互终端中选择应用")
     get.set_defaults(handler=_handle_get, format_hint="app_get")
 
 
@@ -37,4 +40,47 @@ def _handle_search(args: argparse.Namespace, context: CliContext) -> dict:
 
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    if not (args.app_key or "").strip():
+        selection = _choose_app_interactively(args, context)
+        if selection.status == "unavailable":
+            raise_config_error(
+                "app get requires --app-key, or an interactive terminal to choose an app",
+                fix_hint="Run `app list` to inspect visible apps, or retry with `--app-key APP_KEY`.",
+            )
+        if selection.status == "empty":
+            raise_config_error(
+                selection.message or "app get could not open a selector because no visible apps were returned.",
+                fix_hint="Run `app list` to confirm visible apps, or retry with `--app-key APP_KEY`.",
+            )
+        if selection.status == "cancelled":
+            return cancelled_result(selection.message or "已取消")
+        args.app_key = str(selection.value or "")
     return context.app.app_get(profile=args.profile, app_key=args.app_key)
+
+
+def _choose_app_interactively(args: argparse.Namespace, context: CliContext):
+    def load_options() -> list[SelectionOption[str]]:
+        result = context.app.app_list(profile=args.profile)
+        items = result.get("items") if isinstance(result, dict) and isinstance(result.get("items"), list) else []
+        options: list[SelectionOption[str]] = []
+        for item in items:
+            if not isinstance(item, dict):
+                continue
+            app_key = str(item.get("app_key") or "").strip()
+            if not app_key:
+                continue
+            app_name = str(item.get("app_name") or app_key).strip() or app_key
+            package_name = str(item.get("package_name") or "").strip()
+            hint = f"app_key={app_key}"
+            if package_name:
+                hint += f" · package={package_name}"
+            options.append(SelectionOption(value=app_key, label=app_name, hint=hint))
+        return options
+
+    return resolve_interactive_selection(
+        args,
+        title="选择应用",
+        unavailable_message="app get requires --app-key, or an interactive terminal to choose an app",
+        empty_message="app get could not open a selector because no visible apps were returned.",
+        load_options=load_options,
+    )

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")
@@ -26,6 +39,56 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     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")

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="?",
@@ -120,6 +120,9 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     button = builder_subparsers.add_parser("button", help="自定义按钮")
     button_subparsers = button.add_subparsers(dest="builder_button_command", required=True)
 
+    button_catalog = button_subparsers.add_parser("catalog", help="读取按钮样式目录")
+    button_catalog.set_defaults(handler=_handle_button_catalog, format_hint="builder_summary")
+
     button_list = button_subparsers.add_parser("list", help="列出自定义按钮")
     button_list.add_argument("--app-key", required=True)
     button_list.set_defaults(handler=_handle_button_list, format_hint="builder_summary")
@@ -160,7 +163,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")
@@ -362,6 +365,10 @@ def _handle_button_list(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.app_custom_button_list(profile=args.profile, app_key=args.app_key)
 
 
+def _handle_button_catalog(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.button_style_catalog_get(profile=args.profile)
+
+
 def _handle_button_get(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.app_custom_button_get(profile=args.profile, app_key=args.app_key, button_id=args.button_id)
 
@@ -513,13 +520,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/exports.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import argparse
+
+from ..context import CliContext
+from .common import load_list_arg
+
+
+def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser("export", help="导出")
+    export_subparsers = parser.add_subparsers(dest="export_command", required=True)
+
+    start = export_subparsers.add_parser("start", help="启动导出")
+    start.add_argument("--app-key", required=True)
+    start.add_argument("--view-id", default="system:all")
+    start.add_argument("--column", dest="columns", action="append", type=int, default=[], help="只导出这些 field_id；不传时导出当前视图全部字段")
+    start.add_argument("--columns-file", help="JSON/YAML list，内容与 --column 语义一致")
+    start.add_argument("--where-file", help="JSON/YAML list，内容与 record list 的 where DSL 一致；内部先查命中 record_id 再走原生导出")
+    start.add_argument("--order-by-file", help="JSON/YAML list，内容与 record list 的 order_by DSL 一致；内部查询和导出记录顺序保持一致")
+    start.add_argument("--record-id", dest="record_ids", action="append", default=[], help="只导出这些 record_id；不传时导出当前视图全部数据")
+    start.add_argument("--record-ids-file", help="JSON/YAML list，内容与 --record-id 语义一致")
+    start.add_argument("--include-workflow-log", action=argparse.BooleanOptionalAction, default=False, help="是否同时导出流程日志")
+    start.set_defaults(handler=_handle_start, format_hint="export_start")
+
+    status = export_subparsers.add_parser("status", help="查询导出状态")
+    status.add_argument("--export-handle", required=True)
+    status.set_defaults(handler=_handle_status, format_hint="export_status")
+
+    get = export_subparsers.add_parser("get", help="获取导出结果")
+    get.add_argument("--export-handle", required=True)
+    get.add_argument("--download-to-path")
+    get.set_defaults(handler=_handle_get, format_hint="export_get")
+
+    direct = export_subparsers.add_parser("direct", help="直接导出并下载")
+    direct.add_argument("--app-key", required=True)
+    direct.add_argument("--view-id", default="system:all")
+    direct.add_argument("--column", dest="columns", action="append", type=int, default=[], help="只导出这些 field_id；不传时导出当前视图全部字段")
+    direct.add_argument("--columns-file", help="JSON/YAML list，内容与 --column 语义一致")
+    direct.add_argument("--where-file", help="JSON/YAML list，内容与 record list 的 where DSL 一致；内部先查命中 record_id 再走原生导出")
+    direct.add_argument("--order-by-file", help="JSON/YAML list，内容与 record list 的 order_by DSL 一致；内部查询和导出记录顺序保持一致")
+    direct.add_argument("--record-id", dest="record_ids", action="append", default=[], help="只导出这些 record_id；不传时导出当前视图全部数据")
+    direct.add_argument("--record-ids-file", help="JSON/YAML list，内容与 --record-id 语义一致")
+    direct.add_argument("--include-workflow-log", action=argparse.BooleanOptionalAction, default=False, help="是否同时导出流程日志")
+    direct.add_argument("--download-to-path")
+    direct.add_argument("--wait-timeout-seconds", type=float)
+    direct.set_defaults(handler=_handle_direct, format_hint="export_direct")
+
+
+def _columns(args: argparse.Namespace) -> list[int | dict]:
+    columns: list[int | dict] = list(args.columns or [])
+    if args.columns_file:
+        columns.extend(load_list_arg(args.columns_file, option_name="--columns-file"))
+    return columns
+
+
+def _record_ids(args: argparse.Namespace) -> list[str | int]:
+    record_ids: list[str | int] = list(args.record_ids or [])
+    if args.record_ids_file:
+        record_ids.extend(load_list_arg(args.record_ids_file, option_name="--record-ids-file"))
+    return record_ids
+
+
+def _where(args: argparse.Namespace) -> list[dict]:
+    return load_list_arg(args.where_file, option_name="--where-file") if args.where_file else []
+
+
+def _order_by(args: argparse.Namespace) -> list[dict]:
+    return load_list_arg(args.order_by_file, option_name="--order-by-file") if args.order_by_file else []
+
+
+def _handle_start(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.exports.record_export_start(
+        profile=args.profile,
+        app_key=args.app_key,
+        view_id=args.view_id,
+        columns=_columns(args),
+        where=_where(args),
+        order_by=_order_by(args),
+        record_ids=_record_ids(args),
+        include_workflow_log=args.include_workflow_log,
+    )
+
+
+def _handle_status(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.exports.record_export_status_get(
+        profile=args.profile,
+        export_handle=args.export_handle,
+    )
+
+
+def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.exports.record_export_get(
+        profile=args.profile,
+        export_handle=args.export_handle,
+        download_to_path=args.download_to_path,
+    )
+
+
+def _handle_direct(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.exports.record_export_direct(
+        profile=args.profile,
+        app_key=args.app_key,
+        view_id=args.view_id,
+        columns=_columns(args),
+        where=_where(args),
+        order_by=_order_by(args),
+        record_ids=_record_ids(args),
+        include_workflow_log=args.include_workflow_log,
+        download_to_path=args.download_to_path,
+        wait_timeout_seconds=args.wait_timeout_seconds,
+    )

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)