@qingflow-tech/qingflow-cli 1.1.39 → 1.1.41

package/src/qingflow_mcp/tools/repository_dev_tools.py

@@ -19,7 +19,7 @@ from ..errors import QingflowApiError, raise_tool_error
 from ..json_types import JSONObject, JSONValue
 from ..repository_store import RepositoryMetadataStore
 from ..session_store import SessionProfile
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 _STREAM_EVENT_RE = re.compile(r"^type=(?P<type>[^,]+),timestamp=(?P<timestamp>[^,]+),data=(?P<data>.*)$")
@@ -41,7 +41,6 @@ class RepositoryDevTools(ToolBase):
         super().__init__(sessions, backend)
         self._metadata = metadata_store or RepositoryMetadataStore()
 
-    @tool_cn_name("仓库初始化")
     def repository_init(self, *, profile: str, group_name: str, repo_template: str) -> JSONObject:
         """执行工具方法逻辑。"""
         normalized_group = str(group_name or "").strip()
@@ -79,9 +78,8 @@ class RepositoryDevTools(ToolBase):
                 "warnings": self._custom_page_route_warning(),
             }
 
-        return self._run(profile, runner, require_workspace=True)
+        return self._run(profile, runner, require_workspace=True, tool_name='仓库初始化')
 
-    @tool_cn_name("仓库生成")
     def repository_generate(
         self,
         *,
@@ -174,9 +172,8 @@ class RepositoryDevTools(ToolBase):
             )
             return summarized
 
-        return self._run(profile, runner, require_workspace=True)
+        return self._run(profile, runner, require_workspace=True, tool_name='仓库生成')
 
-    @tool_cn_name("仓库发布生产")
     def repository_publish_prod(
         self,
         *,
@@ -213,7 +210,7 @@ class RepositoryDevTools(ToolBase):
                 "warnings": self._custom_page_route_warning(),
             }
 
-        return self._run(profile, runner, require_workspace=True)
+        return self._run(profile, runner, require_workspace=True, tool_name='仓库发布生产')
 
     def _custom_page_route_warning(self) -> list[JSONObject]:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/resource_read_tools.py

@@ -8,7 +8,7 @@ from ..json_types import JSONObject
 from ..list_type_labels import SYSTEM_VIEW_DEFINITIONS
 from ..solution.compiler.icon_utils import workspace_icon_config
 from .app_tools import _analysis_supported_for_view_type
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 from .qingbi_report_tools import QingbiReportTools, _coerce_tool_error
 
 
@@ -27,7 +27,6 @@ class ResourceReadTools(ToolBase):
         super().__init__(sessions, backend)
         self.charts = QingbiReportTools(sessions, backend)
 
-    @tool_cn_name("资源读取-门户列表")
     def portal_list(self, *, profile: str) -> JSONObject:
         """执行门户相关逻辑。"""
         def runner(session_profile, context):
@@ -45,9 +44,8 @@ class ResourceReadTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='资源读取-门户列表')
 
-    @tool_cn_name("资源读取-门户详情")
     def portal_get(self, *, profile: str, dash_key: str) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -83,9 +81,8 @@ class ResourceReadTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='资源读取-门户详情')
 
-    @tool_cn_name("资源读取-视图详情")
     def view_get(self, *, profile: str, view_id: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_view_id(view_id)
@@ -134,6 +131,7 @@ class ResourceReadTools(ToolBase):
                         "export_capability": export_capability,
                     },
                 },
+            tool_name='资源读取-视图详情',
             )
 
         def runner(session_profile, context):
@@ -254,9 +252,8 @@ class ResourceReadTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='资源读取-视图详情')
 
-    @tool_cn_name("资源读取-报表详情")
     def chart_get(self, *, profile: str, chart_id: str) -> JSONObject:
         """执行图表相关逻辑。"""
         self._require_chart_id(chart_id)
@@ -365,7 +362,7 @@ class ResourceReadTools(ToolBase):
                 "data": data_payload,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='资源读取-报表详情')
 
     def _require_dash_key(self, dash_key: str) -> None:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/role_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 ..json_types import JSONObject
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 
 class RoleTools(ToolBase):
@@ -47,7 +47,6 @@ class RoleTools(ToolBase):
         def role_delete(profile: str = DEFAULT_PROFILE, role_ids: list[int] | None = None) -> JSONObject:
             return self.role_delete(profile=profile, role_ids=role_ids or [])
 
-    @tool_cn_name("角色搜索")
     def role_search(self, *, profile: str, keyword: str, page_num: int, page_size: int) -> JSONObject:
         """执行角色相关逻辑。"""
         if page_num <= 0 or page_size <= 0:
@@ -85,9 +84,8 @@ class RoleTools(ToolBase):
                 "page": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='角色搜索')
 
-    @tool_cn_name("创建角色")
     def role_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
         """执行角色相关逻辑。"""
         body = self._require_dict(payload)
@@ -96,9 +94,8 @@ class RoleTools(ToolBase):
             result = self.backend.request("POST", context, "/contact/role", 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 role_update(self, *, profile: str, role_id: int, payload: JSONObject) -> JSONObject:
         """执行角色相关逻辑。"""
         if role_id <= 0:
@@ -113,9 +110,8 @@ class RoleTools(ToolBase):
                 target="role configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新角色')
 
-    @tool_cn_name("删除角色")
     def role_delete(self, *, profile: str, role_ids: list[int]) -> JSONObject:
         """执行角色相关逻辑。"""
         if not role_ids or any(role_id <= 0 for role_id in role_ids):
@@ -129,7 +125,7 @@ class RoleTools(ToolBase):
                 target="roles and assignments",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='删除角色')
 
 
 def _is_role_permission_denied(error: QingflowApiError) -> bool:

package/src/qingflow_mcp/tools/solution_tools.py

@@ -30,7 +30,7 @@ from ..solution.spec_models import (
     ViewsBuildSpec,
 )
 from .app_tools import AppTools
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 from .navigation_tools import NavigationTools
 from .package_tools import PackageTools
 from .portal_tools import PortalTools
@@ -356,7 +356,6 @@ class SolutionTools(ToolBase):
         def solution_build_status(build_id: str = "") -> dict[str, Any]:
             return self.solution_build_status(build_id=build_id)
 
-    @tool_cn_name("方案设计会话")
     def solution_design_session(
         self,
         *,
@@ -427,7 +426,6 @@ class SolutionTools(ToolBase):
         except Exception as exc:  # noqa: BLE001
             return self._design_failure_response(session_id, action, "runtime", str(exc))
 
-    @tool_cn_name("方案启动搭建")
     def solution_bootstrap(
         self,
         *,
@@ -526,9 +524,8 @@ class SolutionTools(ToolBase):
 
         if mode in {"preflight", "plan"}:
             return runner()
-        return self._run(profile, lambda _session_profile, _context: runner())
+        return self._run(profile, lambda _session_profile, _context: runner(), tool_name='方案启动搭建')
 
-    @tool_cn_name("搭建应用流程")
     def solution_build_app_flow(
         self,
         *,
@@ -556,7 +553,6 @@ class SolutionTools(ToolBase):
             repair_patch=repair_patch,
         )
 
-    @tool_cn_name("搭建应用")
     def solution_build_app(
         self,
         *,
@@ -599,7 +595,6 @@ class SolutionTools(ToolBase):
             projection_name="app",
         )
 
-    @tool_cn_name("从需求搭建应用")
     def solution_build_app_from_requirements(
         self,
         *,
@@ -722,7 +717,6 @@ class SolutionTools(ToolBase):
             include_generated_spec=include_generated_spec,
         )
 
-    @tool_cn_name("搭建流程")
     def solution_build_flow(
         self,
         *,
@@ -782,7 +776,6 @@ class SolutionTools(ToolBase):
             projection_name="flow",
         )
 
-    @tool_cn_name("一键搭建全部")
     def solution_build_all(
         self,
         *,
@@ -969,9 +962,8 @@ class SolutionTools(ToolBase):
 
         if mode in {"preflight", "plan"}:
             return runner()
-        return self._run(profile, lambda _session_profile, _context: runner())
+        return self._run(profile, lambda _session_profile, _context: runner(), tool_name='一键搭建全部')
 
-    @tool_cn_name("搭建视图")
     def solution_build_views(
         self,
         *,
@@ -998,7 +990,6 @@ class SolutionTools(ToolBase):
             repair_patch=repair_patch,
         )
 
-    @tool_cn_name("方案 Schema 示例")
     def solution_schema_example(
         self,
         *,
@@ -1048,7 +1039,6 @@ class SolutionTools(ToolBase):
         response["resolved_intent"] = resolved_intent
         return response
 
-    @tool_cn_name("搭建分析门户")
     def solution_build_analytics_portal(
         self,
         *,
@@ -1075,7 +1065,6 @@ class SolutionTools(ToolBase):
             repair_patch=repair_patch,
         )
 
-    @tool_cn_name("搭建导航")
     def solution_build_navigation(
         self,
         *,
@@ -1102,7 +1091,6 @@ class SolutionTools(ToolBase):
             repair_patch=repair_patch,
         )
 
-    @tool_cn_name("搭建状态")
     def solution_build_status(self, *, build_id: str) -> dict[str, Any]:
         """执行方案相关逻辑。"""
         if not build_id:
@@ -1177,7 +1165,7 @@ class SolutionTools(ToolBase):
 
         if mode in {"preflight", "plan"}:
             return runner()
-        return self._run(profile, lambda _session_profile, _context: runner())
+        return self._run(profile, lambda _session_profile, _context: runner(), tool_name=tool_name)
 
     def _execute_stage_build(
         self,

package/src/qingflow_mcp/tools/task_context_tools.py

@@ -13,7 +13,7 @@ from ..errors import QingflowApiError, backend_code_int, backend_code_value_int,
 from ..id_utils import ids_equal, normalize_positive_id_int, normalize_positive_id_text, stringify_backend_id
 from ..json_types import JSONObject
 from .approval_tools import ApprovalTools, _approval_page_amount, _approval_page_items, _approval_page_total
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 from .qingbi_report_tools import _qingbi_base_url, _should_retry_asos_data
 from .record_tools import (
     FieldIndex,
@@ -174,7 +174,6 @@ class TaskContextTools(ToolBase):
                 workflow_node_id=0,
             )
 
-    @tool_cn_name("任务上下文列表")
     def task_list(
         self,
         *,
@@ -252,7 +251,6 @@ class TaskContextTools(ToolBase):
             },
         }
 
-    @tool_cn_name("任务上下文详情")
     def task_get(
         self,
         *,
@@ -308,9 +306,8 @@ class TaskContextTools(ToolBase):
                 "data": data,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务上下文详情')
 
-    @tool_cn_name("任务仅保存")
     def task_save_only(
         self,
         *,
@@ -330,7 +327,6 @@ class TaskContextTools(ToolBase):
             fields=field_updates,
         )
 
-    @tool_cn_name("执行任务动作")
     def task_action_execute(
         self,
         *,
@@ -633,7 +629,7 @@ class TaskContextTools(ToolBase):
                     resource["task_id"] = task_id_text
             return result
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name="执行任务动作")
 
     def _execute_task_action(
         self,
@@ -1447,7 +1443,6 @@ class TaskContextTools(ToolBase):
                 return True
         return False
 
-    @tool_cn_name("任务关联报表详情")
     def task_associated_report_detail_get(
         self,
         *,
@@ -1681,9 +1676,8 @@ class TaskContextTools(ToolBase):
                 },
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务关联报表详情')
 
-    @tool_cn_name("任务流程日志")
     def task_workflow_log_get(
         self,
         *,
@@ -1775,7 +1769,7 @@ class TaskContextTools(ToolBase):
                     selection["task_id"] = task_id_text
             return result
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务流程日志')
 
     def _build_task_context(
         self,
@@ -3023,7 +3017,7 @@ class TaskContextTools(ToolBase):
                 "request_route": self._request_route_payload(context),
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name="任务仅保存")
 
     def _build_visibility(self, node_info: dict[str, Any], detail: dict[str, Any]) -> dict[str, bool]:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/task_tools.py

@@ -8,7 +8,7 @@ from mcp.server.fastmcp import FastMCP
 from ..config import DEFAULT_PROFILE
 from ..errors import QingflowApiError, backend_code_value_int, message_looks_like_invalid_token, raise_tool_error
 from ..list_type_labels import get_record_list_type_label, get_task_type_label
-from .base import ToolBase, tool_cn_name
+from .base import ToolBase
 
 TASK_BOX_TO_TYPE = {
     "todo": 1,
@@ -143,7 +143,6 @@ class TaskTools(ToolBase):
         ) -> dict[str, Any]:
             return self.task_urge_public(profile=profile, app_key=app_key, record_id=record_id)
 
-    @tool_cn_name("任务摘要")
     def task_summary(
         self,
         *,
@@ -176,7 +175,6 @@ class TaskTools(ToolBase):
             },
         }
 
-    @tool_cn_name("任务列表")
     def task_list_public(
         self,
         *,
@@ -234,7 +232,6 @@ class TaskTools(ToolBase):
             },
         }
 
-    @tool_cn_name("任务分面统计")
     def task_facets(
         self,
         *,
@@ -325,7 +322,6 @@ class TaskTools(ToolBase):
             },
         }
 
-    @tool_cn_name("任务标记已读")
     def task_mark_read_public(
         self,
         *,
@@ -343,7 +339,6 @@ class TaskTools(ToolBase):
             selection={"task_box": task_box},
         )
 
-    @tool_cn_name("抄送全部已读")
     def task_mark_all_cc_read_public(
         self,
         *,
@@ -359,7 +354,6 @@ class TaskTools(ToolBase):
             selection={"task_box": "cc", "flow_status": flow_status},
         )
 
-    @tool_cn_name("任务催办")
     def task_urge_public(
         self,
         *,
@@ -376,7 +370,6 @@ class TaskTools(ToolBase):
             selection={},
         )
 
-    @tool_cn_name("任务列表（兼容）")
     def task_list(
         self,
         *,
@@ -421,9 +414,8 @@ class TaskTools(ToolBase):
                 "page": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务列表（兼容）')
 
-    @tool_cn_name("任务分组列表")
     def task_list_grouped(
         self,
         *,
@@ -466,9 +458,8 @@ class TaskTools(ToolBase):
                 "page": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务分组列表')
 
-    @tool_cn_name("任务统计")
     def task_statistics(
         self,
         *,
@@ -489,9 +480,8 @@ class TaskTools(ToolBase):
                 "statistics": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务统计')
 
-    @tool_cn_name("任务流程节点")
     def task_workflow_nodes(
         self,
         *,
@@ -530,9 +520,8 @@ class TaskTools(ToolBase):
                 "page": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务流程节点')
 
-    @tool_cn_name("任务节点统计")
     def task_node_statistics(
         self,
         *,
@@ -566,9 +555,8 @@ class TaskTools(ToolBase):
                 "nodes": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务节点统计')
 
-    @tool_cn_name("任务应用统计")
     def task_worksheet_statistics(
         self,
         *,
@@ -601,9 +589,8 @@ class TaskTools(ToolBase):
                 "page": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务应用统计')
 
-    @tool_cn_name("任务已读（兼容）")
     def task_mark_read(
         self,
         *,
@@ -637,9 +624,8 @@ class TaskTools(ToolBase):
                 "result": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务已读（兼容）')
 
-    @tool_cn_name("抄送已读（兼容）")
     def task_mark_all_cc_read(
         self,
         *,
@@ -668,9 +654,8 @@ class TaskTools(ToolBase):
                 "result": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='抄送已读（兼容）')
 
-    @tool_cn_name("任务催办（兼容）")
     def task_urge(
         self,
         *,
@@ -699,9 +684,8 @@ class TaskTools(ToolBase):
                 "result": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务催办（兼容）')
 
-    @tool_cn_name("任务分组详情")
     def task_group_detail(
         self,
         *,
@@ -730,9 +714,8 @@ class TaskTools(ToolBase):
                 "detail": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='任务分组详情')
 
-    @tool_cn_name("批处理任务数量")
     def task_batch_processing_amount(
         self,
         *,
@@ -768,7 +751,7 @@ class TaskTools(ToolBase):
                 "amount": result,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='批处理任务数量')
 
     def _validate_type(self, type: int) -> None:
         """执行内部辅助逻辑。"""