@qingflow-tech/qingflow-cli 1.1.39 → 1.1.41

package/src/qingflow_mcp/tools/custom_button_tools.py

@@ -5,7 +5,7 @@ from copy import deepcopy
 from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
 from ..json_types import JSONObject
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class CustomButtonTools(ToolBase):
@@ -18,7 +18,6 @@ class CustomButtonTools(ToolBase):
     3. 支持草稿与发布态按钮配置维护。
     """
 
-    @tool_cn_name("自定义按钮列表")
     def custom_button_list(
         self,
         *,
@@ -82,9 +81,8 @@ class CustomButtonTools(ToolBase):
                 response["summary"] = items
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='自定义按钮列表')
 
-    @tool_cn_name("自定义按钮详情")
     def custom_button_get(
         self,
         *,
@@ -135,9 +133,8 @@ class CustomButtonTools(ToolBase):
                 response["summary"] = self._compact_button_detail(result if isinstance(result, dict) else {})
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='自定义按钮详情')
 
-    @tool_cn_name("创建自定义按钮")
     def custom_button_create(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行工具方法逻辑。"""
         self._require_app_key(app_key)
@@ -147,9 +144,8 @@ class CustomButtonTools(ToolBase):
             result = self.backend.request("POST", context, f"/app/{app_key}/customButton", json_body=deepcopy(body))
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='创建自定义按钮')
 
-    @tool_cn_name("更新自定义按钮")
     def custom_button_update(self, *, profile: str, app_key: str, button_id: int, payload: JSONObject) -> JSONObject:
         """执行工具方法逻辑。"""
         self._require_app_key(app_key)
@@ -175,9 +171,8 @@ class CustomButtonTools(ToolBase):
                 target="custom button configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新自定义按钮')
 
-    @tool_cn_name("删除自定义按钮")
     def custom_button_delete(self, *, profile: str, app_key: str, button_id: int) -> JSONObject:
         """执行工具方法逻辑。"""
         self._require_app_key(app_key)
@@ -197,7 +192,7 @@ class CustomButtonTools(ToolBase):
                 target="custom button configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='删除自定义按钮')
 
     def _require_app_key(self, app_key: str) -> None:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/directory_tools.py

@@ -7,7 +7,7 @@ from mcp.server.fastmcp import FastMCP
 
 from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 ALLOWED_DIRECTORY_SEARCH_SCOPES = {"MEMBER", "DEPT"}
@@ -139,7 +139,6 @@ class DirectoryTools(ToolBase):
                 page_size=page_size,
             )
 
-    @tool_cn_name("通讯录搜索")
     def directory_search(
         self,
         *,
@@ -187,7 +186,7 @@ class DirectoryTools(ToolBase):
                 "result": result,
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='通讯录搜索')
         items = [item for item in _directory_items(raw.get("result")) if isinstance(item, dict)]
         return self._public_directory_response(
             raw,
@@ -202,7 +201,6 @@ class DirectoryTools(ToolBase):
             selection={"query": query, "scopes": normalized_scopes},
         )
 
-    @tool_cn_name("内部成员列表")
     def directory_list_internal_users(
         self,
         *,
@@ -246,7 +244,7 @@ class DirectoryTools(ToolBase):
                 "result": result,
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='内部成员列表')
         items = [item for item in _directory_items(raw.get("result")) if isinstance(item, dict)]
         return self._public_directory_response(
             raw,
@@ -261,7 +259,6 @@ class DirectoryTools(ToolBase):
             selection={"keyword": keyword, "department_id": dept_id, "role_id": role_id, "include_disabled": contain_disable},
         )
 
-    @tool_cn_name("内部成员全量")
     def directory_list_all_internal_users(
         self,
         *,
@@ -343,7 +340,7 @@ class DirectoryTools(ToolBase):
                 },
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='内部成员全量')
         return self._public_directory_response(
             raw,
             items=[item for item in raw.get("items", []) if isinstance(item, dict)],
@@ -351,7 +348,6 @@ class DirectoryTools(ToolBase):
             selection={"keyword": keyword, "department_id": dept_id, "role_id": role_id, "include_disabled": contain_disable},
         )
 
-    @tool_cn_name("内部部门列表")
     def directory_list_internal_departments(
         self,
         *,
@@ -408,7 +404,7 @@ class DirectoryTools(ToolBase):
                     },
                 }
 
-            raw = self._run(profile, runner)
+            raw = self._run(profile, runner, tool_name='内部部门列表')
             items = [item for item in raw.get("items", []) if isinstance(item, dict)]
             return self._public_directory_response(
                 raw,
@@ -449,7 +445,7 @@ class DirectoryTools(ToolBase):
                 "result": result,
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='内部部门列表')
         items = [item for item in _directory_items(raw.get("page")) if isinstance(item, dict)]
         return self._public_directory_response(
             raw,
@@ -464,7 +460,6 @@ class DirectoryTools(ToolBase):
             selection={"keyword": normalized_keyword},
         )
 
-    @tool_cn_name("部门树全量")
     def directory_list_all_departments(
         self,
         *,
@@ -519,7 +514,7 @@ class DirectoryTools(ToolBase):
                 },
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='部门树全量')
         return self._public_directory_response(
             raw,
             items=[item for item in raw.get("items", []) if isinstance(item, dict)],
@@ -527,7 +522,6 @@ class DirectoryTools(ToolBase):
             selection={"parent_department_id": parent_dept_id, "max_depth": max_depth, "max_items": max_items},
         )
 
-    @tool_cn_name("子部门列表")
     def directory_list_sub_departments(self, *, profile: str, parent_dept_id: int | None) -> dict[str, Any]:
         """执行组织目录相关逻辑。"""
         def runner(session_profile, context):
@@ -553,7 +547,7 @@ class DirectoryTools(ToolBase):
                 "items": result,
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='子部门列表')
         items = [item for item in raw.get("items", []) if isinstance(item, dict)]
         return self._public_directory_response(
             raw,
@@ -562,7 +556,6 @@ class DirectoryTools(ToolBase):
             selection={"parent_department_id": parent_dept_id},
         )
 
-    @tool_cn_name("外部联系人列表")
     def directory_list_external_members(
         self,
         *,
@@ -618,7 +611,7 @@ class DirectoryTools(ToolBase):
                 "simple": simple,
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='外部联系人列表')
         items = [item for item in _directory_items(raw.get("page")) if isinstance(item, dict)]
         return self._public_directory_response(
             raw,

package/src/qingflow_mcp/tools/export_tools.py

@@ -16,7 +16,7 @@ from ..config import DEFAULT_PROFILE, DEFAULT_RECORD_LIST_TYPE
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, message_looks_like_invalid_token
 from ..export_store import ExportJobStore
 from ..json_types import JSONObject
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 from .record_tools import (
     AccessibleViewRoute,
     DEFAULT_LIST_PAGE_SIZE,
@@ -131,7 +131,6 @@ class ExportTools(ToolBase):
                 wait_timeout_seconds=wait_timeout_seconds,
             )
 
-    @tool_cn_name("记录导出启动")
     def record_export_start(
         self,
         *,
@@ -277,7 +276,7 @@ class ExportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='记录导出启动')
         except RuntimeError as exc:
             return self._runtime_error_as_result(
                 exc,
@@ -285,7 +284,6 @@ class ExportTools(ToolBase):
                 extra={"app_key": normalized_app_key, "view_id": normalized_view_id},
             )
 
-    @tool_cn_name("记录导出状态")
     def record_export_status_get(
         self,
         *,
@@ -318,7 +316,7 @@ class ExportTools(ToolBase):
             return self._status_payload_from_snapshot(local_job, normalized_handle, snapshot)
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='记录导出状态')
         except RuntimeError as exc:
             return self._runtime_error_as_result(
                 exc,
@@ -326,7 +324,6 @@ class ExportTools(ToolBase):
                 extra={"export_handle": normalized_handle},
             )
 
-    @tool_cn_name("记录导出结果")
     def record_export_get(
         self,
         *,
@@ -454,7 +451,7 @@ class ExportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='记录导出结果')
         except RuntimeError as exc:
             return self._runtime_error_as_result(
                 exc,
@@ -462,7 +459,6 @@ class ExportTools(ToolBase):
                 extra={"export_handle": normalized_handle},
             )
 
-    @tool_cn_name("记录直接导出")
     def record_export_direct(
         self,
         *,
@@ -637,7 +633,7 @@ class ExportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='记录直接导出')
         except RuntimeError as exc:
             return self._runtime_error_as_result(
                 exc,

package/src/qingflow_mcp/tools/feedback_tools.py

@@ -8,7 +8,6 @@ from ..backend_client import BackendClient
 from ..config import get_feedback_app_key, get_feedback_base_url, get_feedback_qsource_token, normalize_base_url
 from ..errors import QingflowApiError, raise_tool_error
 from ..json_types import JSONObject
-from .base import tool_cn_name
 
 
 CATEGORY_MAP = {
@@ -68,7 +67,6 @@ class FeedbackTools:
                 note=note,
             )
 
-    @tool_cn_name("提交反馈")
     def feedback_submit(
         self,
         *,

package/src/qingflow_mcp/tools/file_tools.py

@@ -14,7 +14,7 @@ from mcp.server.fastmcp import FastMCP
 from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
 from ..json_types import JSONObject
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 ATTACHMENT_UPLOAD_INFO_FALLBACK_CODES = {40118}
@@ -79,7 +79,6 @@ class FileTools(ToolBase):
                 file_related_url=file_related_url,
             )
 
-    @tool_cn_name("文件上传信息")
     def file_get_upload_info(
         self,
         *,
@@ -120,9 +119,8 @@ class FileTools(ToolBase):
                 "result": upload_info["result"],
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='文件上传信息')
 
-    @tool_cn_name("本地文件上传")
     def file_upload_local(
         self,
         *,
@@ -204,7 +202,7 @@ class FileTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='本地文件上传')
 
     def _build_file_upload_bo(
         self,

package/src/qingflow_mcp/tools/import_tools.py

@@ -21,7 +21,7 @@ from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, mes
 from ..import_store import ImportJobStore, ImportVerificationStore
 from ..json_types import JSONObject
 from .app_tools import _derive_import_capability
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 from .file_tools import FileTools
 from .record_tools import RecordTools, _build_field_index, _normalize_form_schema
 
@@ -174,7 +174,6 @@ class ImportTools(ToolBase):
                 process_id_str=process_id_str,
             )
 
-    @tool_cn_name("导入 Schema")
     def record_import_schema_get(
         self,
         *,
@@ -259,9 +258,8 @@ class ImportTools(ToolBase):
                 response["import_capability"] = import_capability
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导入 Schema')
 
-    @tool_cn_name("导入模板")
     def record_import_template_get(
         self,
         *,
@@ -386,11 +384,10 @@ class ImportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='导入模板')
         except RuntimeError as exc:
             return self._runtime_error_as_result(exc, error_code="IMPORT_TEMPLATE_UNAUTHORIZED")
 
-    @tool_cn_name("导入校验")
     def record_import_verify(
         self,
         *,
@@ -612,7 +609,7 @@ class ImportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='导入校验')
         except RuntimeError as exc:
             return self._runtime_error_as_result(
                 exc,
@@ -620,7 +617,6 @@ class ImportTools(ToolBase):
                 extra={"can_import": _runtime_import_can_import_value(exc)},
             )
 
-    @tool_cn_name("导入修复")
     def record_import_repair_local(
         self,
         *,
@@ -727,11 +723,10 @@ class ImportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='导入修复')
         except RuntimeError as exc:
             return self._runtime_error_as_result(exc, error_code="IMPORT_REPAIR_FORMAT_UNSUPPORTED")
 
-    @tool_cn_name("开始导入")
     def record_import_start(
         self,
         *,
@@ -848,11 +843,10 @@ class ImportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='开始导入')
         except RuntimeError as exc:
             return self._runtime_error_as_result(exc, error_code="IMPORT_VERIFICATION_FAILED", extra={"accepted": False})
 
-    @tool_cn_name("导入状态")
     def record_import_status_get(
         self,
         *,
@@ -1048,7 +1042,7 @@ class ImportTools(ToolBase):
             }
 
         try:
-            return self._run(profile, runner)
+            return self._run(profile, runner, tool_name='导入状态')
         except RuntimeError as exc:
             return self._runtime_error_as_result(
                 exc,

package/src/qingflow_mcp/tools/navigation_tools.py

@@ -5,7 +5,7 @@ from mcp.server.fastmcp import FastMCP
 from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
 from ..json_types import JSONObject
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class NavigationTools(ToolBase):
@@ -69,16 +69,14 @@ class NavigationTools(ToolBase):
         def navigation_reorder(profile: str = DEFAULT_PROFILE, payload: list[JSONObject] | None = None) -> JSONObject:
             return self.navigation_reorder(profile=profile, payload=payload or [])
 
-    @tool_cn_name("导航已发布列表")
     def navigation_list_published(self, *, profile: str, page_num: int = 1, page_size: int = 50) -> JSONObject:
         """执行工具方法逻辑。"""
         def runner(session_profile, context):
             result = self.backend.request("GET", context, "/navigation", params={"pageNum": page_num, "pageSize": page_size})
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "page": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导航已发布列表')
 
-    @tool_cn_name("导航草稿分页")
     def navigation_list_draft_page(self, *, profile: str, page_num: int = 1, page_size: int = 50, query_key: str | None = None) -> JSONObject:
         """执行工具方法逻辑。"""
         def runner(session_profile, context):
@@ -106,9 +104,8 @@ class NavigationTools(ToolBase):
                 response["verification"] = {"draft_readable": False, "published_fallback_used": True}
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导航草稿分页')
 
-    @tool_cn_name("导航草稿全量")
     def navigation_list_draft_all(self, *, profile: str, query_key: str | None = None) -> JSONObject:
         """执行工具方法逻辑。"""
         def runner(session_profile, context):
@@ -136,9 +133,8 @@ class NavigationTools(ToolBase):
                 response["verification"] = {"draft_readable": False, "published_fallback_used": True}
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导航草稿全量')
 
-    @tool_cn_name("导航详情")
     def navigation_get_detail(self, *, profile: str, navigation_item_id: int, status: str = "draft") -> JSONObject:
         """执行工具方法逻辑。"""
         self._require_navigation_item_id(navigation_item_id)
@@ -178,18 +174,16 @@ class NavigationTools(ToolBase):
                 response["verification"] = {"draft_readable": False, "published_fallback_used": True}
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导航详情')
 
-    @tool_cn_name("导航发布状态")
     def navigation_get_status(self, *, profile: str) -> JSONObject:
         """执行工具方法逻辑。"""
         def runner(session_profile, context):
             result = self.backend.request("GET", context, "/navigation/status")
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导航发布状态')
 
-    @tool_cn_name("设置导航可见性")
     def navigation_set_visible(self, *, profile: str, payload: JSONObject) -> JSONObject:
         """执行工具方法逻辑。"""
         body = self._require_dict(payload)
@@ -198,9 +192,8 @@ class NavigationTools(ToolBase):
             result = self.backend.request("POST", context, "/navigation/visible", json_body=body)
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='设置导航可见性')
 
-    @tool_cn_name("创建导航项")
     def navigation_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
         """执行工具方法逻辑。"""
         body = self._require_dict(payload)
@@ -209,9 +202,8 @@ class NavigationTools(ToolBase):
             result = self.backend.request("POST", context, "/navigation", json_body=body)
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='创建导航项')
 
-    @tool_cn_name("更新导航项")
     def navigation_update(self, *, profile: str, navigation_item_id: int, payload: JSONObject) -> JSONObject:
         """执行工具方法逻辑。"""
         self._require_navigation_item_id(navigation_item_id)
@@ -225,9 +217,8 @@ class NavigationTools(ToolBase):
                 target="navigation item configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新导航项')
 
-    @tool_cn_name("删除导航项")
     def navigation_delete(self, *, profile: str, navigation_item_id: int) -> JSONObject:
         """执行工具方法逻辑。"""
         self._require_navigation_item_id(navigation_item_id)
@@ -240,9 +231,8 @@ class NavigationTools(ToolBase):
                 target="navigation item configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='删除导航项')
 
-    @tool_cn_name("发布导航")
     def navigation_publish(self, *, profile: str, navigation_id: int) -> JSONObject:
         """执行工具方法逻辑。"""
         if navigation_id <= 0:
@@ -252,9 +242,8 @@ class NavigationTools(ToolBase):
             result = self.backend.request("POST", context, f"/navigation/publish/{navigation_id}")
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "navigation_id": navigation_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='发布导航')
 
-    @tool_cn_name("导航排序")
     def navigation_reorder(self, *, profile: str, payload: list[JSONObject]) -> JSONObject:
         """执行工具方法逻辑。"""
         if not isinstance(payload, list) or not payload:
@@ -264,7 +253,7 @@ class NavigationTools(ToolBase):
             result = self.backend.request("POST", context, "/navigation/ordinal", json_body=payload)
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='导航排序')
 
     def _require_navigation_item_id(self, navigation_item_id: int) -> None:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/package_tools.py

@@ -8,7 +8,7 @@ from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
 from ..json_types import JSONObject
 from ..solution.compiler.icon_utils import workspace_icon_config
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class PackageTools(ToolBase):
@@ -47,7 +47,6 @@ class PackageTools(ToolBase):
         def package_delete(profile: str = DEFAULT_PROFILE, tag_id: int = 0, deleted_all_data: bool = False) -> JSONObject:
             return self.package_delete(profile=profile, tag_id=tag_id, deleted_all_data=deleted_all_data)
 
-    @tool_cn_name("分组列表")
     def package_list(self, *, profile: str, trial_status: str = "all", include_raw: bool = False) -> JSONObject:
         """执行分组与包相关逻辑。"""
         def runner(session_profile, context):
@@ -68,9 +67,8 @@ class PackageTools(ToolBase):
                 response["summary"] = compact_items
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='分组列表')
 
-    @tool_cn_name("分组详情")
     def package_get(self, *, profile: str, tag_id: int, include_raw: bool = False) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -133,9 +131,8 @@ class PackageTools(ToolBase):
                 response["summary"] = compact
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='分组详情')
 
-    @tool_cn_name("分组基础信息")
     def package_get_base(self, *, profile: str, tag_id: int, include_raw: bool = False) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_readable_tag_id(tag_id)
@@ -177,9 +174,8 @@ class PackageTools(ToolBase):
                 response["summary"] = compact
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='分组基础信息')
 
-    @tool_cn_name("创建分组")
     def package_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
         """执行分组与包相关逻辑。"""
         body = self._require_dict(payload)
@@ -188,9 +184,8 @@ class PackageTools(ToolBase):
             result = self.backend.request("POST", context, "/tag", json_body=self._normalize_package_payload(body))
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='创建分组')
 
-    @tool_cn_name("更新分组")
     def package_update(self, *, profile: str, tag_id: int, payload: JSONObject) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -239,9 +234,8 @@ class PackageTools(ToolBase):
                 target="app package settings",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新分组')
 
-    @tool_cn_name("分组排序")
     def package_sort_items(self, *, profile: str, tag_id: int, tag_items: list[JSONObject]) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -255,9 +249,8 @@ class PackageTools(ToolBase):
             )
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "tag_id": tag_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='分组排序')
 
-    @tool_cn_name("创建分组分栏")
     def package_group_create(self, *, profile: str, tag_id: int, group_name: str) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -274,9 +267,8 @@ class PackageTools(ToolBase):
             )
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "tag_id": tag_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='创建分组分栏')
 
-    @tool_cn_name("更新分组分栏")
     def package_group_update(self, *, profile: str, tag_id: int, group_id: int, group_name: str) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -294,9 +286,8 @@ class PackageTools(ToolBase):
             )
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "tag_id": tag_id, "group_id": group_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新分组分栏')
 
-    @tool_cn_name("删除分组分栏")
     def package_group_delete(self, *, profile: str, tag_id: int, group_id: int) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -306,9 +297,8 @@ class PackageTools(ToolBase):
             result = self.backend.request("DELETE", context, f"/tag/{tag_id}/group/{group_id}")
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "tag_id": tag_id, "group_id": group_id, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='删除分组分栏')
 
-    @tool_cn_name("删除分组")
     def package_delete(self, *, profile: str, tag_id: int, deleted_all_data: bool = False) -> JSONObject:
         """执行分组与包相关逻辑。"""
         self._require_tag_id(tag_id)
@@ -326,7 +316,7 @@ class PackageTools(ToolBase):
                 target="app package and linked data",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='删除分组')
 
     def _require_tag_id(self, tag_id: int) -> None:
         """执行内部辅助逻辑。"""