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

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

@@ -10,6 +10,34 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     parser = subparsers.add_parser("builder", aliases=["build"], help="稳定 builder 命令")
     builder_subparsers = parser.add_subparsers(dest="builder_command", required=True)
 
+    file_parser = builder_subparsers.add_parser("file", help="builder 侧文件上传")
+    file_subparsers = file_parser.add_subparsers(dest="builder_file_command", required=True)
+    file_upload_local = file_subparsers.add_parser("upload-local", help="上传本地文件并返回附件值")
+    file_upload_local.add_argument("--upload-kind", default="attachment")
+    file_upload_local.add_argument("--file-path", required=True)
+    file_upload_local.add_argument("--upload-mark")
+    file_upload_local.add_argument("--content-type")
+    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")
+
+    feedback = builder_subparsers.add_parser("feedback", help="builder 侧反馈提交")
+    feedback_subparsers = feedback.add_subparsers(dest="builder_feedback_command", required=True)
+    feedback_submit = feedback_subparsers.add_parser("submit", help="提交 builder 能力反馈")
+    feedback_submit.add_argument("--category", required=True)
+    feedback_submit.add_argument("--title", required=True)
+    feedback_submit.add_argument("--description", required=True)
+    feedback_submit.add_argument("--expected-behavior")
+    feedback_submit.add_argument("--actual-behavior")
+    feedback_submit.add_argument("--impact-scope")
+    feedback_submit.add_argument("--tool-name")
+    feedback_submit.add_argument("--app-key")
+    feedback_submit.add_argument("--record-id")
+    feedback_submit.add_argument("--workflow-node-id")
+    feedback_submit.add_argument("--note")
+    feedback_submit.set_defaults(handler=_handle_feedback_submit, format_hint="generic")
+
     contract = builder_subparsers.add_parser("contract", help="读取 builder tool 合约")
     contract.add_argument("--tool-name", required=True)
     contract.set_defaults(handler=_handle_contract, format_hint="builder_summary")
@@ -76,6 +104,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 +142,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 +152,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 +229,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")
 
 
@@ -227,6 +243,35 @@ def _handle_package_list(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_list(profile=args.profile, trial_status=args.trial_status)
 
 
+def _handle_file_upload_local(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.files.file_upload_local(
+        profile=args.profile,
+        upload_kind=args.upload_kind,
+        file_path=args.file_path,
+        upload_mark=args.upload_mark,
+        content_type=args.content_type,
+        bucket_type=args.bucket_type,
+        path_id=args.path_id,
+        file_related_url=args.file_related_url,
+    )
+
+
+def _handle_feedback_submit(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder_feedback.feedback_submit(
+        category=args.category,
+        title=args.title,
+        description=args.description,
+        expected_behavior=args.expected_behavior,
+        actual_behavior=args.actual_behavior,
+        impact_scope=args.impact_scope,
+        tool_name=args.tool_name,
+        app_key=args.app_key,
+        record_id=args.record_id,
+        workflow_node_id=args.workflow_node_id,
+        note=args.note,
+    )
+
+
 def _handle_contract(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.builder_tool_contract(tool_name=args.tool_name)
 
@@ -347,28 +392,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 +412,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

@@ -8,8 +8,11 @@ from ..tools.ai_builder_tools import AiBuilderTools
 from ..tools.app_tools import AppTools
 from ..tools.auth_tools import AuthTools
 from ..tools.code_block_tools import CodeBlockTools
+from ..tools.feedback_tools import FeedbackTools
+from ..tools.file_tools import FileTools
 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,10 +24,13 @@ class CliContext:
     auth: AuthTools
     workspace: WorkspaceTools
     app: AppTools
+    resource: ResourceReadTools
     record: RecordTools
     code_block: CodeBlockTools
     imports: ImportTools
     task: TaskContextTools
+    files: FileTools
+    builder_feedback: FeedbackTools
     builder: AiBuilderTools
 
     def close(self) -> None:
@@ -40,9 +46,12 @@ 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),
         task=TaskContextTools(sessions, backend),
+        files=FileTools(sessions, backend),
+        builder_feedback=FeedbackTools(backend, mcp_side="App Builder MCP"),
         builder=AiBuilderTools(sessions, backend),
     )