@qingflow-tech/qingflow-cli 1.1.38 → 1.1.40

package/src/qingflow_mcp/tools/view_tools.py

@@ -6,7 +6,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, JSONValue
 from ..list_type_labels import SYSTEM_VIEW_DEFINITIONS
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class ViewTools(ToolBase):
@@ -57,7 +57,6 @@ class ViewTools(ToolBase):
         def view_get_workflow_status(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "", row_record_id: int = 0) -> JSONObject:
             return self.view_get_workflow_status(profile=profile, viewgraph_key=viewgraph_key, row_record_id=row_record_id)
 
-    @tool_cn_name("视图列表")
     def view_list(self, *, profile: str, app_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_app_key(app_key)
@@ -85,15 +84,13 @@ class ViewTools(ToolBase):
                     "verification": verification,
                 }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name="视图列表")
 
-    @tool_cn_name("视图列表（扁平）")
     def view_list_flat(self, *, profile: str, app_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_app_key(app_key)
-        return self._request(profile, "GET", f"/app/{app_key}/view/views", app_key=app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/view/views", app_key=app_key, tool_name="视图列表（扁平）")
 
-    @tool_cn_name("视图排序")
     def view_reorder(self, *, profile: str, app_key: str, payload: list[JSONObject]) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_app_key(app_key)
@@ -104,30 +101,27 @@ class ViewTools(ToolBase):
             "POST",
             f"/app/{app_key}/view/ordinal",
             app_key=app_key,
+            tool_name="视图排序",
             json_body=self._normalize_reorder_payload(payload),
         )
 
-    @tool_cn_name("设置视图列宽")
     def view_set_column_width(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/view/que/width", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/view/que/width", app_key=app_key, tool_name="设置视图列宽", json_body=body)
 
-    @tool_cn_name("创建视图")
     def view_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         body = self._require_dict(payload)
         app_key = str(body.get("appKey") or "")
-        return self._request(profile, "POST", "/view/viewConfig", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", "/view/viewConfig", app_key=app_key, tool_name="创建视图", json_body=body)
 
-    @tool_cn_name("视图配置")
     def view_get_config(self, *, profile: str, viewgraph_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
-        return self._request(profile, "GET", f"/view/{viewgraph_key}/viewConfig", viewgraph_key=viewgraph_key)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/viewConfig", viewgraph_key=viewgraph_key, tool_name="视图配置")
 
-    @tool_cn_name("视图基础信息")
     def view_get_base_info(self, *, profile: str, viewgraph_key: str, passcode: str | None) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -165,9 +159,8 @@ class ViewTools(ToolBase):
                 "verification": verification,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name="视图基础信息")
 
-    @tool_cn_name("更新视图配置")
     def view_update(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -177,12 +170,12 @@ class ViewTools(ToolBase):
             "POST",
             f"/view/{viewgraph_key}/viewConfig",
             viewgraph_key=viewgraph_key,
+            tool_name="更新视图配置",
             json_body=body,
             risk_operation="update",
             risk_target="view configuration",
         )
 
-    @tool_cn_name("删除视图")
     def view_delete(self, *, profile: str, viewgraph_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -191,29 +184,26 @@ class ViewTools(ToolBase):
             "DELETE",
             f"/view/{viewgraph_key}",
             viewgraph_key=viewgraph_key,
+            tool_name="删除视图",
             risk_operation="delete",
             risk_target="view configuration",
         )
 
-    @tool_cn_name("复制视图")
     def view_copy(self, *, profile: str, viewgraph_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
-        return self._request(profile, "POST", f"/view/{viewgraph_key}/copy", viewgraph_key=viewgraph_key)
+        return self._request(profile, "POST", f"/view/{viewgraph_key}/copy", viewgraph_key=viewgraph_key, tool_name="复制视图")
 
-    @tool_cn_name("视图字段列表")
     def view_list_questions(self, *, profile: str, viewgraph_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
-        return self._request(profile, "GET", f"/view/{viewgraph_key}/question", viewgraph_key=viewgraph_key)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/question", viewgraph_key=viewgraph_key, tool_name="视图字段列表")
 
-    @tool_cn_name("视图关联列表")
     def view_list_associations(self, *, profile: str, viewgraph_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
-        return self._request(profile, "GET", f"/view/{viewgraph_key}/association", viewgraph_key=viewgraph_key)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/association", viewgraph_key=viewgraph_key, tool_name="视图关联列表")
 
-    @tool_cn_name("更新视图成员配置")
     def view_update_member_config(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -223,12 +213,12 @@ class ViewTools(ToolBase):
             "POST",
             f"/view/{viewgraph_key}/member/config",
             viewgraph_key=viewgraph_key,
+            tool_name="更新视图成员配置",
             json_body=body,
             risk_operation="update",
             risk_target="view member visibility",
         )
 
-    @tool_cn_name("更新视图数据配置")
     def view_update_apply_config(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -238,12 +228,12 @@ class ViewTools(ToolBase):
             "POST",
             f"/view/{viewgraph_key}/apply/config",
             viewgraph_key=viewgraph_key,
+            tool_name="更新视图数据配置",
             json_body=body,
             risk_operation="update",
             risk_target="view apply visibility",
         )
 
-    @tool_cn_name("看板泳道配置")
     def view_board_set_lane_config(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -253,12 +243,12 @@ class ViewTools(ToolBase):
             "POST",
             f"/view/{viewgraph_key}/lane/config",
             viewgraph_key=viewgraph_key,
+            tool_name="看板泳道配置",
             json_body=body,
             risk_operation="update",
             risk_target="board lane configuration",
         )
 
-    @tool_cn_name("看板泳道基础信息")
     def view_board_get_lane_base_info(self, *, profile: str, viewgraph_key: str, page_num: int, page_size: int) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -267,10 +257,10 @@ class ViewTools(ToolBase):
             "GET",
             f"/view/{viewgraph_key}/lane/baseInfo",
             viewgraph_key=viewgraph_key,
+            tool_name="看板泳道基础信息",
             params={"pageNum": page_num, "pageSize": page_size},
         )
 
-    @tool_cn_name("甘特图自动校准")
     def view_gantt_switch_auto_calibration(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -280,12 +270,12 @@ class ViewTools(ToolBase):
             "PUT",
             f"/view/gantt/{viewgraph_key}/auto/calibration",
             viewgraph_key=viewgraph_key,
+            tool_name="甘特图自动校准",
             json_body=body,
             risk_operation="update",
             risk_target="gantt auto calibration settings",
         )
 
-    @tool_cn_name("甘特图批量更新时间")
     def view_gantt_batch_update_time(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -295,12 +285,12 @@ class ViewTools(ToolBase):
             "PUT",
             f"/view/gantt/{viewgraph_key}/batch/update",
             viewgraph_key=viewgraph_key,
+            tool_name="甘特图批量更新时间",
             json_body=body,
             risk_operation="update",
             risk_target="gantt task timing",
         )
 
-    @tool_cn_name("视图后续节点")
     def view_get_future_nodes(self, *, profile: str, viewgraph_key: str, apply_id: int, app_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
@@ -313,15 +303,15 @@ class ViewTools(ToolBase):
             viewgraph_key=viewgraph_key,
             app_key=app_key,
             apply_id=apply_id,
+            tool_name="视图后续节点",
             params={"appKey": app_key},
         )
 
-    @tool_cn_name("视图流程状态")
     def view_get_workflow_status(self, *, profile: str, viewgraph_key: str, row_record_id: int) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)
         self._require_positive("row_record_id", row_record_id)
-        return self._request(profile, "GET", f"/view/{viewgraph_key}/workflow/status/{row_record_id}", viewgraph_key=viewgraph_key, row_record_id=row_record_id)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/workflow/status/{row_record_id}", viewgraph_key=viewgraph_key, row_record_id=row_record_id, tool_name="视图流程状态")
 
     def _request(
         self,
@@ -333,6 +323,7 @@ class ViewTools(ToolBase):
         params: JSONObject | None = None,
         risk_operation: str | None = None,
         risk_target: str | None = None,
+        tool_name: str,
         **extra: JSONValue,
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
@@ -344,7 +335,7 @@ class ViewTools(ToolBase):
                 return self._attach_human_review_notice(response, operation=risk_operation, target=risk_target)
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name=tool_name)
 
     def _require_app_key(self, app_key: str) -> None:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/workflow_tools.py

@@ -6,7 +6,7 @@ from ..backend_client import BackendRequestContext
 from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, raise_tool_error
 from ..json_types import JSONObject, JSONValue
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class WorkflowTools(ToolBase):
@@ -41,20 +41,17 @@ class WorkflowTools(ToolBase):
                 audit_node_id=audit_node_id,
             )
 
-    @tool_cn_name("流程节点列表")
     def workflow_list_nodes(self, *, profile: str, app_key: str) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
-        return self._request(profile, "GET", f"/app/{app_key}/auditNodes", app_key=app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNodes", app_key=app_key, tool_name="流程节点列表")
 
-    @tool_cn_name("流程节点详情")
     def workflow_get_node_detail(self, *, profile: str, app_key: str, audit_node_id: int) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         self._require_positive("audit_node_id", audit_node_id)
-        return self._request(profile, "GET", f"/app/{app_key}/auditNodes/{audit_node_id}", app_key=app_key, audit_node_id=audit_node_id)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNodes/{audit_node_id}", app_key=app_key, audit_node_id=audit_node_id, tool_name="流程节点详情")
 
-    @tool_cn_name("新增流程节点")
     def workflow_add_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
@@ -65,9 +62,9 @@ class WorkflowTools(ToolBase):
             path=f"/app/{app_key}/auditNodes",
             json_body=body,
             alternate_paths=[f"/app/{app_key}/auditNode"],
+            tool_name="新增流程节点",
         )
 
-    @tool_cn_name("更新流程节点")
     def workflow_update_node(self, *, profile: str, app_key: str, audit_node_id: int, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
@@ -82,50 +79,44 @@ class WorkflowTools(ToolBase):
             risk_operation="update",
             risk_target="workflow node configuration",
             audit_node_id=audit_node_id,
+            tool_name="更新流程节点",
         )
 
-    @tool_cn_name("删除流程节点")
     def workflow_delete_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow node configuration")
+        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow node configuration", tool_name="删除流程节点")
 
-    @tool_cn_name("复制粘贴流程节点")
     def workflow_copy_paste_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/copyAndPaste", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/copyAndPaste", app_key=app_key, json_body=body, tool_name="复制粘贴流程节点")
 
-    @tool_cn_name("剪切粘贴流程节点")
     def workflow_cut_paste_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/cutAndPaste", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/cutAndPaste", app_key=app_key, json_body=body, tool_name="剪切粘贴流程节点")
 
-    @tool_cn_name("创建流程分支")
     def workflow_create_sub_branch(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/subBranch", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/subBranch", app_key=app_key, json_body=body, tool_name="创建流程分支")
 
-    @tool_cn_name("删除流程分支")
     def workflow_delete_sub_branch(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode/subBranch", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow branch configuration")
+        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode/subBranch", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow branch configuration", tool_name="删除流程分支")
 
-    @tool_cn_name("流程全局设置")
     def workflow_get_global_settings(self, *, profile: str, app_key: str) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
-        return self._request(profile, "GET", f"/app/{app_key}/workflow/global/setting", app_key=app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/workflow/global/setting", app_key=app_key, tool_name="流程全局设置")
 
-    @tool_cn_name("更新流程全局设置")
     def workflow_update_global_settings(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
@@ -138,9 +129,9 @@ class WorkflowTools(ToolBase):
             alternate_paths=[],
             risk_operation="update",
             risk_target="workflow global settings",
+            tool_name="更新流程全局设置",
         )
 
-    @tool_cn_name("发布流程")
     def workflow_publish(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
@@ -151,16 +142,15 @@ class WorkflowTools(ToolBase):
             path=f"/app/{app_key}/publish",
             json_body=body,
             alternate_paths=[],
+            tool_name="发布流程",
         )
 
-    @tool_cn_name("流程后续节点")
     def workflow_get_future_nodes(self, *, profile: str, app_key: str, apply_id: int) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         self._require_positive("apply_id", apply_id)
-        return self._request(profile, "GET", f"/app/{app_key}/auditNode/futureList/{apply_id}", app_key=app_key, apply_id=apply_id)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/futureList/{apply_id}", app_key=app_key, apply_id=apply_id, tool_name="流程后续节点")
 
-    @tool_cn_name("流程后续节点（应用）")
     def workflow_get_future_nodes_app(
         self,
         *,
@@ -184,72 +174,63 @@ class WorkflowTools(ToolBase):
             app_key=app_key,
             apply_id=apply_id,
             params=params,
+            tool_name="流程后续节点（应用）",
         )
 
-    @tool_cn_name("流程 Webhook 测试")
     def workflow_webhook_test(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/webhookTest", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/webhookTest", app_key=app_key, json_body=body, tool_name="流程 Webhook 测试")
 
-    @tool_cn_name("流程 QSource 查询")
     def workflow_qsource_query(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/qSourceQuery", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/qSourceQuery", app_key=app_key, json_body=body, tool_name="流程 QSource 查询")
 
-    @tool_cn_name("流程 QSource 测试")
     def workflow_qsource_test(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/qSourceQueryTest", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/qSourceQueryTest", app_key=app_key, json_body=body, tool_name="流程 QSource 测试")
 
-    @tool_cn_name("流程主动 QSource 配置")
     def workflow_get_qsource_active(self, *, profile: str, app_key: str, qsource_id: int) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         self._require_positive("qsource_id", qsource_id)
-        return self._request(profile, "GET", f"/app/{app_key}/auditNode/active/qsource", app_key=app_key, params={"qSourceId": qsource_id})
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/active/qsource", app_key=app_key, params={"qSourceId": qsource_id}, tool_name="流程主动 QSource 配置")
 
-    @tool_cn_name("更新主动 QSource 配置")
     def workflow_upsert_qsource_active(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/active/qsource", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/active/qsource", app_key=app_key, json_body=body, tool_name="更新主动 QSource 配置")
 
-    @tool_cn_name("流程被动 QSource 配置")
     def workflow_get_qsource_passive(self, *, profile: str, app_key: str, qsource_id: int) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         self._require_positive("qsource_id", qsource_id)
-        return self._request(profile, "GET", f"/app/{app_key}/auditNode/passive/qsource", app_key=app_key, params={"qSourceId": qsource_id})
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/passive/qsource", app_key=app_key, params={"qSourceId": qsource_id}, tool_name="流程被动 QSource 配置")
 
-    @tool_cn_name("更新被动 QSource 配置")
     def workflow_upsert_qsource_passive(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/passive/qsource", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/passive/qsource", app_key=app_key, json_body=body, tool_name="更新被动 QSource 配置")
 
-    @tool_cn_name("切换 QSource 状态")
     def workflow_switch_qsource_status(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "POST", f"/app/{app_key}/auditNode/source/status", app_key=app_key, json_body=body)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/source/status", app_key=app_key, json_body=body, tool_name="切换 QSource 状态")
 
-    @tool_cn_name("删除 QSource 配置")
     def workflow_delete_qsource(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
-        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode/qsource", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow qsource configuration")
+        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode/qsource", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow qsource configuration", tool_name="删除 QSource 配置")
 
-    @tool_cn_name("节点可编辑字段")
     def workflow_get_editable_question_ids(self, *, profile: str, app_key: str, audit_node_id: int) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
@@ -260,13 +241,13 @@ class WorkflowTools(ToolBase):
             f"/app/{app_key}/auditNode/{audit_node_id}/editableQueIds",
             app_key=app_key,
             audit_node_id=audit_node_id,
+            tool_name="节点可编辑字段",
         )
 
-    @tool_cn_name("流程打印节点")
     def workflow_get_print_nodes(self, *, profile: str, app_key: str) -> JSONObject:
         """执行流程相关逻辑。"""
         self._require_app_key(app_key)
-        return self._request(profile, "GET", f"/app/{app_key}/auditNode/printNodes", app_key=app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/printNodes", app_key=app_key, tool_name="流程打印节点")
 
     def _request(
         self,
@@ -279,6 +260,7 @@ class WorkflowTools(ToolBase):
         params: JSONObject | None = None,
         risk_operation: str | None = None,
         risk_target: str | None = None,
+        tool_name: str,
         **extra: JSONValue,
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
@@ -290,7 +272,7 @@ class WorkflowTools(ToolBase):
                 return self._attach_human_review_notice(response, operation=risk_operation, target=risk_target)
             return response
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name=tool_name)
 
     def _request_with_post_fallbacks(
         self,
@@ -302,6 +284,7 @@ class WorkflowTools(ToolBase):
         alternate_paths: list[str],
         risk_operation: str | None = None,
         risk_target: str | None = None,
+        tool_name: str,
         **extra: JSONValue,
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
@@ -351,7 +334,7 @@ class WorkflowTools(ToolBase):
             assert last_error is not None
             raise last_error
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name=tool_name)
 
     def _require_app_key(self, app_key: str) -> None:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/workspace_tools.py

@@ -8,7 +8,7 @@ from ..backend_client import BackendRequestContext
 from ..cloud_context import current_cloud_context
 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
 
 
 _WORKSPACE_DETAIL_WARNING_KEY = "_qingflow_workspace_detail_warning"
@@ -71,7 +71,6 @@ class WorkspaceTools(ToolBase):
                 being_installed=being_installed,
             )
 
-    @tool_cn_name("工作区列表")
     def workspace_list(
         self,
         *,
@@ -127,9 +126,8 @@ class WorkspaceTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner, require_workspace=False)
+        return self._run(profile, runner, require_workspace=False, tool_name='工作区列表')
 
-    @tool_cn_name("工作区详情")
     def workspace_get(
         self,
         *,
@@ -158,9 +156,8 @@ class WorkspaceTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner, require_workspace=False)
+        return self._run(profile, runner, require_workspace=False, tool_name='工作区详情')
 
-    @tool_cn_name("切换工作区")
     def workspace_select(
         self,
         *,
@@ -227,9 +224,8 @@ class WorkspaceTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner, require_workspace=False)
+        return self._run(profile, runner, require_workspace=False, tool_name='切换工作区')
 
-    @tool_cn_name("设置工作区插件状态")
     def workspace_set_plugin_status(
         self,
         *,
@@ -258,7 +254,7 @@ class WorkspaceTools(ToolBase):
                 "result": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='设置工作区插件状态')
 
     def _fetch_workspace_with_fallback(
         self,