@qingflow-tech/qingflow-cli 1.1.50-beta.2 → 1.1.50-beta.4

package/src/qingflow_mcp/tools/solution_tools.py

@@ -38,6 +38,7 @@ from .qingbi_report_tools import QingbiReportTools
 from .record_tools import RecordTools
 from .role_tools import RoleTools
 from .view_tools import ViewTools
+from .view_writer import ViewWriter
 from .workspace_tools import WorkspaceTools
 
 STAGED_BUILD_MODES = {"preflight", "plan", "apply", "repair"}
@@ -1427,6 +1428,7 @@ class SolutionTools(ToolBase):
             app_tools=AppTools(self.sessions, self.backend),
             record_tools=RecordTools(self.sessions, self.backend),
             view_tools=ViewTools(self.sessions, self.backend),
+            view_writer=ViewWriter(self.sessions, self.backend),
             chart_tools=QingbiReportTools(self.sessions, self.backend),
             portal_tools=PortalTools(self.sessions, self.backend),
             navigation_tools=NavigationTools(self.sessions, self.backend),

package/src/qingflow_mcp/tools/view_tools.py

@@ -111,12 +111,6 @@ class ViewTools(ToolBase):
         body = self._require_dict(payload)
         return self._request(profile, "POST", f"/app/{app_key}/view/que/width", app_key=app_key, tool_name="设置视图列宽", json_body=body)
 
-    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, tool_name="创建视图", json_body=body)
-
     def view_get_config(self, *, profile: str, viewgraph_key: str) -> JSONObject:
         """执行视图相关逻辑。"""
         self._require_viewgraph_key(viewgraph_key)

package/src/qingflow_mcp/tools/view_writer.py

@@ -0,0 +1,44 @@
+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 ViewWriter(ToolBase):
+    """视图创建写手——POST /view/viewConfig 的唯一落点。
+
+    仅限 builder facade 与 solution executor 内部使用;
+    不注册 MCP 工具、不进 public_surface、不暴露 CLI。
+    公开层的视图创建唯一入口是 ``builder views apply`` / ``app_views_apply``。
+    """
+
+    def create_view(self, *, profile: str, payload: JSONObject) -> JSONObject:
+        """创建视图(内部 writer;公开入口请走 app_views_apply)。"""
+        body = self._require_dict(payload)
+        app_key = str(body.get("appKey") or "")
+        return self._request(profile, "POST", "/view/viewConfig", app_key=app_key, tool_name="创建视图", json_body=body)
+
+    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__ = ["ViewWriter", "QingflowApiError", "raise_tool_error"]

package/skills/qingflow-cli/reference/examples/views/views_batch_full.example.json

@@ -1,159 +0,0 @@
-{
-  "views": [
-    {
-      "operation": "upsert",
-      "app_key": "WORK_ORDER_APP_KEY",
-      "name": "生产工单执行视图",
-      "type": "table",
-      "columns": ["工单编号", "产品", "工单状态", "负责人", "计划完成日期"],
-      "filters": [
-        {"field_name": "工单状态", "operator": "in", "values": ["待排产", "生产中"]},
-        {"field_name": "产品", "operator": "contains", "value": "标准"},
-        {"field_name": "计划完成日期", "operator": "lte", "value": "2026-07-31"}
-      ],
-      "query_conditions": {
-        "enabled": true,
-        "exact": false,
-        "hide_before_query": false,
-        "rows": [["工单编号", "工单状态"], ["负责人", "计划完成日期"]]
-      },
-      "visibility": {
-        "mode": "workspace",
-        "selectors": {},
-        "external_mode": "not",
-        "external_selectors": {}
-      },
-      "action_buttons": [
-        {
-          "client_key": "create_quality_from_list",
-          "text": "行内创建质检",
-          "action": "add_data",
-          "target_app_key": "QUALITY_APP_KEY",
-          "field_mappings": [
-            {"source_field": "数据ID", "target_field": "关联工单"}
-          ],
-          "default_values": {"处理状态": "待处理"},
-          "placement": "list",
-          "primary": true,
-          "style_preset": "primary_blue",
-          "visible_when": [
-            {"field_name": "工单状态", "operator": "eq", "value": "生产中"}
-          ]
-        },
-        {
-          "client_key": "create_quality_from_detail",
-          "text": "详情创建质检",
-          "action": "add_data",
-          "target_app_key": "QUALITY_APP_KEY",
-          "field_mappings": [
-            {"source_field": "数据ID", "target_field": "关联工单"}
-          ],
-          "default_values": {"处理状态": "待处理"},
-          "placement": "detail",
-          "style_preset": "neutral_outline"
-        },
-        {
-          "client_key": "open_work_order_sop",
-          "text": "打开SOP",
-          "action": "link",
-          "url": "https://example.com/sop/work-order",
-          "placement": "header",
-          "style_preset": "text_blue"
-        }
-      ]
-    },
-    {
-      "operation": "upsert",
-      "app_key": "WORK_ORDER_APP_KEY",
-      "name": "工单状态看板",
-      "type": "board",
-      "columns": ["工单编号", "产品", "负责人", "计划完成日期"],
-      "group_by": "工单状态",
-      "filters": [
-        {"field_name": "工单状态", "operator": "not_empty"},
-        {"field_name": "关闭日期", "operator": "is_empty"}
-      ],
-      "query_conditions": {
-        "enabled": true,
-        "rows": [["工单编号", "负责人"], ["计划完成日期"]]
-      },
-      "action_buttons": [
-        {
-          "text": "看板行内创建质检",
-          "action": "add_data",
-          "target_app_key": "QUALITY_APP_KEY",
-          "field_mappings": [
-            {"source_field": "数据ID", "target_field": "关联工单"}
-          ],
-          "placement": "list",
-          "visible_when": [
-            {"field_name": "工单状态", "operator": "eq", "value": "已完工"}
-          ]
-        },
-        {
-          "text": "看板详情创建质检",
-          "action": "add_data",
-          "target_app_key": "QUALITY_APP_KEY",
-          "field_mappings": [
-            {"source_field": "数据ID", "target_field": "关联工单"}
-          ],
-          "placement": "detail"
-        }
-      ]
-    },
-    {
-      "operation": "upsert",
-      "app_key": "WORK_ORDER_APP_KEY",
-      "name": "工单计划甘特图",
-      "type": "gantt",
-      "columns": ["工单编号", "产品", "工单状态", "计划开始日期", "计划完成日期"],
-      "start_field": "计划开始日期",
-      "end_field": "计划完成日期",
-      "title_field": "工单编号",
-      "filters": [
-        {"field_name": "计划开始日期", "operator": "gte", "value": "2026-07-01"}
-      ],
-      "query_conditions": {
-        "enabled": true,
-        "rows": [["工单编号", "工单状态"], ["计划开始日期", "计划完成日期"]]
-      },
-      "action_buttons": [
-        {
-          "text": "详情查看排产说明",
-          "action": "link",
-          "url": "https://example.com/sop/schedule",
-          "placement": "detail"
-        }
-      ]
-    },
-    {
-      "operation": "patch",
-      "app_key": "WORK_ORDER_APP_KEY",
-      "view_key": "RAW_VIEW_KEY_TO_PATCH",
-      "set": {
-        "columns": ["工单编号", "工单状态", "负责人"],
-        "filters": [
-          {"field_name": "工单状态", "operator": "neq", "value": "已关闭"}
-        ],
-        "query_conditions": {
-          "enabled": true,
-          "rows": [["工单编号", "工单状态"], ["负责人"]]
-        },
-        "action_buttons": [
-          {
-            "text": "补充详情按钮",
-            "action": "link",
-            "url": "https://example.com/detail-help",
-            "placement": "detail"
-          }
-        ],
-        "action_buttons_mode": "merge"
-      }
-    },
-    {
-      "operation": "remove",
-      "app_key": "WORK_ORDER_APP_KEY",
-      "view_key": "RAW_VIEW_KEY_TO_REMOVE"
-    }
-  ]
-}

package/skills/qingflow-cli/reference/views_upsert_table_minimal.example.json

@@ -1,42 +0,0 @@
-{
-  "views": [
-    {
-      "operation": "upsert",
-      "app_key": "APP_KEY",
-      "name": "示例业务操作视图_CLI模板",
-      "type": "table",
-      "columns": ["主记录编号", "主记录名称", "状态", "负责人"],
-      "filters": [
-        {"field_name": "状态", "operator": "neq", "value": "已关闭"}
-      ],
-      "query_conditions": {
-        "enabled": true,
-        "exact": false,
-        "hide_before_query": false,
-        "rows": [["主记录编号", "主记录名称"], ["状态", "负责人"]]
-      },
-      "action_buttons": [
-        {
-          "text": "行内创建子记录",
-          "action": "add_data",
-          "target_app_key": "TARGET_APP_KEY",
-          "field_mappings": [
-            {"source_field": "数据ID", "target_field": "关联主记录"}
-          ],
-          "default_values": {"目标状态字段": "REPLACE_WITH_TARGET_OPTION_LABEL"},
-          "placement": "list"
-        },
-        {
-          "text": "详情创建子记录",
-          "action": "add_data",
-          "target_app_key": "TARGET_APP_KEY",
-          "field_mappings": [
-            {"source_field": "数据ID", "target_field": "关联主记录"}
-          ],
-          "default_values": {"目标状态字段": "REPLACE_WITH_TARGET_OPTION_LABEL"},
-          "placement": "detail"
-        }
-      ]
-    }
-  ]
-}