@josephyan/qingflow-cli 0.2.0-beta.55 → 0.2.0-beta.56

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-cli@0.2.0-beta.55
+npm install @josephyan/qingflow-cli@0.2.0-beta.56
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-cli@0.2.0-beta.55 qingflow
+npx -y -p @josephyan/qingflow-cli@0.2.0-beta.56 qingflow
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-cli",
-  "version": "0.2.0-beta.55",
+  "version": "0.2.0-beta.56",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

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

@@ -6,29 +6,29 @@ from ..context import CliContext
 
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser("app", help="应用发现")
-    app_subparsers = parser.add_subparsers(dest="app_command", required=True)
+    parser = subparsers.add_parser("apps", help="应用发现")
+    app_subparsers = parser.add_subparsers(dest="apps_command", required=True)
 
     list_parser = app_subparsers.add_parser("list", help="列出可见应用")
-    list_parser.set_defaults(handler=_handle_list, format_hint="app_list")
+    list_parser.set_defaults(handler=_handle_list, format_hint="apps_list")
 
-    search = app_subparsers.add_parser("search", help="搜索应用")
-    search.add_argument("--keyword", default="")
-    search.add_argument("--page", type=int, default=1)
-    search.add_argument("--page-size", type=int, default=50)
-    search.set_defaults(handler=_handle_search, format_hint="app_search")
+    find = app_subparsers.add_parser("find", help="搜索应用")
+    find.add_argument("--keyword", default="")
+    find.add_argument("--page", type=int, default=1)
+    find.add_argument("--page-size", type=int, default=50)
+    find.set_defaults(handler=_handle_find, format_hint="apps_list")
 
-    get = app_subparsers.add_parser("get", help="读取应用可访问视图与导入能力")
-    get.add_argument("--app-key", required=True)
-    get.set_defaults(handler=_handle_get, format_hint="app_get")
+    show = app_subparsers.add_parser("show", help="读取应用信息")
+    show.add_argument("--app", required=True)
+    show.set_defaults(handler=_handle_show, format_hint="app_show")
 
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_list(profile=args.profile)
+    return context.apps.list(profile=args.profile)
 
 
-def _handle_search(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_search(
+def _handle_find(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.apps.find(
         profile=args.profile,
         keyword=args.keyword,
         page_num=args.page,
@@ -36,5 +36,5 @@ def _handle_search(args: argparse.Namespace, context: CliContext) -> dict:
     )
 
 
-def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_get(profile=args.profile, app_key=args.app_key)
+def _handle_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.apps.show(profile=args.profile, app_key=args.app)

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

@@ -10,33 +10,34 @@ from .common import read_secret_arg
 
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser("auth", help="认证与会话")
-    auth_subparsers = parser.add_subparsers(dest="auth_command", required=True)
+    me = subparsers.add_parser("me", help="查看当前会话")
+    me.set_defaults(handler=_handle_me, format_hint="me")
 
-    login = auth_subparsers.add_parser("login", help="邮箱密码登录")
+    login = subparsers.add_parser("login", help="邮箱密码登录")
     login.add_argument("--base-url")
     login.add_argument("--qf-version")
     login.add_argument("--email", required=True)
     login.add_argument("--password")
     login.add_argument("--password-stdin", action="store_true")
     login.add_argument("--persist", action=argparse.BooleanOptionalAction, default=True)
-    login.set_defaults(handler=_handle_login, format_hint="auth_whoami")
+    login.set_defaults(handler=_handle_login, format_hint="session")
 
-    use_token = auth_subparsers.add_parser("use-token", help="直接注入 token")
+    use_token = subparsers.add_parser("use-token", help="直接接入 token")
     use_token.add_argument("--base-url")
     use_token.add_argument("--qf-version")
     use_token.add_argument("--token")
     use_token.add_argument("--token-stdin", action="store_true")
-    use_token.add_argument("--ws-id", type=int)
+    use_token.add_argument("--ws", dest="ws_id", type=int)
     use_token.add_argument("--persist", action=argparse.BooleanOptionalAction, default=False)
-    use_token.set_defaults(handler=_handle_use_token, format_hint="auth_whoami")
+    use_token.set_defaults(handler=_handle_use_token, format_hint="session")
 
-    whoami = auth_subparsers.add_parser("whoami", help="查看当前登录态")
-    whoami.set_defaults(handler=_handle_whoami, format_hint="auth_whoami")
-
-    logout = auth_subparsers.add_parser("logout", help="退出登录")
+    logout = subparsers.add_parser("logout", help="退出当前会话")
     logout.add_argument("--forget-persisted", action="store_true")
-    logout.set_defaults(handler=_handle_logout, format_hint="")
+    logout.set_defaults(handler=_handle_logout, format_hint="session")
+
+
+def _handle_me(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.auth.me(profile=args.profile)
 
 
 def _handle_login(args: argparse.Namespace, context: CliContext) -> dict:
@@ -48,7 +49,7 @@ def _handle_login(args: argparse.Namespace, context: CliContext) -> dict:
             password = getpass.getpass("Password: ")
         else:
             raise QingflowApiError.config_error("password is required; use --password or --password-stdin")
-    return context.auth.auth_login(
+    return context.auth.login(
         profile=args.profile,
         base_url=args.base_url,
         qf_version=args.qf_version,
@@ -60,7 +61,7 @@ def _handle_login(args: argparse.Namespace, context: CliContext) -> dict:
 
 def _handle_use_token(args: argparse.Namespace, context: CliContext) -> dict:
     token = read_secret_arg(args.token, stdin_enabled=bool(args.token_stdin), label="token")
-    return context.auth.auth_use_token(
+    return context.auth.use_token(
         profile=args.profile,
         base_url=args.base_url,
         qf_version=args.qf_version,
@@ -70,9 +71,5 @@ def _handle_use_token(args: argparse.Namespace, context: CliContext) -> dict:
     )
 
 
-def _handle_whoami(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.auth.auth_whoami(profile=args.profile)
-
-
 def _handle_logout(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.auth.auth_logout(profile=args.profile, forget_persisted=bool(args.forget_persisted))
+    return context.auth.logout(profile=args.profile, forget_persisted=bool(args.forget_persisted))

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

@@ -1,184 +1,199 @@
 from __future__ import annotations
 
 import argparse
+from typing import Any
 
+from ...errors import QingflowApiError
 from ..context import CliContext
-from .common import load_list_arg, load_object_arg, require_list_arg
+from .common import add_file_arg, add_stdin_json_flag, load_object_input
 
 
 def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
-    parser = subparsers.add_parser("builder", help="稳定 builder 命令")
-    builder_subparsers = parser.add_subparsers(dest="builder_command", required=True)
+    parser = subparsers.add_parser("build", help="稳定搭建能力")
+    build_subparsers = parser.add_subparsers(dest="build_command", required=True)
 
-    package = builder_subparsers.add_parser("package", help="应用包")
-    package_subparsers = package.add_subparsers(dest="builder_package_command", required=True)
+    package = build_subparsers.add_parser("package", help="应用包")
+    package_subparsers = package.add_subparsers(dest="build_package_command", required=True)
     package_resolve = package_subparsers.add_parser("resolve", help="解析应用包")
-    package_resolve.add_argument("--package-name", required=True)
-    package_resolve.set_defaults(handler=_handle_package_resolve, format_hint="builder_summary")
-
-    app = builder_subparsers.add_parser("app", help="应用")
-    app_subparsers = app.add_subparsers(dest="builder_app_command", required=True)
+    package_resolve.add_argument("--name", required=True)
+    package_resolve.set_defaults(handler=_handle_package_resolve, format_hint="builder_result")
 
+    app = build_subparsers.add_parser("app", help="应用")
+    app_subparsers = app.add_subparsers(dest="build_app_command", required=True)
     app_resolve = app_subparsers.add_parser("resolve", help="解析应用")
     app_resolve.add_argument("--app-key", default="")
-    app_resolve.add_argument("--app-name", default="")
+    app_resolve.add_argument("--name", default="")
     app_resolve.add_argument("--package-tag-id", type=int)
-    app_resolve.set_defaults(handler=_handle_app_resolve, format_hint="builder_summary")
-
-    for name, help_text, handler in [
-        ("read-summary", "读取应用摘要", _handle_app_read_summary),
-        ("read-fields", "读取字段摘要", _handle_app_read_fields),
-        ("read-layout", "读取布局摘要", _handle_app_read_layout),
-        ("read-views", "读取视图摘要", _handle_app_read_views),
-        ("read-flow", "读取流程摘要", _handle_app_read_flow),
-        ("read-charts", "读取报表摘要", _handle_app_read_charts),
-    ]:
-        sub = app_subparsers.add_parser(name, help=help_text)
-        sub.add_argument("--app-key", required=True)
-        sub.set_defaults(handler=handler, format_hint="builder_summary")
-
-    portal = builder_subparsers.add_parser("portal", help="门户")
-    portal_subparsers = portal.add_subparsers(dest="builder_portal_command", required=True)
-    portal_read = portal_subparsers.add_parser("read-summary", help="读取门户摘要")
-    portal_read.add_argument("--dash-key", required=True)
-    portal_read.add_argument("--being-draft", action=argparse.BooleanOptionalAction, default=True)
-    portal_read.set_defaults(handler=_handle_portal_read_summary, format_hint="builder_summary")
-
-    portal_apply = portal_subparsers.add_parser("apply", help="更新门户")
-    portal_apply.add_argument("--dash-key", default="")
-    portal_apply.add_argument("--dash-name", default="")
+    app_resolve.set_defaults(handler=_handle_app_resolve, format_hint="builder_result")
+
+    app_show = app_subparsers.add_parser("show", help="读取应用摘要")
+    app_show.add_argument("--app", required=True)
+    app_show.set_defaults(handler=_handle_app_show, format_hint="builder_result")
+
+    fields = build_subparsers.add_parser("fields", help="字段")
+    fields_subparsers = fields.add_subparsers(dest="build_fields_command", required=True)
+    fields_show = fields_subparsers.add_parser("show", help="读取字段摘要")
+    fields_show.add_argument("--app", required=True)
+    fields_show.set_defaults(handler=_handle_fields_show, format_hint="builder_result")
+    fields_apply = fields_subparsers.add_parser("apply", help="执行字段变更")
+    fields_apply.add_argument("--app", default="")
+    fields_apply.add_argument("--package-tag-id", type=int)
+    fields_apply.add_argument("--name", dest="app_name", default="")
+    fields_apply.add_argument("--title", dest="app_title", default="")
+    fields_apply.add_argument("--create-if-missing", action="store_true")
+    fields_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
+    add_file_arg(fields_apply, required=False, help_text="读取字段变更 JSON，支持 add_fields/update_fields/remove_fields")
+    add_stdin_json_flag(fields_apply)
+    fields_apply.set_defaults(handler=_handle_fields_apply, format_hint="builder_result")
+
+    layout = build_subparsers.add_parser("layout", help="布局")
+    layout_subparsers = layout.add_subparsers(dest="build_layout_command", required=True)
+    layout_show = layout_subparsers.add_parser("show", help="读取布局摘要")
+    layout_show.add_argument("--app", required=True)
+    layout_show.set_defaults(handler=_handle_layout_show, format_hint="builder_result")
+
+    views = build_subparsers.add_parser("views", help="视图")
+    views_subparsers = views.add_subparsers(dest="build_views_command", required=True)
+    views_show = views_subparsers.add_parser("show", help="读取视图摘要")
+    views_show.add_argument("--app", required=True)
+    views_show.set_defaults(handler=_handle_views_show, format_hint="builder_result")
+
+    flow = build_subparsers.add_parser("flow", help="流程")
+    flow_subparsers = flow.add_subparsers(dest="build_flow_command", required=True)
+    flow_show = flow_subparsers.add_parser("show", help="读取流程摘要")
+    flow_show.add_argument("--app", required=True)
+    flow_show.set_defaults(handler=_handle_flow_show, format_hint="builder_result")
+
+    charts = build_subparsers.add_parser("charts", help="报表")
+    charts_subparsers = charts.add_subparsers(dest="build_charts_command", required=True)
+    charts_show = charts_subparsers.add_parser("show", help="读取报表摘要")
+    charts_show.add_argument("--app", required=True)
+    charts_show.set_defaults(handler=_handle_charts_show, format_hint="builder_result")
+    charts_apply = charts_subparsers.add_parser("apply", help="执行报表变更")
+    charts_apply.add_argument("--app", required=True)
+    add_file_arg(charts_apply, required=False, help_text="读取报表变更 JSON，支持 upsert_charts/remove_chart_ids/reorder_chart_ids")
+    add_stdin_json_flag(charts_apply)
+    charts_apply.set_defaults(handler=_handle_charts_apply, format_hint="builder_result")
+
+    portal = build_subparsers.add_parser("portal", help="门户")
+    portal_subparsers = portal.add_subparsers(dest="build_portal_command", required=True)
+    portal_show = portal_subparsers.add_parser("show", help="读取门户摘要")
+    portal_show.add_argument("--dash", required=True)
+    portal_show.add_argument("--draft", action=argparse.BooleanOptionalAction, default=True)
+    portal_show.set_defaults(handler=_handle_portal_show, format_hint="builder_result")
+    portal_apply = portal_subparsers.add_parser("apply", help="执行门户变更")
+    portal_apply.add_argument("--dash", default="")
+    portal_apply.add_argument("--name", dest="dash_name", default="")
     portal_apply.add_argument("--package-tag-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("--auth-file")
-    portal_apply.add_argument("--icon")
-    portal_apply.add_argument("--color")
-    portal_apply.add_argument("--hide-copyright", action=argparse.BooleanOptionalAction, default=None)
-    portal_apply.add_argument("--dash-global-config-file")
-    portal_apply.add_argument("--config-file")
-    portal_apply.set_defaults(handler=_handle_portal_apply, format_hint="builder_summary")
-
-    schema_apply = builder_subparsers.add_parser("schema", help="字段搭建")
-    schema_apply_subparsers = schema_apply.add_subparsers(dest="builder_schema_command", required=True)
-    schema_apply_apply = schema_apply_subparsers.add_parser("apply", help="执行字段变更")
-    schema_apply_apply.add_argument("--app-key", default="")
-    schema_apply_apply.add_argument("--package-tag-id", type=int)
-    schema_apply_apply.add_argument("--app-name", default="")
-    schema_apply_apply.add_argument("--app-title", default="")
-    schema_apply_apply.add_argument("--create-if-missing", action="store_true")
-    schema_apply_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
-    schema_apply_apply.add_argument("--add-fields-file")
-    schema_apply_apply.add_argument("--update-fields-file")
-    schema_apply_apply.add_argument("--remove-fields-file")
-    schema_apply_apply.set_defaults(handler=_handle_schema_apply, format_hint="builder_summary")
-
-    charts_apply = builder_subparsers.add_parser("charts", help="报表")
-    charts_apply_subparsers = charts_apply.add_subparsers(dest="builder_charts_command", required=True)
-    charts_apply_apply = charts_apply_subparsers.add_parser("apply", help="执行报表变更")
-    charts_apply_apply.add_argument("--app-key", required=True)
-    charts_apply_apply.add_argument("--upsert-file")
-    charts_apply_apply.add_argument("--remove-chart-ids-file")
-    charts_apply_apply.add_argument("--reorder-chart-ids-file")
-    charts_apply_apply.set_defaults(handler=_handle_charts_apply, format_hint="builder_summary")
-
-    publish_verify = builder_subparsers.add_parser("publish", help="发布校验")
-    publish_verify_subparsers = publish_verify.add_subparsers(dest="builder_publish_command", required=True)
-    publish_verify_verify = publish_verify_subparsers.add_parser("verify", help="校验应用发布")
-    publish_verify_verify.add_argument("--app-key", required=True)
-    publish_verify_verify.add_argument("--expected-package-tag-id", type=int)
-    publish_verify_verify.set_defaults(handler=_handle_publish_verify, format_hint="builder_summary")
+    add_file_arg(portal_apply, required=True, help_text="读取门户变更 JSON，至少包含 sections")
+    add_stdin_json_flag(portal_apply)
+    portal_apply.set_defaults(handler=_handle_portal_apply, format_hint="builder_result")
+
+    publish = build_subparsers.add_parser("publish", help="发布校验")
+    publish_subparsers = publish.add_subparsers(dest="build_publish_command", required=True)
+    publish_verify = publish_subparsers.add_parser("verify", help="校验应用发布")
+    publish_verify.add_argument("--app", required=True)
+    publish_verify.add_argument("--expected-package-tag-id", type=int)
+    publish_verify.set_defaults(handler=_handle_publish_verify, format_hint="builder_result")
 
 
 def _handle_package_resolve(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.package_resolve(profile=args.profile, package_name=args.package_name)
+    return context.build.package_resolve(profile=args.profile, package_name=args.name)
 
 
 def _handle_app_resolve(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_resolve(
+    return context.build.app_resolve(
         profile=args.profile,
         app_key=args.app_key,
-        app_name=args.app_name,
+        app_name=args.name,
         package_tag_id=args.package_tag_id,
     )
 
 
-def _handle_app_read_summary(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_summary(profile=args.profile, app_key=args.app_key)
+def _handle_app_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.app_show(profile=args.profile, app_key=args.app)
 
 
-def _handle_app_read_fields(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_fields(profile=args.profile, app_key=args.app_key)
+def _handle_fields_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.fields_show(profile=args.profile, app_key=args.app)
 
 
-def _handle_app_read_layout(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_layout_summary(profile=args.profile, app_key=args.app_key)
+def _handle_fields_apply(args: argparse.Namespace, context: CliContext) -> dict:
+    payload = load_object_input(args, required=False)
+    return context.build.fields_apply(
+        profile=args.profile,
+        app_key=args.app,
+        package_tag_id=args.package_tag_id,
+        app_name=args.app_name,
+        app_title=args.app_title,
+        create_if_missing=bool(args.create_if_missing),
+        publish=bool(args.publish),
+        add_fields=_coerce_list(payload.get("add_fields")),
+        update_fields=_coerce_list(payload.get("update_fields")),
+        remove_fields=_coerce_list(payload.get("remove_fields")),
+    )
 
 
-def _handle_app_read_views(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_views_summary(profile=args.profile, app_key=args.app_key)
+def _handle_layout_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.layout_show(profile=args.profile, app_key=args.app)
 
 
-def _handle_app_read_flow(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_flow_summary(profile=args.profile, app_key=args.app_key)
+def _handle_views_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.views_show(profile=args.profile, app_key=args.app)
 
 
-def _handle_app_read_charts(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_charts_summary(profile=args.profile, app_key=args.app_key)
+def _handle_flow_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.flow_show(profile=args.profile, app_key=args.app)
 
 
-def _handle_portal_read_summary(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.portal_read_summary(
-        profile=args.profile,
-        dash_key=args.dash_key,
-        being_draft=bool(args.being_draft),
-    )
+def _handle_charts_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.charts_show(profile=args.profile, app_key=args.app)
 
 
-def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_schema_apply(
+def _handle_charts_apply(args: argparse.Namespace, context: CliContext) -> dict:
+    payload = load_object_input(args, required=False)
+    return context.build.charts_apply(
         profile=args.profile,
-        app_key=args.app_key,
-        package_tag_id=args.package_tag_id,
-        app_name=args.app_name,
-        app_title=args.app_title,
-        create_if_missing=bool(args.create_if_missing),
-        publish=bool(args.publish),
-        add_fields=load_list_arg(args.add_fields_file, option_name="--add-fields-file"),
-        update_fields=load_list_arg(args.update_fields_file, option_name="--update-fields-file"),
-        remove_fields=load_list_arg(args.remove_fields_file, option_name="--remove-fields-file"),
+        app_key=args.app,
+        upsert_charts=_coerce_list(payload.get("upsert_charts")),
+        remove_chart_ids=_coerce_list(payload.get("remove_chart_ids")),
+        reorder_chart_ids=_coerce_list(payload.get("reorder_chart_ids")),
     )
 
 
-def _handle_charts_apply(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_charts_apply(
-        profile=args.profile,
-        app_key=args.app_key,
-        upsert_charts=load_list_arg(args.upsert_file, option_name="--upsert-file"),
-        remove_chart_ids=load_list_arg(args.remove_chart_ids_file, option_name="--remove-chart-ids-file"),
-        reorder_chart_ids=load_list_arg(args.reorder_chart_ids_file, option_name="--reorder-chart-ids-file"),
-    )
+def _handle_portal_show(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.build.portal_show(profile=args.profile, dash_key=args.dash, being_draft=bool(args.draft))
 
 
 def _handle_portal_apply(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.portal_apply(
+    payload = load_object_input(args, required=True)
+    sections = payload.get("sections")
+    if not isinstance(sections, list) or not sections:
+        raise QingflowApiError.config_error("sections must be a non-empty list")
+    return context.build.portal_apply(
         profile=args.profile,
-        dash_key=args.dash_key,
+        dash_key=args.dash,
         dash_name=args.dash_name,
         package_tag_id=args.package_tag_id,
         publish=bool(args.publish),
-        sections=require_list_arg(args.sections_file, option_name="--sections-file"),
-        auth=load_object_arg(args.auth_file, option_name="--auth-file"),
-        icon=args.icon,
-        color=args.color,
-        hide_copyright=args.hide_copyright,
-        dash_global_config=load_object_arg(args.dash_global_config_file, option_name="--dash-global-config-file"),
-        config=load_object_arg(args.config_file, option_name="--config-file"),
+        sections=sections,
+        auth=payload.get("auth") if isinstance(payload.get("auth"), dict) else None,
+        icon=payload.get("icon") if isinstance(payload.get("icon"), str) else None,
+        color=payload.get("color") if isinstance(payload.get("color"), str) else None,
+        hide_copyright=payload.get("hide_copyright") if isinstance(payload.get("hide_copyright"), bool) else None,
+        dash_global_config=payload.get("dash_global_config") if isinstance(payload.get("dash_global_config"), dict) else None,
+        config=payload.get("config") if isinstance(payload.get("config"), dict) else None,
     )
 
 
 def _handle_publish_verify(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_publish_verify(
+    return context.build.publish_verify(
         profile=args.profile,
-        app_key=args.app_key,
+        app_key=args.app,
         expected_package_tag_id=args.expected_package_tag_id,
     )
+
+
+def _coerce_list(value: Any) -> list[Any]:
+    return value if isinstance(value, list) else []

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

@@ -1,11 +1,12 @@
 from __future__ import annotations
 
 import argparse
+import json
 import sys
 from typing import Any
 
 from ...errors import QingflowApiError
-from ..json_io import load_json_list, load_json_object, load_optional_json_list, load_optional_json_object
+from ..json_io import load_json_list, load_json_object
 
 
 def parse_bool_text(value: str) -> bool:
@@ -17,26 +18,6 @@ def parse_bool_text(value: str) -> bool:
     raise argparse.ArgumentTypeError("expected one of: true, false, 1, 0, yes, no")
 
 
-def load_list_arg(path: str | None, *, option_name: str) -> list[Any]:
-    return load_optional_json_list(path, option_name=option_name)
-
-
-def load_object_arg(path: str | None, *, option_name: str) -> dict[str, Any] | None:
-    return load_optional_json_object(path, option_name=option_name)
-
-
-def require_list_arg(path: str | None, *, option_name: str) -> list[Any]:
-    if not path:
-        raise QingflowApiError.config_error(f"{option_name} is required")
-    return load_json_list(path, option_name=option_name)
-
-
-def require_object_arg(path: str | None, *, option_name: str) -> dict[str, Any]:
-    if not path:
-        raise QingflowApiError.config_error(f"{option_name} is required")
-    return load_json_object(path, option_name=option_name)
-
-
 def read_secret_arg(value: str | None, *, stdin_enabled: bool, label: str) -> str:
     if stdin_enabled:
         secret = sys.stdin.read().strip()
@@ -45,3 +26,96 @@ def read_secret_arg(value: str | None, *, stdin_enabled: bool, label: str) -> st
     if value:
         return value
     raise QingflowApiError.config_error(f"{label} is required")
+
+
+def add_stdin_json_flag(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("--stdin-json", action="store_true", help="从标准输入读取 JSON")
+
+
+def add_file_arg(parser: argparse.ArgumentParser, *, required: bool = False, help_text: str = "从文件读取 JSON") -> None:
+    parser.add_argument("--file", required=required, help=help_text)
+
+
+def add_field_args(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("--field", dest="fields", action="append", default=[], help="字段赋值，格式：字段名=值")
+
+
+def load_object_input(args: argparse.Namespace, *, required: bool = False) -> dict[str, Any]:
+    if getattr(args, "stdin_json", False):
+        payload = _read_stdin_json()
+        if not isinstance(payload, dict):
+            raise QingflowApiError.config_error("stdin JSON must be an object")
+        return payload
+    file_path = getattr(args, "file", None)
+    if file_path:
+        return load_json_object(file_path, option_name="--file")
+    if required:
+        raise QingflowApiError.config_error("either --stdin-json or --file is required")
+    return {}
+
+
+def load_list_input(args: argparse.Namespace, *, required: bool = False) -> list[Any]:
+    if getattr(args, "stdin_json", False):
+        payload = _read_stdin_json()
+        if not isinstance(payload, list):
+            raise QingflowApiError.config_error("stdin JSON must be a list")
+        return payload
+    file_path = getattr(args, "file", None)
+    if file_path:
+        return load_json_list(file_path, option_name="--file")
+    if required:
+        raise QingflowApiError.config_error("either --stdin-json or --file is required")
+    return []
+
+
+def parse_field_assignments(items: list[str]) -> dict[str, Any]:
+    payload: dict[str, Any] = {}
+    for item in items:
+        if "=" not in item:
+            raise QingflowApiError.config_error("field assignments must use name=value format")
+        key, raw_value = item.split("=", 1)
+        name = key.strip()
+        if not name:
+            raise QingflowApiError.config_error("field name cannot be empty")
+        payload[name] = _coerce_value(raw_value)
+    return payload
+
+
+def merge_object_inputs(args: argparse.Namespace, *, allow_empty: bool = False) -> dict[str, Any]:
+    payload = parse_field_assignments(list(getattr(args, "fields", []) or []))
+    if getattr(args, "stdin_json", False) or getattr(args, "file", None):
+        loaded = load_object_input(args, required=False)
+        payload.update(loaded)
+    if not payload and not allow_empty:
+        raise QingflowApiError.config_error("provide at least one --field or pass --stdin-json/--file")
+    return payload
+
+
+def _read_stdin_json() -> Any:
+    raw = sys.stdin.read()
+    if not raw.strip():
+        raise QingflowApiError.config_error("stdin JSON is empty")
+    try:
+        return json.loads(raw)
+    except json.JSONDecodeError as error:
+        raise QingflowApiError.config_error(f"stdin JSON is invalid: {error.msg}") from error
+
+
+def _coerce_value(raw: str) -> Any:
+    text = raw.strip()
+    if not text:
+        return ""
+    if text.startswith("{") or text.startswith("[") or text.startswith('"'):
+        try:
+            return json.loads(text)
+        except json.JSONDecodeError:
+            return raw
+    normalized = text.lower()
+    if normalized in {"true", "false", "null"}:
+        return json.loads(normalized)
+    try:
+        if "." in text:
+            return float(text)
+        return int(text)
+    except ValueError:
+        return raw