@josephyan/qingflow-cli 0.2.0-beta.71 → 0.2.0-beta.72

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

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

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

@@ -76,6 +76,16 @@ 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.add_argument(
+        "builder_app_get_section",
+        nargs="?",
+        choices=["summary", "fields", "layout", "views", "flow", "charts"],
+        default="summary",
+    )
+    app_get.add_argument("--app-key", required=True)
+    app_get.set_defaults(handler=_handle_app_get, format_hint="builder_summary")
+
     button = builder_subparsers.add_parser("button", help="自定义按钮")
     button_subparsers = button.add_subparsers(dest="builder_button_command", required=True)
 
@@ -104,18 +114,6 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     button_delete.add_argument("--button-id", type=int, required=True)
     button_delete.set_defaults(handler=_handle_button_delete, 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_list = portal_subparsers.add_parser("list", help="列出可访问门户")
@@ -126,11 +124,6 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     portal_get.add_argument("--being-draft", action=argparse.BooleanOptionalAction, default=True)
     portal_get.set_defaults(handler=_handle_portal_get, format_hint="builder_summary")
 
-    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="")
@@ -208,18 +201,13 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     view = builder_subparsers.add_parser("view", help="视图详情")
     view_subparsers = view.add_subparsers(dest="builder_view_command", required=True)
     view_get = view_subparsers.add_parser("get", help="读取视图详情")
-    view_get.add_argument("--viewgraph-key", required=True)
+    view_get.add_argument("--view-key", required=True)
     view_get.set_defaults(handler=_handle_view_get, format_hint="builder_summary")
 
     chart = builder_subparsers.add_parser("chart", help="报表详情")
     chart_subparsers = chart.add_subparsers(dest="builder_chart_command", required=True)
-    chart_get = chart_subparsers.add_parser("get", help="读取报表详情和数据")
+    chart_get = chart_subparsers.add_parser("get", help="读取报表配置详情")
     chart_get.add_argument("--chart-id", required=True)
-    chart_get.add_argument("--data-payload-file")
-    chart_get.add_argument("--page-num", type=int)
-    chart_get.add_argument("--page-size", type=int)
-    chart_get.add_argument("--page-num-y", type=int)
-    chart_get.add_argument("--page-size-y", type=int)
     chart_get.set_defaults(handler=_handle_chart_get, format_hint="builder_summary")
 
 
@@ -347,28 +335,16 @@ def _handle_button_delete(args: argparse.Namespace, context: CliContext) -> dict
     return context.builder.app_custom_button_delete(profile=args.profile, app_key=args.app_key, button_id=args.button_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_read_fields(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.app_read_fields(profile=args.profile, app_key=args.app_key)
-
-
-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_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_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_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_app_get(args: argparse.Namespace, context: CliContext) -> dict:
+    handlers = {
+        "summary": context.builder.app_get,
+        "fields": context.builder.app_get_fields,
+        "layout": context.builder.app_get_layout,
+        "views": context.builder.app_get_views,
+        "flow": context.builder.app_get_flow,
+        "charts": context.builder.app_get_charts,
+    }
+    return handlers[args.builder_app_get_section](profile=args.profile, app_key=args.app_key)
 
 
 def _handle_portal_list(args: argparse.Namespace, context: CliContext) -> dict:
@@ -379,28 +355,12 @@ def _handle_portal_get(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.portal_get(profile=args.profile, dash_key=args.dash_key, being_draft=bool(args.being_draft))
 
 
-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_view_get(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.view_get(profile=args.profile, viewgraph_key=args.viewgraph_key)
+    return context.builder.view_get(profile=args.profile, view_key=args.view_key)
 
 
 def _handle_chart_get(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.builder.chart_get(
-        profile=args.profile,
-        chart_id=args.chart_id,
-        data_payload=load_object_arg(args.data_payload_file, option_name="--data-payload-file") if args.data_payload_file else {},
-        page_num=args.page_num,
-        page_size=args.page_size,
-        page_num_y=args.page_num_y,
-        page_size_y=args.page_size_y,
-    )
+    return context.builder.chart_get(profile=args.profile, chart_id=args.chart_id)
 
 
 def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:

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

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import argparse
+
+from ..context import CliContext
+
+
+def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser("chart", help="报表访问")
+    chart_subparsers = parser.add_subparsers(dest="chart_command", required=True)
+
+    get_parser = chart_subparsers.add_parser("get", help="读取报表数据")
+    get_parser.add_argument("--chart-id", required=True)
+    get_parser.set_defaults(handler=_handle_get, format_hint="generic")
+
+
+def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.resource.chart_get(profile=args.profile, chart_id=args.chart_id)

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

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+import argparse
+
+from ..context import CliContext
+
+
+def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser("portal", help="门户访问")
+    portal_subparsers = parser.add_subparsers(dest="portal_command", required=True)
+
+    list_parser = portal_subparsers.add_parser("list", help="列出当前用户可访问的门户")
+    list_parser.set_defaults(handler=_handle_list, format_hint="generic")
+
+    get_parser = portal_subparsers.add_parser("get", help="读取门户内容清单")
+    get_parser.add_argument("--dash-key", required=True)
+    get_parser.set_defaults(handler=_handle_get, format_hint="generic")
+
+
+def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.resource.portal_list(profile=args.profile)
+
+
+def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.resource.portal_get(profile=args.profile, dash_key=args.dash_key)

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

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import argparse
+
+from ..context import CliContext
+
+
+def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser("view", help="视图访问")
+    view_subparsers = parser.add_subparsers(dest="view_command", required=True)
+
+    get_parser = view_subparsers.add_parser("get", help="读取视图资源描述")
+    get_parser.add_argument("--view-id", required=True)
+    get_parser.set_defaults(handler=_handle_get, format_hint="generic")
+
+
+def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.resource.view_get(profile=args.profile, view_id=args.view_id)

package/src/qingflow_mcp/cli/context.py

@@ -10,6 +10,7 @@ from ..tools.auth_tools import AuthTools
 from ..tools.code_block_tools import CodeBlockTools
 from ..tools.import_tools import ImportTools
 from ..tools.record_tools import RecordTools
+from ..tools.resource_read_tools import ResourceReadTools
 from ..tools.task_context_tools import TaskContextTools
 from ..tools.workspace_tools import WorkspaceTools
 
@@ -21,6 +22,7 @@ class CliContext:
     auth: AuthTools
     workspace: WorkspaceTools
     app: AppTools
+    resource: ResourceReadTools
     record: RecordTools
     code_block: CodeBlockTools
     imports: ImportTools
@@ -40,6 +42,7 @@ def build_cli_context() -> CliContext:
         auth=AuthTools(sessions, backend),
         workspace=WorkspaceTools(sessions, backend),
         app=AppTools(sessions, backend),
+        resource=ResourceReadTools(sessions, backend),
         record=RecordTools(sessions, backend),
         code_block=CodeBlockTools(sessions, backend),
         imports=ImportTools(sessions, backend),