@josephyan/qingflow-app-builder-mcp 0.2.0-beta.1012 → 0.2.0-beta.1013

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-builder-mcp@0.2.0-beta.1012
+npm install @josephyan/qingflow-app-builder-mcp@0.2.0-beta.1013
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-builder-mcp@0.2.0-beta.1012 qingflow-app-builder-mcp
+npx -y -p @josephyan/qingflow-app-builder-mcp@0.2.0-beta.1013 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-builder-mcp",
-  "version": "0.2.0-beta.1012",
+  "version": "0.2.0-beta.1013",
   "description": "Builder MCP for Qingflow app/package/system design and staged solution workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

package/src/qingflow_mcp/__init__.py

@@ -5,7 +5,7 @@ from pathlib import Path
 
 __all__ = ["__version__"]
 
-_FALLBACK_VERSION = "0.2.0b1012"
+_FALLBACK_VERSION = "0.2.0b1013"
 
 
 def _resolve_local_pyproject_version() -> str | None:

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

@@ -16,6 +16,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     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 再走原生导出")
+    start.add_argument("--order-by-file", help="JSON/YAML list，内容与 record list 的 order_by DSL 一致；内部查询和导出记录顺序保持一致")
     start.add_argument("--record-id", dest="record_ids", action="append", default=[], help="只导出这些 record_id；不传时导出当前视图全部数据")
     start.add_argument("--record-ids-file", help="JSON/YAML list，内容与 --record-id 语义一致")
     start.add_argument("--include-workflow-log", action=argparse.BooleanOptionalAction, default=False, help="是否同时导出流程日志")
@@ -36,6 +37,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     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 再走原生导出")
+    direct.add_argument("--order-by-file", help="JSON/YAML list，内容与 record list 的 order_by DSL 一致；内部查询和导出记录顺序保持一致")
     direct.add_argument("--record-id", dest="record_ids", action="append", default=[], help="只导出这些 record_id；不传时导出当前视图全部数据")
     direct.add_argument("--record-ids-file", help="JSON/YAML list，内容与 --record-id 语义一致")
     direct.add_argument("--include-workflow-log", action=argparse.BooleanOptionalAction, default=False, help="是否同时导出流程日志")
@@ -62,6 +64,10 @@ def _where(args: argparse.Namespace) -> list[dict]:
     return load_list_arg(args.where_file, option_name="--where-file") if args.where_file else []
 
 
+def _order_by(args: argparse.Namespace) -> list[dict]:
+    return load_list_arg(args.order_by_file, option_name="--order-by-file") if args.order_by_file else []
+
+
 def _handle_start(args: argparse.Namespace, context: CliContext) -> dict:
     return context.exports.record_export_start(
         profile=args.profile,
@@ -69,6 +75,7 @@ def _handle_start(args: argparse.Namespace, context: CliContext) -> dict:
         view_id=args.view_id,
         columns=_columns(args),
         where=_where(args),
+        order_by=_order_by(args),
         record_ids=_record_ids(args),
         include_workflow_log=args.include_workflow_log,
     )
@@ -96,6 +103,7 @@ def _handle_direct(args: argparse.Namespace, context: CliContext) -> dict:
         view_id=args.view_id,
         columns=_columns(args),
         where=_where(args),
+        order_by=_order_by(args),
         record_ids=_record_ids(args),
         include_workflow_log=args.include_workflow_log,
         download_to_path=args.download_to_path,

package/src/qingflow_mcp/server.py

@@ -160,8 +160,9 @@ Use `record_code_block_run` when the user wants to execute a form code-block fie
   - pass `record_ids` to export selected rows only
 - `record_export_start` / `record_export_direct` also support internal query selection:
   - pass `where` to resolve matching `record_id` values first
+  - pass `order_by` to keep the internal query and export row order aligned with `record_list`
   - then run native export as selected rows
-  - `where` and `record_ids` are mutually exclusive
+  - `where/order_by` and `record_ids` are mutually exclusive
 - `record_export_start` / `record_export_direct` also support frontend-like column selection:
   - omit `columns` to export all current-view fields
   - pass `columns` to export only selected fields, preserving the provided order

package/src/qingflow_mcp/server_app_user.py

@@ -155,8 +155,9 @@ Use `record_code_block_run` when the user wants to execute a form code-block fie
   - pass `record_ids` to export selected rows only
 - `record_export_start` / `record_export_direct` also support internal query selection:
   - pass `where` to resolve matching `record_id` values first
+  - pass `order_by` to keep the internal query and export row order aligned with `record_list`
   - then run native export as selected rows
-  - `where` and `record_ids` are mutually exclusive
+  - `where/order_by` and `record_ids` are mutually exclusive
 - `record_export_start` / `record_export_direct` also support frontend-like column selection:
   - omit `columns` to export all current-view fields
   - pass `columns` to export only selected fields, preserving the provided order
@@ -246,6 +247,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
         view_id: str = "system:all",
         columns: list[dict | int] | None = None,
         where: list[dict] | None = None,
+        order_by: list[dict] | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
     ) -> dict:
@@ -255,6 +257,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
             view_id=view_id,
             columns=columns or [],
             where=where or [],
+            order_by=order_by or [],
             record_ids=record_ids or [],
             include_workflow_log=include_workflow_log,
         )
@@ -285,6 +288,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
         view_id: str = "system:all",
         columns: list[dict | int] | None = None,
         where: list[dict] | None = None,
+        order_by: list[dict] | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
         download_to_path: str | None = None,
@@ -296,6 +300,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
             view_id=view_id,
             columns=columns or [],
             where=where or [],
+            order_by=order_by or [],
             record_ids=record_ids or [],
             include_workflow_log=include_workflow_log,
             download_to_path=download_to_path,

package/src/qingflow_mcp/tools/export_tools.py

@@ -60,6 +60,7 @@ class ExportTools(ToolBase):
             view_id: str = "system:all",
             columns: list[JSONObject | int] | None = None,
             where: list[JSONObject] | None = None,
+            order_by: list[JSONObject] | None = None,
             record_ids: list[str | int] | None = None,
             include_workflow_log: bool = False,
         ) -> dict[str, Any]:
@@ -69,6 +70,7 @@ class ExportTools(ToolBase):
                 view_id=view_id,
                 columns=columns or [],
                 where=where or [],
+                order_by=order_by or [],
                 record_ids=record_ids or [],
                 include_workflow_log=include_workflow_log,
             )
@@ -102,6 +104,7 @@ class ExportTools(ToolBase):
             view_id: str = "system:all",
             columns: list[JSONObject | int] | None = None,
             where: list[JSONObject] | None = None,
+            order_by: list[JSONObject] | None = None,
             record_ids: list[str | int] | None = None,
             include_workflow_log: bool = False,
             download_to_path: str | None = None,
@@ -113,6 +116,7 @@ class ExportTools(ToolBase):
                 view_id=view_id,
                 columns=columns or [],
                 where=where or [],
+                order_by=order_by or [],
                 record_ids=record_ids or [],
                 include_workflow_log=include_workflow_log,
                 download_to_path=download_to_path,
@@ -128,6 +132,7 @@ class ExportTools(ToolBase):
         view_id: str = "system:all",
         columns: list[JSONObject | int] | None = None,
         where: list[JSONObject] | None = None,
+        order_by: list[JSONObject] | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
     ) -> dict[str, Any]:
@@ -135,6 +140,7 @@ class ExportTools(ToolBase):
         normalized_view_id = str(view_id or "").strip() or "system:all"
         normalized_columns = _normalize_export_columns(columns or [])
         normalized_where = self._record_tools._normalize_record_list_where(where or [])
+        normalized_order_by = self._record_tools._normalize_record_list_order_by(order_by or [])
         normalized_record_ids = _normalize_export_record_ids(record_ids or [])
         if not normalized_app_key:
             return self._failed_export_result(
@@ -168,6 +174,7 @@ class ExportTools(ToolBase):
                 resolved_view=resolved_view,
                 selected_record_ids=normalized_record_ids,
                 where_filters=normalized_where,
+                order_by=normalized_order_by,
                 select_columns=cast(list[JSONObject], export_config.get("questionExportConfigList") or []),
             )
             result_amount = self._estimate_export_result_amount(
@@ -240,6 +247,7 @@ class ExportTools(ToolBase):
                     "view_route_supported": True,
                     "row_selection_applied": bool(effective_record_ids),
                     "query_filter_applied": bool(normalized_where),
+                    "query_sort_applied": bool(normalized_order_by),
                     "field_selection_applied": bool(normalized_columns),
                 },
                 "request_route": self.backend.describe_route(context),
@@ -424,6 +432,7 @@ class ExportTools(ToolBase):
         view_id: str = "system:all",
         columns: list[JSONObject | int] | None = None,
         where: list[JSONObject] | None = None,
+        order_by: list[JSONObject] | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
         download_to_path: str | None = None,
@@ -446,6 +455,7 @@ class ExportTools(ToolBase):
                 view_id=normalized_view_id,
                 columns=columns or [],
                 where=where or [],
+                order_by=order_by or [],
                 record_ids=record_ids or [],
                 include_workflow_log=include_workflow_log,
             )
@@ -579,27 +589,29 @@ class ExportTools(ToolBase):
         resolved_view: AccessibleViewRoute,
         selected_record_ids: list[int],
         where_filters: list[JSONObject],
+        order_by: list[JSONObject],
         select_columns: list[JSONObject],
     ) -> tuple[list[int], str]:
-        if selected_record_ids and where_filters:
+        if selected_record_ids and (where_filters or order_by):
             raise QingflowApiError(
                 category="config",
-                message="record export does not allow record_ids and where at the same time",
+                message="record export does not allow record_ids together with query selectors",
                 details={
                     "error_code": "EXPORT_ROW_SCOPE_CONFLICT",
-                    "fix_hint": "Use record_ids for explicit selected rows or where for internal query selection, but not both.",
+                    "fix_hint": "Use record_ids for explicit selected rows, or use where/order_by for internal query selection, but not both.",
                 },
             )
         if selected_record_ids:
             return selected_record_ids, "selected"
-        if not where_filters:
+        if not where_filters and not order_by:
             return [], "all"
-        resolved_ids = self._collect_record_ids_from_where(
+        resolved_ids = self._collect_record_ids_from_query(
             profile=profile,
             context=context,
             app_key=app_key,
             resolved_view=resolved_view,
             where_filters=where_filters,
+            order_by=order_by,
             select_columns=select_columns,
         )
         if not resolved_ids:
@@ -612,7 +624,7 @@ class ExportTools(ToolBase):
             )
         return resolved_ids, "queried"
 
-    def _collect_record_ids_from_where(
+    def _collect_record_ids_from_query(
         self,
         *,
         profile: str,
@@ -620,6 +632,7 @@ class ExportTools(ToolBase):
         app_key: str,
         resolved_view: AccessibleViewRoute,
         where_filters: list[JSONObject],
+        order_by: list[JSONObject],
         select_columns: list[JSONObject],
     ) -> list[int]:
         browse_scope = self._record_tools._build_browse_write_scope(
@@ -631,6 +644,14 @@ class ExportTools(ToolBase):
         )
         index = browse_scope["index"]
         match_rules = self._record_tools._resolve_match_rules(context, where_filters, index)
+        query_sorts = [
+            {
+                "queId": _coerce_int(item.get("field_id")),
+                "direction": str(item.get("direction") or "asc"),
+            }
+            for item in order_by
+            if isinstance(item, dict) and _coerce_int(item.get("field_id")) is not None
+        ]
         dept_member_cache: dict[int, set[int]] = {}
         current_page = 1
         selected_ids: list[int] = []
@@ -651,7 +672,7 @@ class ExportTools(ToolBase):
                 page_size=DEFAULT_LIST_PAGE_SIZE,
                 query_key=None,
                 match_rules=match_rules,
-                sorts=[],
+                sorts=cast(list[JSONObject], query_sorts),
                 search_que_ids=primary_search_que_ids,
                 list_type=resolved_view.list_type if resolved_view.list_type is not None else DEFAULT_RECORD_LIST_TYPE,
             )