@qingflow-tech/qingflow-app-builder-mcp 1.0.10 → 1.0.12

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

@@ -13,30 +13,17 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     app_subparsers = parser.add_subparsers(dest="app_command", required=True)
 
     list_parser = app_subparsers.add_parser("list", help="列出可见应用")
+    list_parser.add_argument("--query", default="", help="按关键词在可见应用列表中本地过滤")
+    list_parser.add_argument("--keyword", default="", help="兼容别名；建议使用 --query")
     list_parser.set_defaults(handler=_handle_list, format_hint="app_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")
-
     get = app_subparsers.add_parser("get", help="读取应用可访问视图与导入能力")
     get.add_argument("--app-key", help="不传时在交互终端中选择应用")
     get.set_defaults(handler=_handle_get, format_hint="app_get")
 
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_list(profile=args.profile)
-
-
-def _handle_search(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_search(
-        profile=args.profile,
-        keyword=args.keyword,
-        page_num=args.page,
-        page_size=args.page_size,
-    )
+    return context.app.app_list(profile=args.profile, query=args.query, keyword=args.keyword)
 
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:

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

@@ -42,10 +42,15 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     contract.add_argument("--tool-name", required=True)
     contract.set_defaults(handler=_handle_contract, format_hint="builder_summary")
 
+    icon = builder_subparsers.add_parser("icon", help="工作区图标目录")
+    icon_subparsers = icon.add_subparsers(dest="builder_icon_command", required=True)
+    icon_catalog = icon_subparsers.add_parser("catalog", help="读取应用、应用包、门户可用图标目录")
+    icon_catalog.set_defaults(handler=_handle_icon_catalog, format_hint="builder_summary")
+
     member = builder_subparsers.add_parser("member", help="成员目录")
     member_subparsers = member.add_subparsers(dest="builder_member_command", required=True)
     member_search = member_subparsers.add_parser("search", help="搜索成员")
-    member_search.add_argument("--query", default="")
+    member_search.add_argument("--query", required=True)
     member_search.add_argument("--page-num", type=int, default=1)
     member_search.add_argument("--page-size", type=int, default=20)
     member_search.add_argument("--contain-disable", action=argparse.BooleanOptionalAction, default=False)
@@ -54,7 +59,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     role = builder_subparsers.add_parser("role", help="角色目录")
     role_subparsers = role.add_subparsers(dest="builder_role_command", required=True)
     role_search = role_subparsers.add_parser("search", help="搜索角色")
-    role_search.add_argument("--keyword", default="")
+    role_search.add_argument("--keyword", required=True)
     role_search.add_argument("--page-num", type=int, default=1)
     role_search.add_argument("--page-size", type=int, default=20)
     role_search.set_defaults(handler=_handle_role_search, format_hint="builder_summary")
@@ -78,6 +83,11 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     solution_install.add_argument("--solution-source", default="solutionDetail")
     solution_install.set_defaults(handler=_handle_solution_install, format_hint="builder_summary")
 
+    package_list = package_subparsers.add_parser("list", help="列出应用包")
+    package_list.add_argument("--trial-status", default="all")
+    package_list.add_argument("--query", default="")
+    package_list.set_defaults(handler=_handle_package_list, format_hint="builder_summary")
+
     package_get = package_subparsers.add_parser("get", help="读取应用包详情")
     package_get.add_argument("--package-id", type=int, required=True)
     package_get.set_defaults(handler=_handle_package_get, format_hint="builder_summary")
@@ -157,7 +167,9 @@ 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("--payload-file")
     portal_apply.add_argument("--sections-file")
+    portal_apply.add_argument("--layout-preset", default="")
     portal_apply.add_argument("--visibility-file")
     portal_apply.add_argument("--auth-file")
     portal_apply.add_argument("--icon")
@@ -277,6 +289,10 @@ def _handle_contract(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.builder_tool_contract(tool_name=args.tool_name)
 
 
+def _handle_icon_catalog(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.workspace_icon_catalog_get(profile=args.profile)
+
+
 def _handle_member_search(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.member_search(
         profile=args.profile,
@@ -320,6 +336,10 @@ def _handle_package_get(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_get(profile=args.profile, package_id=args.package_id)
 
 
+def _handle_package_list(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.package_list(profile=args.profile, trial_status=args.trial_status, query=args.query)
+
+
 def _handle_package_apply(args: argparse.Namespace, context: CliContext) -> dict:
     config = load_object_arg(args.config_file, option_name="--config-file")
     if not isinstance(config, dict):
@@ -557,9 +577,13 @@ def _handle_charts_apply(args: argparse.Namespace, context: CliContext) -> dict:
 
 
 def _handle_portal_apply(args: argparse.Namespace, context: CliContext) -> dict:
+    payload = load_object_arg(args.payload_file, option_name="--payload-file") if getattr(args, "payload_file", None) else None
+    payload_obj = payload if isinstance(payload, dict) else {}
+    effective_dash_name = (args.dash_name or str(payload_obj.get("dash_name") or payload_obj.get("dashName") or payload_obj.get("name") or "")).strip()
+    effective_package_id = args.package_id if args.package_id is not None else payload_obj.get("package_id") or payload_obj.get("packageId") or payload_obj.get("package_tag_id")
     has_dash_key = bool((args.dash_key or "").strip())
-    has_dash_name = bool((args.dash_name or "").strip())
-    has_package_id = args.package_id is not None
+    has_dash_name = bool(effective_dash_name)
+    has_package_id = effective_package_id is not None
     if has_dash_key and has_package_id:
         raise_config_error(
             "portal apply accepts exactly one selector mode.",
@@ -578,6 +602,7 @@ def _handle_portal_apply(args: argparse.Namespace, context: CliContext) -> dict:
         package_id=args.package_id,
         publish=bool(args.publish),
         sections=sections,
+        layout_preset=args.layout_preset,
         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,
@@ -585,6 +610,7 @@ def _handle_portal_apply(args: argparse.Namespace, context: CliContext) -> dict:
         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"),
+        payload=payload,
     )
 
 

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

@@ -12,7 +12,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     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("--view-id", required=True)
     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 再走原生导出")
@@ -33,7 +33,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     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("--view-id", required=True)
     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 再走原生导出")

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

@@ -13,7 +13,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     template = import_subparsers.add_parser("template", help="下载导入模板")
     template.add_argument("--app-key", required=True)
     template.add_argument("--download-to-path")
-    template.set_defaults(handler=_handle_template, format_hint="")
+    template.set_defaults(handler=_handle_template, format_hint="import_template")
 
     verify = import_subparsers.add_parser("verify", help="校验导入文件")
     verify.add_argument("--app-key", required=True)

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

@@ -13,17 +13,25 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     record_subparsers = parser.add_subparsers(
         dest="record_command",
         required=True,
-        metavar="{schema,list,access,get,insert,update,delete,member-candidates,department-candidates,code-block-run}",
+        metavar="{schema,list,access,get,logs,insert,update,delete,member-candidates,department-candidates,code-block-run}",
     )
 
     schema = record_subparsers.add_parser("schema", help="读取记录相关表结构")
     schema.add_argument("--mode", dest="legacy_mode", help=argparse.SUPPRESS)
-    schema_subparsers = schema.add_subparsers(dest="record_schema_command")
+    schema_subparsers = schema.add_subparsers(
+        dest="record_schema_command",
+        metavar="{browse,insert,update,import,code-block}",
+    )
     schema.set_defaults(handler=_handle_schema_root, format_hint="")
 
-    schema_applicant = schema_subparsers.add_parser("applicant", help="读取申请节点表结构")
+    schema_applicant = schema_subparsers.add_parser("applicant", help=argparse.SUPPRESS)
     schema_applicant.add_argument("--app-key", required=True)
     schema_applicant.set_defaults(handler=_handle_schema_applicant, format_hint="")
+    schema_subparsers._choices_actions = [  # type: ignore[attr-defined]
+        action
+        for action in schema_subparsers._choices_actions  # type: ignore[attr-defined]
+        if getattr(action, "dest", None) != "applicant"
+    ]
 
     schema_browse = schema_subparsers.add_parser("browse", help="读取浏览视图表结构")
     schema_browse.add_argument("--app-key", required=True)
@@ -37,6 +45,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)
+    schema_update.add_argument("--view-id")
     schema_update.set_defaults(handler=_handle_schema_update, format_hint="")
 
     schema_import = schema_subparsers.add_parser("import", help="读取导入表结构")
@@ -102,27 +111,36 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     get.add_argument("--view-id")
     get.set_defaults(handler=_handle_get, format_hint="record_get")
 
+    logs = record_subparsers.add_parser("logs", help="读取单条记录全量日志并写入本地 JSONL")
+    logs.add_argument("--app-key", required=True)
+    logs.add_argument("--record-id", required=True)
+    logs.add_argument("--view-id", required=True)
+    logs.set_defaults(handler=_handle_logs, format_hint="record_logs")
+
     insert = record_subparsers.add_parser("insert", help="新增记录")
     insert.add_argument("--app-key", required=True)
     insert.add_argument("--fields-file", help=argparse.SUPPRESS)
     insert.add_argument("--items-file")
     insert.add_argument("--verify-write", action=argparse.BooleanOptionalAction, default=True)
-    insert.set_defaults(handler=_handle_insert, format_hint="")
+    insert.set_defaults(handler=_handle_insert, format_hint="record_write")
 
     update = record_subparsers.add_parser("update", help="更新记录")
     update.add_argument("--app-key", required=True)
     update.add_argument("--record-id")
     update.add_argument("--fields-file")
     update.add_argument("--items-file")
+    update.add_argument("--view-id")
     update.add_argument("--dry-run", action=argparse.BooleanOptionalAction, default=False)
     update.add_argument("--verify-write", action=argparse.BooleanOptionalAction, default=True)
-    update.set_defaults(handler=_handle_update, format_hint="")
+    update.set_defaults(handler=_handle_update, format_hint="record_write")
 
     delete = record_subparsers.add_parser("delete", help="删除记录")
     delete.add_argument("--app-key", required=True)
     delete.add_argument("--record-id")
     delete.add_argument("--record-ids-file")
-    delete.set_defaults(handler=_handle_delete, format_hint="")
+    delete.add_argument("--view-id")
+    delete.add_argument("--list-type", dest="legacy_list_type", type=int, help=argparse.SUPPRESS)
+    delete.set_defaults(handler=_handle_delete, format_hint="record_delete")
 
     analyze = record_subparsers.add_parser("analyze", help=argparse.SUPPRESS)
     record_subparsers._choices_actions = [  # type: ignore[attr-defined]
@@ -147,6 +165,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     code_block.add_argument("--app-key", required=True)
     code_block.add_argument("--record-id", required=True)
     code_block.add_argument("--code-block-field", required=True)
+    code_block.add_argument("--view-id")
     code_block.add_argument("--role", type=int, default=1)
     code_block.add_argument("--workflow-node-id", type=int)
     code_block.add_argument("--answers-file")
@@ -155,7 +174,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     code_block.add_argument("--apply-writeback", action=argparse.BooleanOptionalAction, default=True)
     code_block.add_argument("--verify-writeback", action=argparse.BooleanOptionalAction, default=True)
     code_block.add_argument("--force-refresh-form", action="store_true")
-    code_block.set_defaults(handler=_handle_code_block_run, format_hint="")
+    code_block.set_defaults(handler=_handle_code_block_run, format_hint="code_block_run")
 
 
 def _columns(args: argparse.Namespace) -> list[Any]:
@@ -176,20 +195,20 @@ def _handle_schema_root(args: argparse.Namespace, _context: CliContext) -> dict:
     mode = (args.legacy_mode or "").strip()
     if mode:
         replacement = {
-            "applicant": "record schema applicant --app-key APP_KEY",
+            "applicant": "record schema insert --app-key APP_KEY",
             "browse": "record schema browse --app-key APP_KEY --view-id VIEW_ID",
             "insert": "record schema insert --app-key APP_KEY",
-            "update": "record schema update --app-key APP_KEY --record-id RECORD_ID",
+            "update": "record schema update --app-key APP_KEY --record-id RECORD_ID [--view-id VIEW_ID]",
             "import": "record schema import --app-key APP_KEY",
             "code-block": "record schema code-block --app-key APP_KEY",
-        }.get(mode, "record schema <applicant|browse|insert|update|import|code-block> ...")
+        }.get(mode, "record schema <browse|insert|update|import|code-block> ...")
         raise_config_error(
             "record schema --mode is no longer accepted.",
             fix_hint=f"Use `{replacement}` instead.",
         )
     raise_config_error(
         "record schema requires an explicit subcommand.",
-        fix_hint="Use one of: `record schema applicant`, `record schema browse`, `record schema insert`, `record schema update`, `record schema import`, or `record schema code-block`.",
+        fix_hint="Use one of: `record schema browse`, `record schema insert`, `record schema update`, `record schema import`, or `record schema code-block`.",
     )
 
 
@@ -218,6 +237,7 @@ def _handle_schema_update(args: argparse.Namespace, context: CliContext) -> dict
         profile=args.profile,
         app_key=args.app_key,
         record_id=args.record_id,
+        view_id=args.view_id,
     )
 
 
@@ -328,6 +348,15 @@ def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
     )
 
 
+def _handle_logs(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.record.record_logs_get(
+        profile=args.profile,
+        app_key=args.app_key,
+        record_id=args.record_id,
+        view_id=args.view_id,
+    )
+
+
 def _handle_insert(args: argparse.Namespace, context: CliContext) -> dict:
     if args.items_file:
         if args.fields_file:
@@ -367,6 +396,7 @@ def _handle_update(args: argparse.Namespace, context: CliContext) -> dict:
             record_id=None,
             fields=None,
             items=require_list_arg(args.items_file, option_name="--items-file"),
+            view_id=args.view_id,
             dry_run=bool(args.dry_run),
             verify_write=bool(args.verify_write),
         )
@@ -385,17 +415,29 @@ def _handle_update(args: argparse.Namespace, context: CliContext) -> dict:
         app_key=args.app_key,
         record_id=args.record_id,
         fields=require_object_arg(args.fields_file, option_name="--fields-file"),
+        view_id=args.view_id,
         verify_write=bool(args.verify_write),
     )
 
 
 def _handle_delete(args: argparse.Namespace, context: CliContext) -> dict:
+    if args.legacy_list_type is not None:
+        raise_config_error(
+            "record delete no longer accepts list_type.",
+            fix_hint="Call `app_get` first and pass an accessible system `view_id`, for example `--view-id system:all`.",
+        )
+    if not (args.view_id or "").strip():
+        raise_config_error(
+            "record delete requires --view-id.",
+            fix_hint="Use a system view_id from app get accessible_views, for example `--view-id system:all`; custom views are not supported for deletion.",
+        )
     record_ids = load_list_arg(args.record_ids_file, option_name="--record-ids-file")
     return context.record.record_delete_public(
         profile=args.profile,
         app_key=args.app_key,
         record_id=args.record_id,
         record_ids=record_ids,
+        view_id=args.view_id,
     )
 
 
@@ -431,6 +473,7 @@ def _handle_code_block_run(args: argparse.Namespace, context: CliContext) -> dic
         app_key=args.app_key,
         record_id=args.record_id,
         code_block_field=args.code_block_field,
+        view_id=args.view_id,
         role=args.role,
         workflow_node_id=args.workflow_node_id,
         answers=load_list_arg(args.answers_file, option_name="--answers-file"),

package/src/qingflow_mcp/cli/context.py

@@ -13,7 +13,6 @@ 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.repository_dev_tools import RepositoryDevTools
 from ..tools.resource_read_tools import ResourceReadTools
 from ..tools.task_context_tools import TaskContextTools
 from ..tools.workspace_tools import WorkspaceTools
@@ -35,7 +34,6 @@ class CliContext:
     files: FileTools
     builder_feedback: FeedbackTools
     builder: AiBuilderTools
-    repo: RepositoryDevTools
 
     def close(self) -> None:
         self.backend.close()
@@ -59,5 +57,4 @@ def build_cli_context() -> CliContext:
         files=FileTools(sessions, backend),
         builder_feedback=FeedbackTools(backend, mcp_side="App Builder MCP"),
         builder=AiBuilderTools(sessions, backend),
-        repo=RepositoryDevTools(sessions, backend),
     )