@qingflow-tech/qingflow-cli 1.1.38 → 1.1.40

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:
         """执行内部辅助逻辑。"""

package/src/qingflow_mcp/tools/portal_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 PortalTools(ToolBase):
@@ -52,16 +52,14 @@ class PortalTools(ToolBase):
         def portal_publish(profile: str = DEFAULT_PROFILE, dash_key: str = "") -> JSONObject:
             return self.portal_publish(profile=profile, dash_key=dash_key)
 
-    @tool_cn_name("门户列表")
     def portal_list(self, *, profile: str) -> JSONObject:
         """执行门户相关逻辑。"""
         def runner(session_profile, context):
             result = self.backend.request("GET", context, "/dash")
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "items": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='门户列表')
 
-    @tool_cn_name("门户详情")
     def portal_get(self, *, profile: str, dash_key: str, being_draft: bool = False) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -70,9 +68,8 @@ class PortalTools(ToolBase):
             result = self.backend.request("GET", context, f"/dash/{dash_key}", params={"beingDraft": being_draft})
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "dash_key": dash_key, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='门户详情')
 
-    @tool_cn_name("创建门户")
     def portal_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
         """执行门户相关逻辑。"""
         body = self._require_dict(payload)
@@ -81,9 +78,8 @@ class PortalTools(ToolBase):
             result = self.backend.request("POST", context, "/dash", 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 portal_get_base_info(self, *, profile: str, dash_key: str) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -121,9 +117,8 @@ class PortalTools(ToolBase):
                 "verification": verification,
             }
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='门户基础信息')
 
-    @tool_cn_name("更新门户基础信息")
     def portal_update_base_info(self, *, profile: str, dash_key: str, payload: JSONObject) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -137,9 +132,8 @@ class PortalTools(ToolBase):
                 target="portal base settings",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新门户基础信息')
 
-    @tool_cn_name("更新门户配置")
     def portal_update(self, *, profile: str, dash_key: str, payload: JSONObject) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -153,9 +147,8 @@ class PortalTools(ToolBase):
                 target="portal configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='更新门户配置')
 
-    @tool_cn_name("删除门户")
     def portal_delete(self, *, profile: str, dash_key: str) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -168,9 +161,8 @@ class PortalTools(ToolBase):
                 target="portal configuration",
             )
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='删除门户')
 
-    @tool_cn_name("发布门户")
     def portal_publish(self, *, profile: str, dash_key: str) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -179,7 +171,7 @@ class PortalTools(ToolBase):
             result = self.backend.request("POST", context, f"/dash/{dash_key}/publish")
             return {"profile": profile, "ws_id": session_profile.selected_ws_id, "dash_key": dash_key, "result": result}
 
-        return self._run(profile, runner)
+        return self._run(profile, runner, tool_name='发布门户')
 
     def _require_dash_key(self, dash_key: str) -> None:
         """执行内部辅助逻辑。"""