@qingflow-tech/qingflow-cli 1.1.61-beta.3 → 1.1.61-beta.5

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),
         )