@josephyan/qingflow-app-builder-mcp 1.1.16 → 1.1.18

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

@@ -214,7 +214,8 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     schema_apply_apply.add_argument("--visibility-file")
     schema_apply_apply.add_argument("--create-if-missing", action="store_true")
     schema_apply_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=None)
-    schema_apply_apply.add_argument("--apps-file", help="多应用 schema JSON 数组；每项可带 client_key/app_name/add_fields，支持 relation target_app_ref")
+    schema_apply_apply.add_argument("--apps-file", help="多应用 schema JSON 对象；每项可带 client_key/app_name/form，支持 relation target_app_ref")
+    schema_apply_apply.add_argument("--form-file", help="单应用表单结构 JSON 数组；form[].rows[][] 同时声明字段和表单分组布局")
     schema_apply_apply.add_argument("--add-fields-file", help="字段 JSON 数组；字段可用 as_data_title/as_data_cover 标记数据标题/封面")
     schema_apply_apply.add_argument("--update-fields-file", help="字段更新 JSON 数组；set 内可用 as_data_title/as_data_cover 标记数据标题/封面")
     schema_apply_apply.add_argument("--remove-fields-file")
@@ -578,10 +579,10 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
                 fix_hint="Pass a JSON array, or a JSON object like {\"package_id\":1001,\"apps\":[...]} with at least one app item.",
                 error_code="APPS_FILE_EMPTY",
             )
-        if args.app_key or args.app_name or args.app_title or args.add_fields_file or args.update_fields_file or args.remove_fields_file:
+        if args.app_key or args.app_name or args.app_title or args.form_file or args.add_fields_file or args.update_fields_file or args.remove_fields_file:
             raise_config_error(
                 "schema apply multi-app mode accepts --package-id plus --apps-file only; --create-if-missing is optional.",
-                fix_hint="Use `--apps-file` for batch mode, or remove `--apps-file` and use the single-app arguments.",
+                fix_hint="Use apps[].form inside --apps-file for batch mode, or remove --apps-file and use --form-file for a single app.",
             )
         if package_id is None:
             raise_config_error(
@@ -595,6 +596,7 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
             create_if_missing=effective_create_if_missing,
             publish=effective_publish,
             apps=apps,
+            form=None,
             add_fields=[],
             update_fields=[],
             remove_fields=[],
@@ -631,6 +633,7 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
         visibility=load_object_arg(args.visibility_file, option_name="--visibility-file"),
         create_if_missing=bool(args.create_if_missing),
         publish=True if args.publish is None else bool(args.publish),
+        form=load_list_arg(args.form_file, option_name="--form-file") if args.form_file else [],
         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"),

package/src/qingflow_mcp/server_app_builder.py

@@ -428,16 +428,17 @@ def build_builder_server() -> FastMCP:
         visibility: dict | None = None,
         create_if_missing: bool | None = None,
         publish: bool = True,
+        form: list[dict] | None = None,
         add_fields: list[dict] | None = None,
         update_fields: list[dict] | None = None,
         remove_fields: list[dict] | None = None,
         apps: list[dict] | None = None,
     ) -> dict:
         if apps:
-            if app_key or app_name or app_title or add_fields or update_fields or remove_fields:
+            if app_key or app_name or app_title or form or add_fields or update_fields or remove_fields:
                 return _config_failure(
                     "app_schema_apply multi-app mode accepts package_id plus apps only; create_if_missing is optional.",
-                    fix_hint="Use `apps` for batch mode, or use the single-app arguments without `apps`.",
+                    fix_hint="Use apps[].form for batch mode, or use the single-app arguments without apps.",
                 )
             if package_id is None:
                 return _config_failure(
@@ -450,6 +451,7 @@ def build_builder_server() -> FastMCP:
                 visibility=visibility,
                 create_if_missing=True if create_if_missing is None else bool(create_if_missing),
                 publish=publish,
+                form=None,
                 add_fields=[],
                 update_fields=[],
                 remove_fields=[],
@@ -482,10 +484,11 @@ def build_builder_server() -> FastMCP:
             visibility=visibility,
             create_if_missing=effective_create_if_missing,
             publish=publish,
+            form=form or [],
             add_fields=add_fields or [],
             update_fields=update_fields or [],
             remove_fields=remove_fields or [],
-            apps=[],
+            apps=None,
         )
 
     @server.tool()