@qingflow-tech/qingflow-cli 1.1.38 → 1.1.40

package/src/qingflow_mcp/tools/record_tools.py

@@ -32,7 +32,7 @@ from ..list_type_labels import (
     get_system_view_id,
     get_system_view_name,
 )
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 from .directory_tools import _directory_has_more, _directory_items
 
 
@@ -640,7 +640,6 @@ class RecordTools(ToolBase):
                 output_profile=output_profile,
             )
 
-    @tool_cn_name("记录 Schema")
     def record_schema_get(
         self,
         *,
@@ -764,9 +763,8 @@ class RecordTools(ToolBase):
                 response["field_count"] = len(fields)
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="记录 Schema")
 
-    @tool_cn_name("新增记录 Schema")
     def record_insert_schema_get_public(
         self,
         *,
@@ -881,9 +879,8 @@ class RecordTools(ToolBase):
                 )
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="新增记录 Schema")
 
-    @tool_cn_name("浏览记录 Schema")
     def record_browse_schema_get_public(
         self,
         *,
@@ -901,7 +898,6 @@ class RecordTools(ToolBase):
             output_profile=output_profile,
         )
 
-    @tool_cn_name("更新记录 Schema")
     def record_update_schema_get_public(
         self,
         *,
@@ -1140,7 +1136,7 @@ class RecordTools(ToolBase):
                 response["route_probe_summary"] = probe_summary
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="更新记录 Schema")
 
     def _record_update_schema_available_routes(self, matched_probes: list[RecordContextRouteProbe]) -> list[JSONObject]:
         routes: list[JSONObject] = [
@@ -1476,7 +1472,6 @@ class RecordTools(ToolBase):
             ]
         return "<text>"
 
-    @tool_cn_name("成员候选项")
     def record_member_candidates(
         self,
         *,
@@ -1618,9 +1613,8 @@ class RecordTools(ToolBase):
                 },
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="成员候选项")
 
-    @tool_cn_name("部门候选项")
     def record_department_candidates(
         self,
         *,
@@ -1779,9 +1773,8 @@ class RecordTools(ToolBase):
                 },
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="部门候选项")
 
-    @tool_cn_name("记录分析")
     def record_analyze(
         self,
         *,
@@ -1883,9 +1876,8 @@ class RecordTools(ToolBase):
                 extra_warnings=legacy_warnings + compatibility_warnings,
             )
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="记录分析")
 
-    @tool_cn_name("记录列表")
     def record_list(
         self,
         *,
@@ -1942,6 +1934,7 @@ class RecordTools(ToolBase):
             view_key=view_key,
             view_name=view_name,
             allow_default=False,
+            tool_name="记录列表",
         )
         if not _view_type_supports_analysis(view_route.view_type):
             raise_tool_error(
@@ -2086,9 +2079,8 @@ class RecordTools(ToolBase):
                 }
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="记录列表")
 
-    @tool_cn_name("记录访问")
     def record_access(
         self,
         *,
@@ -2124,6 +2116,7 @@ class RecordTools(ToolBase):
             view_key=None,
             view_name=None,
             allow_default=False,
+            tool_name="记录访问",
         )
         if not _view_type_supports_analysis(view_route.view_type):
             raise_tool_error(
@@ -2397,9 +2390,8 @@ class RecordTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="记录访问")
 
-    @tool_cn_name("记录详情")
     def record_get_public(
         self,
         *,
@@ -2481,9 +2473,8 @@ class RecordTools(ToolBase):
                         last_error = candidate_exc
                 raise last_error
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="记录详情")
 
-    @tool_cn_name("记录全量日志")
     def record_logs_get(
         self,
         *,
@@ -2650,7 +2641,7 @@ class RecordTools(ToolBase):
             payload["summary_path"] = str(summary_path)
             return payload
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="记录全量日志")
 
     def _record_get_detail_context(
         self,
@@ -3648,7 +3639,6 @@ class RecordTools(ToolBase):
                     return refreshed_url
         return None
 
-    @tool_cn_name("新增记录")
     def record_insert_public(
         self,
         *,
@@ -3672,6 +3662,7 @@ class RecordTools(ToolBase):
                 items=normalized_items,
                 verify_write=verify_write,
                 output_profile=normalized_output_profile,
+                tool_name="新增记录",
             )
         if fields is not None and not isinstance(fields, dict):
             raise_tool_error(QingflowApiError.config_error("fields must be an object map keyed by field title"))
@@ -3684,6 +3675,7 @@ class RecordTools(ToolBase):
             verify_write=verify_write,
             output_profile=normalized_output_profile,
             capture_exceptions=False,
+            tool_name="新增记录",
         )
 
     def _reject_record_insert_system_fields(self, field_maps: list[JSONObject]) -> None:
@@ -3713,6 +3705,7 @@ class RecordTools(ToolBase):
         verify_write: bool,
         output_profile: str,
         capture_exceptions: bool,
+        tool_name: str = "新增记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         submit_type_value = self._normalize_record_write_submit_type("submit")
@@ -3730,6 +3723,7 @@ class RecordTools(ToolBase):
                 list_type=None,
                 view_key=None,
                 view_name=None,
+                tool_name=tool_name,
             )
             preflight_used_force_refresh = self._record_preflight_used_force_refresh(raw_preflight)
             preflight_data = cast(JSONObject, raw_preflight.get("data", {}))
@@ -3821,6 +3815,7 @@ class RecordTools(ToolBase):
         items: list[JSONObject],
         verify_write: bool,
         output_profile: str,
+        tool_name: str = "新增记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         responses: list[JSONObject] = []
@@ -3833,6 +3828,7 @@ class RecordTools(ToolBase):
                     verify_write=verify_write,
                     output_profile=output_profile,
                     capture_exceptions=True,
+                    tool_name=tool_name,
                 )
             )
         return self._record_insert_batch_response(
@@ -4182,7 +4178,6 @@ class RecordTools(ToolBase):
             return "重新调用 schema 工具确认字段标题或 field_id 后，只重试本行。"
         return "修正该字段值后只重试本行。"
 
-    @tool_cn_name("更新记录")
     def record_update_public(
         self,
         *,
@@ -4216,6 +4211,7 @@ class RecordTools(ToolBase):
                 dry_run=dry_run,
                 verify_write=verify_write,
                 output_profile=normalized_output_profile,
+                tool_name="更新记录",
             )
         if dry_run:
             raise_tool_error(QingflowApiError.config_error("dry_run currently requires items"))
@@ -4232,6 +4228,7 @@ class RecordTools(ToolBase):
             view_id=view_id,
             verify_write=verify_write,
             output_profile=normalized_output_profile,
+            tool_name="更新记录",
         )
 
     def _record_update_public_single(
@@ -4245,6 +4242,7 @@ class RecordTools(ToolBase):
         verify_write: bool,
         output_profile: str,
         capture_exceptions: bool = False,
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         write_state = {"attempted": False}
@@ -4258,6 +4256,7 @@ class RecordTools(ToolBase):
                 verify_write=verify_write,
                 output_profile=output_profile,
                 write_attempted_ref=lambda value: write_state.__setitem__("attempted", value),
+                tool_name=tool_name,
             )
         except (QingflowApiError, RuntimeError) as exc:
             if not capture_exceptions:
@@ -4284,6 +4283,7 @@ class RecordTools(ToolBase):
         verify_write: bool,
         output_profile: str,
         write_attempted_ref: Callable[[bool], None],
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         preflight_kwargs: dict[str, Any] = {
@@ -4295,6 +4295,7 @@ class RecordTools(ToolBase):
         }
         if view_id is not None:
             preflight_kwargs["preferred_view_id"] = view_id
+        preflight_kwargs["tool_name"] = tool_name
         raw_preflight = self._preflight_record_update_with_auto_view(**preflight_kwargs)
         preflight_used_force_refresh = self._record_preflight_used_force_refresh(raw_preflight)
         preflight_data = cast(JSONObject, raw_preflight.get("data", {}))
@@ -4324,6 +4325,7 @@ class RecordTools(ToolBase):
             preflight_data=preflight_data,
             verify_write=verify_write,
             force_refresh_form=preflight_used_force_refresh,
+            tool_name=tool_name,
         )
         if route_blocker is not None:
             return self._record_update_route_blocked_response(
@@ -4357,6 +4359,7 @@ class RecordTools(ToolBase):
         preflight_data: JSONObject,
         verify_write: bool,
         force_refresh_form: bool,
+        tool_name: str = "更新记录",
     ) -> tuple[JSONObject | None, list[JSONObject], JSONObject | None]:
         """Try record update routes in the same order a frontend user would expect."""
         tried_routes: list[JSONObject] = []
@@ -4421,6 +4424,7 @@ class RecordTools(ToolBase):
                     answers=normalized_answers,
                     verify_write=verify_write,
                     force_refresh_form=force_refresh_form,
+                    tool_name=tool_name,
                 )
                 view_attempt["status"] = "success"
                 tried_routes.append(view_attempt)
@@ -4471,6 +4475,7 @@ class RecordTools(ToolBase):
                     answers=normalized_answers,
                     verify_write=verify_write,
                     force_refresh_form=force_refresh_form,
+                    tool_name=tool_name,
                 )
                 task_attempt["status"] = "success"
                 tried_routes.append(task_attempt)
@@ -4800,7 +4805,7 @@ class RecordTools(ToolBase):
                 "effective_editable_question_ids": sorted(effective_editable_question_ids),
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="更新记录")
 
     def _record_update_compact_task_match(self, item: JSONObject) -> JSONObject:
         return {
@@ -4896,6 +4901,7 @@ class RecordTools(ToolBase):
         answers: list[JSONObject],
         verify_write: bool,
         force_refresh_form: bool,
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         normalized_apply_id = self._validate_app_and_record(app_key, apply_id)
         normalized_view_key = view_key.strip()
@@ -4942,7 +4948,7 @@ class RecordTools(ToolBase):
                 target="record data",
             )
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _record_update_via_task_save_only(
         self,
@@ -4954,6 +4960,7 @@ class RecordTools(ToolBase):
         answers: list[JSONObject],
         verify_write: bool,
         force_refresh_form: bool,
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         normalized_apply_id = self._validate_app_and_record(app_key, apply_id)
         if workflow_node_id <= 0:
@@ -4998,7 +5005,7 @@ class RecordTools(ToolBase):
                 target="record data",
             )
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _record_update_public_batch(
         self,
@@ -5010,6 +5017,7 @@ class RecordTools(ToolBase):
         dry_run: bool,
         verify_write: bool,
         output_profile: str,
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         preflight_responses = [
@@ -5020,6 +5028,7 @@ class RecordTools(ToolBase):
                 fields=cast(JSONObject, item["fields"]),
                 view_id=view_id,
                 output_profile=output_profile,
+                tool_name=tool_name,
             )
             for item in items
         ]
@@ -5051,6 +5060,7 @@ class RecordTools(ToolBase):
                         verify_write=verify_write,
                         output_profile=output_profile,
                         capture_exceptions=True,
+                        tool_name=tool_name,
                     )
                 )
             except (QingflowApiError, RuntimeError) as exc:
@@ -5083,6 +5093,7 @@ class RecordTools(ToolBase):
         fields: JSONObject,
         view_id: str | None,
         output_profile: str,
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         preflight_kwargs: dict[str, Any] = {
@@ -5094,6 +5105,7 @@ class RecordTools(ToolBase):
         }
         if view_id is not None:
             preflight_kwargs["preferred_view_id"] = view_id
+        preflight_kwargs["tool_name"] = tool_name
         raw_preflight = self._preflight_record_update_with_auto_view(**preflight_kwargs)
         preflight_data = cast(JSONObject, raw_preflight.get("data", {}))
         normalized_payload = self._record_write_normalized_payload(
@@ -5336,6 +5348,7 @@ class RecordTools(ToolBase):
         fields: JSONObject,
         preferred_view_id: str | None = None,
         force_refresh_form: bool,
+        tool_name: str = "更新记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         def runner(session_profile, context):
@@ -5617,7 +5630,7 @@ class RecordTools(ToolBase):
                 cast(JSONObject, result.setdefault("data", {}))["schema_force_refreshed"] = True
             return result
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _build_record_update_union_preflight(
         self,
@@ -6182,7 +6195,6 @@ class RecordTools(ToolBase):
             dept_member_cache={},
         )
 
-    @tool_cn_name("删除记录")
     def record_delete_public(
         self,
         *,
@@ -6227,6 +6239,7 @@ class RecordTools(ToolBase):
             list_type=delete_list_type,
             normalized_payload=normalized_payload,
             output_profile=normalized_output_profile,
+            tool_name="删除记录",
         )
 
     def _resolve_record_delete_list_type(self, *, view_id: str | None, list_type: int | None) -> int:
@@ -6286,6 +6299,7 @@ class RecordTools(ToolBase):
         list_type: int,
         normalized_payload: JSONObject,
         output_profile: str,
+        tool_name: str = "删除记录",
     ) -> JSONObject:
         items: list[JSONObject] = []
         request_route: JSONObject | None = None
@@ -6293,7 +6307,13 @@ class RecordTools(ToolBase):
         for index, delete_id in enumerate(delete_ids):
             record_id_text = stringify_backend_id(delete_id)
             try:
-                raw_apply = self._record_delete_many(profile=profile, app_key=app_key, record_ids=[delete_id], list_type=list_type)
+                raw_apply = self._record_delete_many(
+                    profile=profile,
+                    app_key=app_key,
+                    record_ids=[delete_id],
+                    list_type=list_type,
+                    tool_name=tool_name,
+                )
                 request_route = cast(JSONObject, raw_apply.get("request_route")) if isinstance(raw_apply.get("request_route"), dict) else request_route
                 ws_id = raw_apply.get("ws_id", ws_id)
                 single_payload = {
@@ -6399,7 +6419,6 @@ class RecordTools(ToolBase):
             },
         }
 
-    @tool_cn_name("写入记录")
     def record_write(
         self,
         *,
@@ -6462,6 +6481,7 @@ class RecordTools(ToolBase):
                 list_type=list_type,
                 view_key=view_key,
                 view_name=view_name,
+                tool_name="写入记录",
             )
             preflight_used_force_refresh = self._record_preflight_used_force_refresh(raw_preflight)
             preflight_data = cast(JSONObject, raw_preflight.get("data", {}))
@@ -6536,6 +6556,7 @@ class RecordTools(ToolBase):
                 list_type=list_type,
                 view_key=view_key,
                 view_name=view_name,
+                tool_name="写入记录",
             )
             preflight_used_force_refresh = self._record_preflight_used_force_refresh(raw_preflight)
             preflight_data = cast(JSONObject, raw_preflight.get("data", {}))
@@ -6605,7 +6626,13 @@ class RecordTools(ToolBase):
             "submit_type": submit_type_value,
             "selection": {"view_id": view_id, "list_type": delete_list_type},
         }
-        raw_apply = self._record_delete_many(profile=profile, app_key=app_key, record_ids=delete_ids, list_type=delete_list_type)
+        raw_apply = self._record_delete_many(
+            profile=profile,
+            app_key=app_key,
+            record_ids=delete_ids,
+            list_type=delete_list_type,
+            tool_name="写入记录",
+        )
         return self._record_write_apply_response(
             raw_apply,
             operation="delete",
@@ -8800,6 +8827,7 @@ class RecordTools(ToolBase):
         list_type: int | None,
         view_key: str | None,
         view_name: str | None,
+        tool_name: str = "写入记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         if not app_key:
@@ -8845,7 +8873,7 @@ class RecordTools(ToolBase):
                 "data": plan_data,
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _build_record_write_preflight(
         self,
@@ -9372,7 +9400,6 @@ class RecordTools(ToolBase):
                 merged_by_id[que_id] = item
         return [merged_by_id[que_id] for que_id in order]
 
-    @tool_cn_name("查询记录")
     def record_query(
         self,
         *,
@@ -9430,6 +9457,7 @@ class RecordTools(ToolBase):
                 max_columns=max_columns,
                 output_profile=output_profile,
                 list_type=list_type,
+                tool_name="查询记录",
             )
         return self._record_query_list(
             profile=profile,
@@ -9450,9 +9478,9 @@ class RecordTools(ToolBase):
             list_type=list_type,
             view_key=view_key,
             view_name=view_name,
+            tool_name="查询记录",
         )
 
-    @tool_cn_name("创建记录")
     def record_create(
         self,
         *,
@@ -9507,12 +9535,11 @@ class RecordTools(ToolBase):
                 "resource": _record_resource_payload(apply_id),
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="创建记录")
 
     # listType 降级顺序（内部 record_get）
     _INTERNAL_GET_LIST_TYPE_FALLBACKS = [DEFAULT_RECORD_LIST_TYPE, 14, 1, 2, 12]
 
-    @tool_cn_name("获取记录")
     def record_get(
         self,
         *,
@@ -9570,9 +9597,8 @@ class RecordTools(ToolBase):
                 "result": result,
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="获取记录")
 
-    @tool_cn_name("搜索记录")
     def record_search(
         self,
         *,
@@ -9638,9 +9664,8 @@ class RecordTools(ToolBase):
                 "effective_count": effective_count,
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="搜索记录")
 
-    @tool_cn_name("修改记录")
     def record_update(
         self,
         *,
@@ -9727,9 +9752,8 @@ class RecordTools(ToolBase):
                 target="record data",
             )
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="修改记录")
 
-    @tool_cn_name("删除记录（兼容）")
     def record_delete(self, *, profile: str, app_key: str, apply_id: int, list_type: int) -> JSONObject:
         """执行记录相关逻辑。"""
         normalized_apply_id = self._validate_app_and_record(app_key, apply_id)
@@ -9756,7 +9780,7 @@ class RecordTools(ToolBase):
                 target="record data",
             )
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="删除记录（兼容）")
 
     def _record_query_record(
         self,
@@ -9768,6 +9792,7 @@ class RecordTools(ToolBase):
         max_columns: int | None,
         output_profile: str,
         list_type: int,
+        tool_name: str = "查询记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         if not app_key:
@@ -9846,7 +9871,7 @@ class RecordTools(ToolBase):
                 }
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _record_query_list(
         self,
@@ -9869,6 +9894,7 @@ class RecordTools(ToolBase):
         list_type: int,
         view_key: str | None = None,
         view_name: str | None = None,
+        tool_name: str = "查询记录",
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
         if not app_key:
@@ -10128,7 +10154,7 @@ class RecordTools(ToolBase):
                 }
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _record_list_query_view_fields(
         self,
@@ -10729,12 +10755,13 @@ class RecordTools(ToolBase):
         profile: str,
         app_key: str,
         resolved_view: AccessibleViewRoute,
+        tool_name: str = "记录列表",
     ) -> list[int]:
         """执行内部辅助逻辑。"""
         def runner(_session_profile, context):
             return self._derive_public_list_columns(profile, context, app_key, resolved_view)
 
-        return cast(list[int], self._run_record_tool(profile, runner))
+        return cast(list[int], self._run_record_tool(profile, runner, tool_name=tool_name))
 
     def _resolve_record_list_query_fields_for_public(
         self,
@@ -10743,6 +10770,7 @@ class RecordTools(ToolBase):
         app_key: str,
         resolved_view: AccessibleViewRoute,
         selectors: list[int],
+        tool_name: str = "记录列表",
     ) -> list[int]:
         """Resolve record_list query_fields against the selected view-readable schema."""
         if not selectors:
@@ -10759,7 +10787,7 @@ class RecordTools(ToolBase):
             index = cast(FieldIndex, browse_scope["index"])
             return self._resolve_record_list_query_fields(selectors, index, view_route=resolved_view)
 
-        return cast(list[int], self._run_record_tool(profile, runner))
+        return cast(list[int], self._run_record_tool(profile, runner, tool_name=tool_name))
 
     def _derive_public_list_columns(
         self,
@@ -10842,6 +10870,7 @@ class RecordTools(ToolBase):
         view_key: str | None,
         view_name: str | None,
         allow_default: bool,
+        tool_name: str = "记录列表",
     ) -> tuple[AccessibleViewRoute, list[JSONObject]]:
         """执行内部辅助逻辑。"""
         def runner(_session_profile, context):
@@ -10856,7 +10885,7 @@ class RecordTools(ToolBase):
                 allow_default=allow_default,
             )
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _resolve_accessible_view_route(
         self,
@@ -11993,10 +12022,17 @@ class RecordTools(ToolBase):
         except RecordInputError:
             return None
 
-    def _run_record_tool(self, profile: str, func, *, require_workspace: bool = True):  # type: ignore[no-untyped-def]
+    def _run_record_tool(
+        self,
+        profile: str,
+        func,
+        *,
+        require_workspace: bool = True,
+        tool_name: str,
+    ):  # type: ignore[no-untyped-def]
         """执行内部辅助逻辑。"""
         try:
-            return self._run(profile, func, require_workspace=require_workspace)
+            return self._run(profile, func, require_workspace=require_workspace, tool_name=tool_name)
         except RecordInputError as error:
             raise_tool_error(
                 QingflowApiError(
@@ -12622,7 +12658,15 @@ class RecordTools(ToolBase):
             )
         return errors
 
-    def _record_delete_many(self, *, profile: str, app_key: str, record_ids: list[int], list_type: int = DEFAULT_RECORD_LIST_TYPE) -> JSONObject:
+    def _record_delete_many(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        record_ids: list[int],
+        list_type: int = DEFAULT_RECORD_LIST_TYPE,
+        tool_name: str = "删除记录",
+    ) -> JSONObject:
         """执行内部辅助逻辑。"""
         if not app_key:
             raise_tool_error(QingflowApiError.config_error("app_key is required"))
@@ -12646,7 +12690,7 @@ class RecordTools(ToolBase):
                 "ok": True,
             }
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name=tool_name)
 
     def _resolve_field_selector(self, selector: str | int | None, index: FieldIndex, *, location: str) -> FormField:
         """执行内部辅助逻辑。"""