@qingflow-tech/qingflow-cli 1.1.61-beta.4 → 1.1.61-beta.6

package/src/qingflow_mcp/tools/portal_tools.py

@@ -14,8 +14,10 @@ class PortalTools(ToolBase):
     类型：门户配置工具。
     主要职责：
     1. 查询门户列表与详情；
-    2. 维护门户基础信息与配置；
-    3. 执行门户发布与删除操作。
+    2. 执行门户发布与删除操作。
+
+    创建/更新写入已下沉 ``PortalWriter``（tools/portal_writer.py），
+    公开层唯一入口是 ``builder portal apply`` / ``portal_apply``。
     """
 
     def register(self, mcp: FastMCP) -> None:
@@ -32,18 +34,6 @@ class PortalTools(ToolBase):
         def portal_get_base_info(profile: str = DEFAULT_PROFILE, dash_key: str = "") -> JSONObject:
             return self.portal_get_base_info(profile=profile, dash_key=dash_key)
 
-        @mcp.tool()
-        def portal_create(profile: str = DEFAULT_PROFILE, payload: JSONObject | None = None) -> JSONObject:
-            return self.portal_create(profile=profile, payload=payload or {})
-
-        @mcp.tool(description=self._high_risk_tool_description(operation="update", target="portal base settings"))
-        def portal_update_base_info(profile: str = DEFAULT_PROFILE, dash_key: str = "", payload: JSONObject | None = None) -> JSONObject:
-            return self.portal_update_base_info(profile=profile, dash_key=dash_key, payload=payload or {})
-
-        @mcp.tool(description=self._high_risk_tool_description(operation="update", target="portal configuration"))
-        def portal_update(profile: str = DEFAULT_PROFILE, dash_key: str = "", payload: JSONObject | None = None) -> JSONObject:
-            return self.portal_update(profile=profile, dash_key=dash_key, payload=payload or {})
-
         @mcp.tool(description=self._high_risk_tool_description(operation="delete", target="portal configuration"))
         def portal_delete(profile: str = DEFAULT_PROFILE, dash_key: str = "") -> JSONObject:
             return self.portal_delete(profile=profile, dash_key=dash_key)
@@ -70,16 +60,6 @@ class PortalTools(ToolBase):
 
         return self._run(profile, runner, tool_name='门户详情')
 
-    def portal_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
-        """执行门户相关逻辑。"""
-        body = self._require_dict(payload)
-
-        def runner(session_profile, context):
-            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, tool_name='创建门户')
-
     def portal_get_base_info(self, *, profile: str, dash_key: str) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)
@@ -119,36 +99,6 @@ class PortalTools(ToolBase):
 
         return self._run(profile, runner, tool_name='门户基础信息')
 
-    def portal_update_base_info(self, *, profile: str, dash_key: str, payload: JSONObject) -> JSONObject:
-        """执行门户相关逻辑。"""
-        self._require_dash_key(dash_key)
-        body = self._require_dict(payload)
-
-        def runner(session_profile, context):
-            result = self.backend.request("POST", context, f"/dash/{dash_key}/baseInfo", json_body=body)
-            return self._attach_human_review_notice(
-                {"profile": profile, "ws_id": session_profile.selected_ws_id, "dash_key": dash_key, "result": result},
-                operation="update",
-                target="portal base settings",
-            )
-
-        return self._run(profile, runner, tool_name='更新门户基础信息')
-
-    def portal_update(self, *, profile: str, dash_key: str, payload: JSONObject) -> JSONObject:
-        """执行门户相关逻辑。"""
-        self._require_dash_key(dash_key)
-        body = self._require_dict(payload)
-
-        def runner(session_profile, context):
-            result = self.backend.request("POST", context, f"/dash/{dash_key}", json_body=body)
-            return self._attach_human_review_notice(
-                {"profile": profile, "ws_id": session_profile.selected_ws_id, "dash_key": dash_key, "result": result},
-                operation="update",
-                target="portal configuration",
-            )
-
-        return self._run(profile, runner, tool_name='更新门户配置')
-
     def portal_delete(self, *, profile: str, dash_key: str) -> JSONObject:
         """执行门户相关逻辑。"""
         self._require_dash_key(dash_key)

package/src/qingflow_mcp/tools/portal_writer.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from typing import Any
+
+from ..errors import QingflowApiError, raise_tool_error
+from ..json_types import JSONObject, JSONValue
+from .base import ToolBase
+
+
+class PortalWriter(ToolBase):
+    """门户写手——POST /dash、POST /dash/{dashKey}、POST /dash/{dashKey}/baseInfo 的唯一落点。
+
+    仅限 builder facade 与 solution executor 内部使用;
+    不注册 MCP 工具、不进 public_surface、不暴露 CLI。
+    公开层的门户创建/更新唯一入口是 ``builder portal apply`` / ``portal_apply``。
+    """
+
+    def create_portal(self, *, profile: str, payload: JSONObject) -> JSONObject:
+        """创建门户(内部 writer;公开入口请走 builder portal apply)。"""
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", "/dash", tool_name="创建门户", json_body=body)
+
+    def update_portal(self, *, profile: str, dash_key: str, payload: JSONObject) -> JSONObject:
+        """更新门户配置(内部 writer;公开入口请走 builder portal apply)。"""
+        self._require_dash_key(dash_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/dash/{dash_key}", tool_name="更新门户配置", json_body=body)
+
+    def update_portal_base_info(self, *, profile: str, dash_key: str, payload: JSONObject) -> JSONObject:
+        """更新门户基础信息(内部 writer;公开入口请走 builder portal apply)。"""
+        self._require_dash_key(dash_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/dash/{dash_key}/baseInfo", tool_name="更新门户基础信息", json_body=body)
+
+    def _require_dash_key(self, dash_key: str) -> None:
+        if not dash_key:
+            raise_tool_error(QingflowApiError.config_error("dash_key is required"))
+
+    def _request(
+        self,
+        profile: str,
+        method: str,
+        path: str,
+        *,
+        json_body: JSONValue = None,
+        params: JSONObject | None = None,
+        tool_name: str,
+        **extra: Any,
+    ) -> JSONObject:
+        def runner(session_profile, context):
+            result = self.backend.request(method, context, path, json_body=json_body, params=params)
+            response: JSONObject = {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
+            response.update(extra)
+            return response
+
+        return self._run(profile, runner, tool_name=tool_name)
+
+
+__all__ = ["PortalWriter", "QingflowApiError", "raise_tool_error"]

package/src/qingflow_mcp/tools/solution_tools.py

@@ -39,6 +39,7 @@ from .record_tools import RecordTools
 from .role_tools import RoleTools
 from .view_tools import ViewTools
 from .view_writer import ViewWriter
+from .portal_writer import PortalWriter
 from .workspace_tools import WorkspaceTools
 
 STAGED_BUILD_MODES = {"preflight", "plan", "apply", "repair"}
@@ -1431,6 +1432,7 @@ class SolutionTools(ToolBase):
             view_writer=ViewWriter(self.sessions, self.backend),
             chart_tools=QingbiReportTools(self.sessions, self.backend),
             portal_tools=PortalTools(self.sessions, self.backend),
+            portal_writer=PortalWriter(self.sessions, self.backend),
             navigation_tools=NavigationTools(self.sessions, self.backend),
         )