@qingflow-tech/qingflow-cli 1.1.50 → 1.1.53

package/src/qingflow_mcp/tools/base.py

@@ -8,6 +8,7 @@ from ..backend_client import BackendRequestContext, BackendClient
 from ..auth_provider import CliSessionFacade
 from ..cloud_context import current_call_platform, current_cloud_context
 from ..config import (
+    DEFAULT_MEMBER_CREDIT_AVAILABILITY_PATH,
     get_credit_meter_enabled,
     get_credit_usage_base_url,
     get_credit_usage_path,
@@ -19,6 +20,16 @@ from ..session_store import BackendSession, SessionProfile, SessionStore
 
 T = TypeVar("T")
 _RUN_DEPTH: ContextVar[int] = ContextVar("qingflow_mcp_tool_run_depth", default=0)
+_MEMBER_CREDIT_DENIAL_MESSAGES = {
+    "WORKSPACE_EXHAUSTED": "当前工作区流币余额不足，请充值后再使用 MCP",
+    "MEMBER_MONTHLY_EXHAUSTED": "本月个人流币额度已用完，请联系工作区管理员调整额度",
+    "MEMBER_TOTAL_EXHAUSTED": "个人流币总额度已用完，请联系工作区管理员调整额度",
+    "MEMBER_MONTHLY_AND_TOTAL_EXHAUSTED": (
+        "本月和个人总流币额度均已用完，请联系工作区管理员调整额度"
+    ),
+    "MEMBER_QUOTA_NOT_CONFIGURED": "当前成员尚未配置流币额度，请联系工作区管理员",
+    "MEMBER_USAGE_QUERY_FAILED": "成员流币额度校验失败，请稍后重试",
+}
 
 
 class ToolBase:
@@ -332,28 +343,49 @@ class ToolBase:
         if context.ws_id is None:
             raise_tool_error(QingflowApiError(category="payment", message="credit meter requires wsId in current session context"))
 
+        credit_context = BackendRequestContext(
+            base_url=get_credit_usage_base_url() or context.base_url,
+            token=context.token,
+            ws_id=context.ws_id,
+            qf_request_id=context.qf_request_id,
+            qf_version=context.qf_version,
+            qf_version_source=context.qf_version_source,
+        )
+        self._require_member_credit_available(context=credit_context)
         self._record_credit_usage(
             tool_name=tool_name,
-            context=context,
+            context=credit_context,
         )
 
+    def _require_member_credit_available(self, *, context: BackendRequestContext) -> None:
+        availability = self.backend.request("GET", context, DEFAULT_MEMBER_CREDIT_AVAILABILITY_PATH)
+        if not isinstance(availability, dict) or not isinstance(availability.get("allowed"), bool):
+            raise_tool_error(QingflowApiError(
+                category="payment",
+                message="成员流币额度校验失败，请稍后重试",
+            ))
+        if availability["allowed"]:
+            return
+
+        deny_reason = self._normalize_text(availability.get("denyReason")) or "UNKNOWN"
+        raise_tool_error(QingflowApiError(
+            category="payment",
+            message=_MEMBER_CREDIT_DENIAL_MESSAGES.get(
+                deny_reason,
+                "当前成员无法使用流币，请联系工作区管理员",
+            ),
+            details={"deny_reason": deny_reason},
+        ))
+
     def _record_credit_usage(
         self,
         *,
         tool_name: str,
         context: BackendRequestContext,
     ) -> None:
-        usage_context = BackendRequestContext(
-            base_url=get_credit_usage_base_url() or context.base_url,
-            token=context.token,
-            ws_id=context.ws_id,
-            qf_request_id=context.qf_request_id,
-            qf_version=context.qf_version,
-            qf_version_source=context.qf_version_source,
-        )
         self.backend.request(
             "POST",
-            usage_context,
+            context,
             get_credit_usage_path(),
             json_body={
                 "skuType": "MCP",

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"
-        }
-      ]
-    }
-  ]
-}