@qingflow-tech/qingflow-cli 1.1.39 → 1.1.40

package/src/qingflow_mcp/tools/approval_tools.py

@@ -9,7 +9,7 @@ from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_int, backend_code_value_int, is_auth_like_error, message_looks_like_invalid_token, raise_tool_error
 from ..json_types import JSONObject
 from ..list_type_labels import get_record_list_type_label
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class ApprovalTools(ToolBase):
@@ -149,7 +149,6 @@ class ApprovalTools(ToolBase):
                 keyword=keyword,
             )
 
-    @tool_cn_name("写评论")
     def record_comment_write(self, *, profile: str, app_key: str, record_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         raw = self.record_comment_add(profile=profile, app_key=app_key, apply_id=record_id, payload=payload)
@@ -160,7 +159,6 @@ class ApprovalTools(ToolBase):
             selection={},
         )
 
-    @tool_cn_name("评论提及")
     def record_comment_mentions(
         self,
         *,
@@ -207,7 +205,6 @@ class ApprovalTools(ToolBase):
             selection=selection,
         )
 
-    @tool_cn_name("任务通过")
     def task_approve(self, *, profile: str, app_key: str, record_id: int, payload: dict[str, Any], fields: dict[str, Any] | None = None) -> dict[str, Any]:
         """执行任务相关逻辑。"""
         if fields:
@@ -229,7 +226,6 @@ class ApprovalTools(ToolBase):
             human_review=True,
         )
 
-    @tool_cn_name("任务拒绝")
     def task_reject(self, *, profile: str, app_key: str, record_id: int, payload: dict[str, Any], fields: dict[str, Any] | None = None) -> dict[str, Any]:
         """执行任务相关逻辑。"""
         if fields:
@@ -251,7 +247,6 @@ class ApprovalTools(ToolBase):
             human_review=True,
         )
 
-    @tool_cn_name("任务退回候选")
     def task_rollback_candidates(self, *, profile: str, app_key: str, record_id: int, workflow_node_id: int) -> dict[str, Any]:
         """执行任务相关逻辑。"""
         selection = {"app_key": app_key, "record_id": record_id, "workflow_node_id": workflow_node_id}
@@ -274,7 +269,6 @@ class ApprovalTools(ToolBase):
             selection=selection,
         )
 
-    @tool_cn_name("任务退回")
     def task_rollback(self, *, profile: str, app_key: str, record_id: int, payload: dict[str, Any], fields: dict[str, Any] | None = None) -> dict[str, Any]:
         """执行任务相关逻辑。"""
         if fields:
@@ -296,7 +290,6 @@ class ApprovalTools(ToolBase):
             human_review=True,
         )
 
-    @tool_cn_name("任务转交")
     def task_transfer(self, *, profile: str, app_key: str, record_id: int, payload: dict[str, Any], fields: dict[str, Any] | None = None) -> dict[str, Any]:
         """执行任务相关逻辑。"""
         if fields:
@@ -319,7 +312,6 @@ class ApprovalTools(ToolBase):
             human_review=True,
         )
 
-    @tool_cn_name("任务仅保存")
     def task_save_only(
         self,
         *,
@@ -341,7 +333,6 @@ class ApprovalTools(ToolBase):
             workflow_node_id=workflow_node_id,
         )
 
-    @tool_cn_name("任务转交候选")
     def task_transfer_candidates(
         self,
         *,
@@ -390,7 +381,6 @@ class ApprovalTools(ToolBase):
             selection=selection,
         )
 
-    @tool_cn_name("新增评论")
     def record_comment_add(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -407,9 +397,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='新增评论')
 
-    @tool_cn_name("评论列表")
     def record_comment_list(self, *, profile: str, app_key: str, apply_id: int, page_size: int = 20, list_type: int | None = None, page_num: int | None = 1) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -432,7 +421,7 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='评论列表')
         items = _approval_page_items(raw.get("page"))
         return self._public_page_response(
             raw,
@@ -447,7 +436,6 @@ class ApprovalTools(ToolBase):
             selection={"app_key": app_key, "record_id": apply_id, "list_type": list_type},
         )
 
-    @tool_cn_name("评论提及候选")
     def record_comment_mention_candidates(
         self,
         *,
@@ -480,9 +468,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='评论提及候选')
 
-    @tool_cn_name("评论标记已读")
     def record_comment_mark_read(self, *, profile: str, app_key: str, apply_id: int) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -498,7 +485,7 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        raw = self._run(profile, runner)
+        raw = self._run(profile, runner, tool_name='评论标记已读')
         return self._public_action_response(
             raw,
             action="record_comment_mark_read",
@@ -506,7 +493,6 @@ class ApprovalTools(ToolBase):
             selection={},
         )
 
-    @tool_cn_name("评论统计")
     def record_comment_stats(self, *, profile: str, app_key: str, apply_id: int) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -522,9 +508,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='评论统计')
 
-    @tool_cn_name("记录通过")
     def record_approve(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -544,9 +529,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录通过')
 
-    @tool_cn_name("记录拒绝")
     def record_reject(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -566,9 +550,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录拒绝')
 
-    @tool_cn_name("记录退回候选")
     def record_rollback_candidates(self, *, profile: str, app_key: str, apply_id: int, audit_node_id: int) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -591,9 +574,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录退回候选')
 
-    @tool_cn_name("记录退回")
     def record_rollback(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -611,9 +593,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录退回')
 
-    @tool_cn_name("记录转交")
     def record_transfer(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -631,9 +612,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录转交')
 
-    @tool_cn_name("记录转交候选")
     def record_transfer_candidates(
         self,
         *,
@@ -664,9 +644,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录转交候选')
 
-    @tool_cn_name("记录改派信息")
     def record_reassign_get(self, *, profile: str, app_key: str, apply_id: int) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -682,9 +661,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录改派信息')
 
-    @tool_cn_name("记录改派")
     def record_reassign(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -701,9 +679,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='记录改派')
 
-    @tool_cn_name("会签候选")
     def record_countersign_candidates(
         self,
         *,
@@ -734,9 +711,8 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='会签候选')
 
-    @tool_cn_name("会签")
     def record_countersign(self, *, profile: str, app_key: str, apply_id: int, payload: dict[str, Any]) -> dict[str, Any]:
         """执行记录相关逻辑。"""
         self._require_app_and_apply(app_key, apply_id)
@@ -754,7 +730,7 @@ class ApprovalTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='会签')
 
     def _request_route_payload(self, context) -> JSONObject:  # type: ignore[no-untyped-def]
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/auth_tools.py

@@ -17,7 +17,7 @@ from ..config import (
 )
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
 from ..session_store import SessionStore
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class AuthTools(ToolBase):
@@ -75,7 +75,6 @@ class AuthTools(ToolBase):
         def auth_logout(profile: str = DEFAULT_PROFILE, forget_persisted: bool = False) -> dict[str, Any]:
             return self.auth_logout(profile=profile, forget_persisted=forget_persisted)
 
-    @tool_cn_name("凭证登录")
     def auth_use_credential(
         self,
         *,
@@ -371,7 +370,6 @@ class AuthTools(ToolBase):
             return False
         return True
 
-    @tool_cn_name("我的身份")
     def auth_whoami(self, *, profile: str = DEFAULT_PROFILE) -> dict[str, Any]:
         """执行认证与会话相关逻辑。"""
         def build_response(
@@ -503,7 +501,6 @@ class AuthTools(ToolBase):
             if error.looks_like_invalid_token():
                 raise
 
-    @tool_cn_name("退出登录")
     def auth_logout(self, *, profile: str = DEFAULT_PROFILE, forget_persisted: bool = False) -> dict[str, Any]:
         """执行认证与会话相关逻辑。"""
         if not self.sessions.has_profile(profile):

package/src/qingflow_mcp/tools/base.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import inspect
 from contextvars import ContextVar
 from typing import Any, Callable, TypeVar
 
@@ -20,17 +19,6 @@ T = TypeVar("T")
 _RUN_DEPTH: ContextVar[int] = ContextVar("qingflow_mcp_tool_run_depth", default=0)
 
 
-def tool_cn_name(name: str) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
-    """为 tools 方法声明中文展示名（用于计费 extraInfo 记录）。"""
-    normalized = str(name).strip()
-
-    def decorator(func: Callable[..., Any]) -> Callable[..., Any]:
-        setattr(func, "__tool_cn_name__", normalized)
-        return func
-
-    return decorator
-
-
 class ToolBase:
     def __init__(self, sessions: SessionStore, backend: BackendClient) -> None:
         self.sessions = sessions
@@ -62,19 +50,26 @@ class ToolBase:
         )
         return session_profile, backend_session, context
 
-    def _run(self, profile: str, func: Callable[[SessionProfile, BackendRequestContext], T], *, require_workspace: bool = True) -> T:
+    def _run(
+        self,
+        profile: str,
+        func: Callable[[SessionProfile, BackendRequestContext], T],
+        *,
+        require_workspace: bool = True,
+        tool_name: str,
+    ) -> T:
         depth = _RUN_DEPTH.get()
         depth_token = _RUN_DEPTH.set(depth + 1)
         is_top_level_call = depth == 0
         session_profile: SessionProfile | None = None
         backend_session: BackendSession | None = None
-        tool_name = self._resolve_calling_tool_name()
+        resolved_tool_name = self._normalize_tool_name(tool_name)
         try:
             session_profile, backend_session, context = self._require_context(profile, require_workspace=require_workspace)
             if is_top_level_call:
                 self._charge_tool_call(
                     profile=profile,
-                    tool_name=tool_name,
+                    tool_name=resolved_tool_name,
                     session_profile=session_profile,
                     context=context,
                 )
@@ -106,6 +101,12 @@ class ToolBase:
             _RUN_DEPTH.reset(depth_token)
         raise AssertionError("unreachable")
 
+    def _normalize_tool_name(self, tool_name: str) -> str:
+        normalized = str(tool_name or "").strip()
+        if not normalized:
+            raise_tool_error(QingflowApiError.config_error("tool_name is required for credit usage tracking"))
+        return normalized
+
     def _handle_error(self, profile: str, error: QingflowApiError) -> None:
         if error.looks_like_invalid_token():
             cloud_context = current_cloud_context.get()
@@ -221,25 +222,6 @@ class ToolBase:
             return None
         return parsed if parsed > 0 else None
 
-    def _resolve_calling_tool_name(self) -> str:
-        frame = inspect.currentframe()
-        if frame is None:
-            return "unknown_tool"
-        caller = frame.f_back.f_back if frame.f_back is not None else None
-        try:
-            if caller is None:
-                return "unknown_tool"
-            name = caller.f_code.co_name
-            if not name:
-                return "unknown_tool"
-            method = getattr(self, name, None)
-            cn_name = getattr(method, "__tool_cn_name__", None)
-            if isinstance(cn_name, str) and cn_name.strip():
-                return cn_name.strip()
-            return name
-        finally:
-            del frame
-
     def _charge_tool_call(
         self,
         *,

package/src/qingflow_mcp/tools/code_block_tools.py

@@ -7,7 +7,6 @@ from mcp.server.fastmcp import FastMCP
 from ..config import DEFAULT_PROFILE, DEFAULT_RECORD_LIST_TYPE
 from ..errors import QingflowApiError, backend_code_int, backend_code_value_int, is_auth_like_error, message_looks_like_invalid_token, raise_tool_error
 from ..json_types import JSONObject, JSONValue
-from .base import tool_cn_name
 from .record_tools import (
     ATTACHMENT_QUE_TYPES,
     DEPARTMENT_QUE_TYPES,
@@ -156,7 +155,6 @@ class CodeBlockTools(RecordTools):
                 output_profile=output_profile,
             )
 
-    @tool_cn_name("代码块 Schema")
     def record_code_block_schema_get_public(
         self,
         *,
@@ -263,9 +261,8 @@ class CodeBlockTools(RecordTools):
                 )
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="代码块 Schema")
 
-    @tool_cn_name("运行代码块")
     def record_code_block_run(
         self,
         *,
@@ -549,7 +546,7 @@ class CodeBlockTools(RecordTools):
                 }
             return response
 
-        return self._run_record_tool(profile, runner)
+        return self._run_record_tool(profile, runner, tool_name="运行代码块")
 
     def _resolve_code_block_field_for_run(self, selector: str | int, index: FieldIndex) -> FormField:
         field_id = _coerce_count(selector)

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,