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

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.12
+npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.14
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.12 qingflow-app-builder-mcp
+npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.14 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-builder-mcp",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "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 = "1.0.12"
+version = "1.0.14"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/builder_facade/models.py

@@ -1610,6 +1610,7 @@ class AssociatedResourcesApplyRequest(StrictModel):
         if not isinstance(value, dict):
             return value
         payload = dict(value)
+        default_target_app_key = str(payload.get("app_key", payload.get("appKey", "")) or "").strip()
         if "upsertResources" in payload and "upsert_resources" not in payload:
             payload["upsert_resources"] = payload.pop("upsertResources")
         if "patchResources" in payload and "patch_resources" not in payload:
@@ -1622,6 +1623,16 @@ class AssociatedResourcesApplyRequest(StrictModel):
             payload["reorder_associated_item_ids"] = payload.pop("reorderAssociatedItemIds")
         if "viewConfigs" in payload and "view_configs" not in payload:
             payload["view_configs"] = payload.pop("viewConfigs")
+        if default_target_app_key and isinstance(payload.get("upsert_resources"), list):
+            normalized_resources = []
+            for item in payload["upsert_resources"]:
+                if isinstance(item, dict) and not any(
+                    str(item.get(key) or "").strip()
+                    for key in ("target_app_key", "targetAppKey", "app_key", "appKey")
+                ):
+                    item = {**item, "target_app_key": default_target_app_key}
+                normalized_resources.append(item)
+            payload["upsert_resources"] = normalized_resources
         return payload
 
     @model_validator(mode="after")

package/src/qingflow_mcp/builder_facade/service.py

@@ -17721,8 +17721,23 @@ def _apply_field_mutation(field: dict[str, Any], mutation: Any) -> None:
         field["config"] = deepcopy(payload["code_block_config"])
         question_rebuild_required = True
     if "code_block_binding" in payload:
+        existing_code_block_config = _normalize_code_block_config(field.get("code_block_config") or field.get("config") or {})
+        next_code_block_binding = _normalize_code_block_binding(payload["code_block_binding"])
         field["code_block_binding"] = payload["code_block_binding"]
         field["_explicit_code_block_binding"] = True
+        if (
+            "code_block_config" not in payload
+            and existing_code_block_config is not None
+            and next_code_block_binding is not None
+        ):
+            existing_code = _normalize_code_block_output_assignment(
+                _strip_code_block_generated_input_prelude(str(existing_code_block_config.get("code_content") or ""))
+            )
+            next_code = _normalize_code_block_output_assignment(str(next_code_block_binding.get("code") or ""))
+            if existing_code != next_code:
+                existing_code_block_config["code_content"] = next_code
+                field["code_block_config"] = existing_code_block_config
+                field["config"] = deepcopy(existing_code_block_config)
         question_rebuild_required = True
     if "auto_trigger" in payload:
         field["auto_trigger"] = payload["auto_trigger"]
@@ -18228,6 +18243,15 @@ def _compile_code_block_binding_fields(
                     "alias_id": _coerce_positive_int(output_item.get("alias_id")),
                 }
             )
+    current_field_refs: set[int] = set()
+    for field in next_fields:
+        if not isinstance(field, dict):
+            continue
+        field_ref = _coerce_positive_int(field.get("que_id"))
+        if field_ref is None:
+            field_ref = _coerce_any_int(field.get("que_temp_id"))
+        if field_ref is not None:
+            current_field_refs.add(field_ref)
     carried_relations: list[dict[str, Any]] = []
     for relation in existing_relations:
         if not isinstance(relation, dict):
@@ -18238,6 +18262,8 @@ def _compile_code_block_binding_fields(
         alias_config = relation.get("aliasConfig") if isinstance(relation.get("aliasConfig"), dict) else {}
         source_ref = _coerce_positive_int(alias_config.get("queId"))
         target_ref = _coerce_positive_int(relation.get("queId"))
+        if source_ref not in current_field_refs or target_ref not in current_field_refs:
+            continue
         if (source_ref is not None and source_ref in affected_source_refs) or (target_ref is not None and target_ref in affected_target_refs):
             continue
         carried_relations.append(deepcopy(relation))

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

@@ -80,11 +80,33 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     list_parser = record_subparsers.add_parser("list", help="列出记录")
     list_parser.add_argument("--app-key", required=True)
-    list_parser.add_argument("--column", dest="columns", action="append", type=int, default=[])
-    list_parser.add_argument("--columns-file")
+    list_parser.add_argument(
+        "--column",
+        dest="columns",
+        action="append",
+        type=int,
+        default=[],
+        metavar="FIELD_ID",
+        help="只返回这些 field_id；可重复传",
+    )
+    list_parser.add_argument(
+        "--columns-file",
+        help="JSON/YAML list；元素为 field_id 整数/整数字符串或 {'field_id': ...}",
+    )
     list_parser.add_argument("--query")
-    list_parser.add_argument("--query-field", dest="query_fields", action="append", type=int, default=[])
-    list_parser.add_argument("--query-fields-file")
+    list_parser.add_argument(
+        "--query-field",
+        dest="query_fields",
+        action="append",
+        type=int,
+        default=[],
+        metavar="FIELD_ID",
+        help="全文搜索范围 field_id；可重复传",
+    )
+    list_parser.add_argument(
+        "--query-fields-file",
+        help="JSON/YAML list；元素为 field_id 整数/整数字符串或 {'field_id': ...}",
+    )
     list_parser.add_argument("--where-file")
     list_parser.add_argument("--order-by-file")
     list_parser.add_argument("--page", type=int, default=1)
@@ -96,8 +118,19 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     access_parser = record_subparsers.add_parser("access", help="访问记录并写入本地 CSV 分片")
     access_parser.add_argument("--app-key", required=True)
-    access_parser.add_argument("--column", dest="columns", action="append", type=int, default=[])
-    access_parser.add_argument("--columns-file")
+    access_parser.add_argument(
+        "--column",
+        dest="columns",
+        action="append",
+        type=int,
+        default=[],
+        metavar="FIELD_ID",
+        help="导出这些 field_id 到 CSV；可重复传",
+    )
+    access_parser.add_argument(
+        "--columns-file",
+        help="JSON/YAML list；元素为 field_id 整数/整数字符串或 {'field_id': ...}",
+    )
     access_parser.add_argument("--where-file")
     access_parser.add_argument("--order-by-file")
     access_parser.add_argument("--view-id", required=True)
@@ -106,8 +139,19 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     get = record_subparsers.add_parser("get", help="读取单条记录")
     get.add_argument("--app-key", required=True)
     get.add_argument("--record-id", required=True)
-    get.add_argument("--column", dest="columns", action="append", type=int, default=[])
-    get.add_argument("--columns-file")
+    get.add_argument(
+        "--column",
+        dest="columns",
+        action="append",
+        type=int,
+        default=[],
+        metavar="FIELD_ID",
+        help="聚焦这些 field_id；可重复传",
+    )
+    get.add_argument(
+        "--columns-file",
+        help="JSON/YAML list；元素为 field_id 整数/整数字符串或 {'field_id': ...}",
+    )
     get.add_argument("--view-id")
     get.set_defaults(handler=_handle_get, format_hint="record_get")
 

package/src/qingflow_mcp/response_trim.py

@@ -918,6 +918,12 @@ def _compact_import_column(item: dict[str, Any]) -> dict[str, Any]:
         compact["options"] = options
     if bool(item.get("accepts_natural_input")):
         compact["accepts_natural_input"] = True
+    import_value_format = item.get("import_value_format")
+    if isinstance(import_value_format, str) and import_value_format:
+        compact["import_value_format"] = import_value_format
+    format_hint = item.get("format_hint")
+    if isinstance(format_hint, str) and format_hint:
+        compact["format_hint"] = format_hint
     if bool(item.get("requires_upload")):
         compact["requires_upload"] = True
     target_app_key = item.get("target_app_key")

package/src/qingflow_mcp/server_app_user.py

@@ -269,6 +269,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
         columns: list[dict | int] | None = None,
         where: list[dict] | None = None,
         order_by: list[dict] | None = None,
+        record_id: str | int | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
     ) -> dict:
@@ -279,6 +280,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
             columns=columns or [],
             where=where or [],
             order_by=order_by or [],
+            record_id=record_id,
             record_ids=record_ids or [],
             include_workflow_log=include_workflow_log,
         )
@@ -310,6 +312,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
         columns: list[dict | int] | None = None,
         where: list[dict] | None = None,
         order_by: list[dict] | None = None,
+        record_id: str | int | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
         download_to_path: str | None = None,
@@ -322,6 +325,7 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
             columns=columns or [],
             where=where or [],
             order_by=order_by or [],
+            record_id=record_id,
             record_ids=record_ids or [],
             include_workflow_log=include_workflow_log,
             download_to_path=download_to_path,

package/src/qingflow_mcp/session_store.py

@@ -176,17 +176,21 @@ class SessionStore:
             return memory_session
         if not session_profile:
             return None
-        token = self._get_secret(self._token_key(profile)) if session_profile.persisted else None
-        if not token:
-            token = session_profile.token
+        token = session_profile.token
+        if not token and session_profile.persisted:
+            token = self._get_secret(self._token_key(profile))
         if not token:
             return None
-        login_token = self._get_secret(self._login_token_key(profile)) if session_profile.persisted else None
-        credential = self._get_secret(self._credential_key(profile)) if session_profile.persisted else None
+        login_token = session_profile.login_token
+        if not login_token and session_profile.persisted:
+            login_token = self._get_secret(self._login_token_key(profile))
+        credential = session_profile.credential
+        if not credential and session_profile.persisted:
+            credential = self._get_secret(self._credential_key(profile))
         backend_session = BackendSession(
             token=token,
-            login_token=login_token or session_profile.login_token,
-            credential=credential or session_profile.credential,
+            login_token=login_token,
+            credential=credential,
             profile=profile,
             base_url=session_profile.base_url,
             qf_version=session_profile.qf_version,

package/src/qingflow_mcp/tools/code_block_tools.py

@@ -104,11 +104,12 @@ class CodeBlockTools(RecordTools):
 
         @mcp.tool()
         def record_code_block_schema_get(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_code_block_schema_get_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 output_profile=output_profile,
             )

package/src/qingflow_mcp/tools/export_tools.py

@@ -65,6 +65,7 @@ class ExportTools(ToolBase):
             columns: list[JSONObject | int] | None = None,
             where: list[JSONObject] | None = None,
             order_by: list[JSONObject] | None = None,
+            record_id: str | int | None = None,
             record_ids: list[str | int] | None = None,
             include_workflow_log: bool = False,
         ) -> dict[str, Any]:
@@ -75,6 +76,7 @@ class ExportTools(ToolBase):
                 columns=columns or [],
                 where=where or [],
                 order_by=order_by or [],
+                record_id=record_id,
                 record_ids=record_ids or [],
                 include_workflow_log=include_workflow_log,
             )
@@ -109,6 +111,7 @@ class ExportTools(ToolBase):
             columns: list[JSONObject | int] | None = None,
             where: list[JSONObject] | None = None,
             order_by: list[JSONObject] | None = None,
+            record_id: str | int | None = None,
             record_ids: list[str | int] | None = None,
             include_workflow_log: bool = False,
             download_to_path: str | None = None,
@@ -121,6 +124,7 @@ class ExportTools(ToolBase):
                 columns=columns or [],
                 where=where or [],
                 order_by=order_by or [],
+                record_id=record_id,
                 record_ids=record_ids or [],
                 include_workflow_log=include_workflow_log,
                 download_to_path=download_to_path,
@@ -137,6 +141,7 @@ class ExportTools(ToolBase):
         columns: list[JSONObject | int] | None = None,
         where: list[JSONObject] | None = None,
         order_by: list[JSONObject] | None = None,
+        record_id: str | int | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
     ) -> dict[str, Any]:
@@ -145,7 +150,7 @@ class ExportTools(ToolBase):
         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 [])
+        normalized_record_ids = _normalize_export_record_ids(_merge_single_export_record_id(record_id, record_ids or []))
         if not normalized_app_key:
             return self._failed_export_result(
                 error_code="EXPORT_START_FAILED",
@@ -467,6 +472,7 @@ class ExportTools(ToolBase):
         columns: list[JSONObject | int] | None = None,
         where: list[JSONObject] | None = None,
         order_by: list[JSONObject] | None = None,
+        record_id: str | int | None = None,
         record_ids: list[str | int] | None = None,
         include_workflow_log: bool = False,
         download_to_path: str | None = None,
@@ -496,6 +502,7 @@ class ExportTools(ToolBase):
                 columns=columns or [],
                 where=where or [],
                 order_by=order_by or [],
+                record_id=record_id,
                 record_ids=record_ids or [],
                 include_workflow_log=include_workflow_log,
             )
@@ -1665,6 +1672,12 @@ def _normalize_export_record_ids(record_ids: list[str | int]) -> list[int]:
     return normalized
 
 
+def _merge_single_export_record_id(record_id: str | int | None, record_ids: list[str | int]) -> list[str | int]:
+    if record_id is None or str(record_id).strip() == "":
+        return list(record_ids)
+    return [record_id, *record_ids]
+
+
 def _effective_total(page: JSONObject, *, page_size: int) -> int:
     rows = page.get("list")
     returned_rows = len(rows) if isinstance(rows, list) else 0

package/src/qingflow_mcp/tools/import_tools.py

@@ -75,11 +75,12 @@ class ImportTools(ToolBase):
         """注册当前工具到 MCP 服务。"""
         @mcp.tool()
         def record_import_schema_get(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             output_profile: str = "normal",
         ) -> dict[str, Any]:
             return self.record_import_schema_get(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 output_profile=output_profile,
             )
@@ -224,8 +225,15 @@ class ImportTools(ToolBase):
                 }
                 if isinstance(column.get("options"), list) and column.get("options"):
                     payload["options"] = column["options"]
-                if bool(column.get("requires_lookup")):
-                    payload["accepts_natural_input"] = True
+                if column["write_kind"] == "member":
+                    payload["import_value_format"] = "member_email"
+                    payload["format_hint"] = "Import files must use member email values."
+                elif column["write_kind"] == "relation":
+                    payload["import_value_format"] = "target_apply_id"
+                    payload["format_hint"] = "Import files must use the target record apply_id."
+                elif column["write_kind"] == "department":
+                    payload["import_value_format"] = "department_name"
+                    payload["format_hint"] = "Import files may use a department name within the field candidate scope."
                 if bool(column.get("requires_upload")):
                     payload["requires_upload"] = True
                 if isinstance(column.get("target_app_key"), str):
@@ -660,7 +668,8 @@ class ImportTools(ToolBase):
             applied_repairs: list[str] = []
             skipped_repairs: list[str] = []
             if "normalize_headers" in normalized_repairs:
-                if _repair_headers(sheet, expected_columns):
+                repair_header_columns = _repair_header_columns_from_stored_precheck(stored, expected_columns)
+                if _repair_headers(sheet, repair_header_columns):
                     applied_repairs.append("normalize_headers")
                 else:
                     skipped_repairs.append("normalize_headers")
@@ -744,11 +753,17 @@ class ImportTools(ToolBase):
                 return self._failed_start_result(error_code="IMPORT_VERIFICATION_STALE", message="verification_id does not belong to the requested app")
             if not bool(stored.get("can_import")):
                 return self._failed_start_result(error_code="IMPORT_VERIFICATION_FAILED", message="verification_id is not importable", extra={"accepted": False})
-            current_path = Path(str(stored.get("verified_file_path") or stored["file_path"]))
+            source_local_precheck = stored.get("source_local_precheck")
+            source_precheck_passed = isinstance(source_local_precheck, dict) and bool(source_local_precheck.get("can_import"))
+            if source_precheck_passed:
+                current_path = Path(str(stored.get("source_file_path") or stored["file_path"]))
+                expected_sha256 = stored.get("file_sha256")
+            else:
+                current_path = Path(str(stored.get("verified_file_path") or stored.get("source_file_path") or stored["file_path"]))
+                expected_sha256 = stored.get("verified_file_sha256") or stored.get("file_sha256")
             if not current_path.is_file():
-                return self._failed_start_result(error_code="IMPORT_VERIFICATION_STALE", message="verified file no longer exists")
+                return self._failed_start_result(error_code="IMPORT_VERIFICATION_STALE", message="verified import file no longer exists")
             current_sha256 = _sha256_file(current_path)
-            expected_sha256 = stored.get("verified_file_sha256") or stored.get("file_sha256")
             if current_sha256 != expected_sha256:
                 return self._failed_start_result(
                     error_code="IMPORT_FILE_CHANGED_AFTER_VERIFY",
@@ -1142,6 +1157,9 @@ class ImportTools(ToolBase):
             "can_import": True,
             "extension": extension,
             "error_code": None,
+            "expected_header_titles": list(allowed_header_titles)
+            if allowed_header_titles
+            else [str(item["title"]) for item in expected_columns],
         }
         if extension not in SUPPORTED_IMPORT_EXTENSIONS:
             base_result["issues"].append(_issue("UNSUPPORTED_FILE_FORMAT", "Only .xlsx and .xls files are supported in import v1.", severity="error"))
@@ -2204,6 +2222,20 @@ def _sheet_header_map(sheet) -> dict[str, int]:  # type: ignore[no-untyped-def]
     return mapping
 
 
+def _repair_header_columns_from_stored_precheck(stored: JSONObject, expected_columns: list[JSONObject]) -> list[JSONObject]:
+    for key in ("source_local_precheck", "local_precheck"):
+        precheck = stored.get(key)
+        if not isinstance(precheck, dict):
+            continue
+        titles = precheck.get("expected_header_titles")
+        if not isinstance(titles, list):
+            continue
+        normalized_titles = [title for title in (_normalize_optional_text(item) for item in titles) if title]
+        if normalized_titles:
+            return [{"title": title} for title in normalized_titles]
+    return expected_columns
+
+
 def _repair_headers(sheet, expected_columns: list[JSONObject]) -> bool:  # type: ignore[no-untyped-def]
     changed = False
     expected_by_key = {_normalize_header_key(item["title"]): item["title"] for item in expected_columns}
@@ -2222,9 +2254,11 @@ def _repair_headers(sheet, expected_columns: list[JSONObject]) -> bool:  # type:
     # Fallback for template-based files where headers were edited into non-canonical
     # values but column order is still intact. Keep any extra trailing system columns.
     for index, column in enumerate(expected_columns, start=1):
-        if index > len(header_cells):
-            break
         expected_title = str(column["title"]).strip()
+        if index > len(header_cells):
+            sheet.cell(row=1, column=index, value=expected_title)
+            changed = True
+            continue
         current_title = _normalize_optional_text(header_cells[index - 1].value)
         if current_title != expected_title:
             header_cells[index - 1].value = expected_title

package/src/qingflow_mcp/tools/record_tools.py

@@ -350,11 +350,12 @@ class RecordTools(ToolBase):
         """注册当前工具到 MCP 服务。"""
         @mcp.tool()
         def record_insert_schema_get(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_insert_schema_get_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 output_profile=output_profile,
             )
@@ -464,6 +465,7 @@ class RecordTools(ToolBase):
             )
         )
         def record_access(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             view_id: str = "",
             columns: list[JSONObject | int] | None = None,
@@ -471,7 +473,7 @@ class RecordTools(ToolBase):
             order_by: list[JSONObject] | None = None,
         ) -> JSONObject:
             return self.record_access(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 view_id=view_id,
                 columns=columns or [],
@@ -515,12 +517,13 @@ class RecordTools(ToolBase):
 
         @mcp.tool()
         def record_browse_schema_get(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             view_id: str = "",
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_browse_schema_get_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 view_id=view_id,
                 output_profile=output_profile,
@@ -528,13 +531,14 @@ class RecordTools(ToolBase):
 
         @mcp.tool()
         def record_update_schema_get(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             record_id: str = "",
             view_id: str | None = None,
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_update_schema_get_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 record_id=record_id,
                 view_id=view_id,
@@ -550,13 +554,14 @@ class RecordTools(ToolBase):
             )
         )
         def record_insert(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             items: list[JSONObject] | None = None,
             verify_write: bool = True,
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_insert_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 items=items,
                 verify_write=verify_write,
@@ -573,6 +578,7 @@ class RecordTools(ToolBase):
             )
         )
         def record_update(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             record_id: str | None = None,
             fields: JSONObject | None = None,
@@ -583,7 +589,7 @@ class RecordTools(ToolBase):
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_update_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 record_id=record_id,
                 fields=fields,
@@ -601,6 +607,7 @@ class RecordTools(ToolBase):
             )
         )
         def record_delete(
+            profile: str = DEFAULT_PROFILE,
             app_key: str = "",
             record_id: str | None = None,
             record_ids: list[str] | None = None,
@@ -608,7 +615,7 @@ class RecordTools(ToolBase):
             output_profile: str = "normal",
         ) -> JSONObject:
             return self.record_delete_public(
-                profile=DEFAULT_PROFILE,
+                profile=profile,
                 app_key=app_key,
                 record_id=record_id,
                 record_ids=record_ids or [],
@@ -11896,6 +11903,8 @@ class RecordTools(ToolBase):
         schema: JSONObject = {}
         if isinstance(raw.get("subQuestions"), list):
             schema["formQues"] = [raw["subQuestions"]]
+        elif isinstance(raw.get("subQues"), list):
+            schema["formQues"] = [raw["subQues"]]
         elif isinstance(raw.get("innerQuestions"), list):
             schema["formQues"] = raw["innerQuestions"]
         index = _build_field_index(schema)
@@ -14045,6 +14054,7 @@ class RecordTools(ToolBase):
                     or len(count_mismatches) > mismatch_before
                 ):
                     continue
+                continue
             expected_value = _canonicalize_answer_value_for_compare(answer, field)
             actual_value = _canonicalize_answer_value_for_compare(actual, field)
             if not _canonical_value_is_empty(expected_value) and _canonical_value_is_empty(actual_value):
@@ -18819,12 +18829,14 @@ def _extract_sort_selector(item: JSONObject) -> JSONValue:
     return None
 
 
-def _normalize_public_column_selectors(columns: list[JSONObject | int]) -> list[int]:
+def _normalize_public_column_selectors(columns: list[JSONObject | int | str]) -> list[int]:
     normalized: list[int] = []
     for item in columns:
         field_id: int | None = None
         if isinstance(item, int):
             field_id = item
+        elif isinstance(item, str):
+            field_id = _coerce_count(item)
         elif isinstance(item, dict):
             _ensure_allowed_record_list_keys(
                 item,
@@ -18836,19 +18848,21 @@ def _normalize_public_column_selectors(columns: list[JSONObject | int]) -> list[
         if field_id is None or field_id < 0:
             raise_tool_error(
                 QingflowApiError.config_error(
-                    "columns must be a list of field_id integers or {field_id} objects"
+                    "columns must be a list of field_id integers, integer strings, or {field_id} objects"
                 )
             )
         normalized.append(field_id)
     return normalized
 
 
-def _normalize_public_query_field_selectors(query_fields: list[JSONObject | int]) -> list[int]:
+def _normalize_public_query_field_selectors(query_fields: list[JSONObject | int | str]) -> list[int]:
     normalized: list[int] = []
     for item in query_fields:
         field_id: int | None = None
         if isinstance(item, int):
             field_id = item
+        elif isinstance(item, str):
+            field_id = _coerce_count(item)
         elif isinstance(item, dict):
             _ensure_allowed_record_list_keys(
                 item,
@@ -18860,7 +18874,7 @@ def _normalize_public_query_field_selectors(query_fields: list[JSONObject | int]
         if field_id is None or field_id < 0:
             raise_tool_error(
                 QingflowApiError.config_error(
-                    "query_fields must be a list of field_id integers or {field_id} objects"
+                    "query_fields must be a list of field_id integers, integer strings, or {field_id} objects"
                 )
             )
         normalized.append(field_id)