@qingflow-tech/qingflow-cli 1.1.50-beta.5 → 1.1.51

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/record_tools.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import csv
 import html
 import mimetypes
 import json
@@ -33,7 +34,6 @@ from ..list_type_labels import (
 )
 from .base import ToolBase
 from .directory_tools import _directory_has_more, _directory_items
-from .csv_export import CsvShardWriter
 
 
 DEFAULT_QUERY_PAGE_SIZE = 50
@@ -2284,22 +2284,57 @@ class RecordTools(ToolBase):
                 }
 
             run_dir = _record_access_run_dir()
+            run_dir.mkdir(parents=True, exist_ok=True)
             header = ["record_id"] + [str(field["column_name"]) for field in fields_payload]
-            shard_writer = CsvShardWriter(
-                output_dir=run_dir,
-                file_prefix="records",
-                header=header,
-                shard_rows=DEFAULT_RECORD_ACCESS_SHARD_ROWS,
-            )
+            files: list[JSONObject] = []
+            shard_part = 0
+            shard_rows = 0
+            row_count = 0
+            file_handle: Any | None = None
+            writer: Any | None = None
+
+            def close_shard() -> None:
+                nonlocal file_handle, writer, shard_rows
+                if file_handle is None:
+                    return
+                path = Path(file_handle.name)
+                file_handle.close()
+                files.append(
+                    {
+                        "local_path": str(path),
+                        "row_count": shard_rows,
+                        "part": len(files) + 1,
+                    }
+                )
+                file_handle = None
+                writer = None
+                shard_rows = 0
+
+            def ensure_writer() -> Any:
+                nonlocal file_handle, writer, shard_part
+                if writer is not None:
+                    return writer
+                shard_part += 1
+                path = run_dir / f"records-{shard_part:04d}.csv"
+                file_handle = path.open("w", newline="", encoding="utf-8-sig")
+                writer = csv.writer(file_handle)
+                writer.writerow(header)
+                return writer
 
             def write_record(apply_id: int | None, answer_list: list[JSONValue]) -> None:
+                nonlocal row_count, shard_rows
                 if apply_id is None:
                     return
+                if shard_rows >= DEFAULT_RECORD_ACCESS_SHARD_ROWS:
+                    close_shard()
+                csv_writer = ensure_writer()
                 values: list[str] = [_public_record_id_text(apply_id) or ""]
                 for field in selected_fields:
                     answer = _find_answer_for_field(answer_list, field)
                     values.append(_record_access_csv_cell(_normalize_answer_field_value_for_output(answer, field)))
-                shard_writer.write(values)
+                csv_writer.writerow(values)
+                row_count += 1
+                shard_rows += 1
 
             current_page = 1
             has_more = False
@@ -2339,7 +2374,7 @@ class RecordTools(ToolBase):
                         break
                     page = fetch_page(current_page, BACKEND_RECORD_ACCESS_PAGE_SIZE)
             finally:
-                shard_writer.close_shard()
+                close_shard()
 
             if stopped_reason == "TIME_BUDGET_EXCEEDED":
                 warnings.append(_record_access_time_budget_warning(reported_total=reported_total, fetched_pages=fetched_pages))
@@ -2364,11 +2399,11 @@ class RecordTools(ToolBase):
                 "view_id": view_route.view_id,
                 "format": "csv",
                 "local_dir": str(run_dir),
-                "row_count": shard_writer.row_count,
+                "row_count": row_count,
                 "complete": complete,
                 "truncated": not complete,
                 "safe_for_final_conclusion": safe_for_final_conclusion,
-                "files": shard_writer.files,
+                "files": files,
                 "fields": fields_payload,
                 "warnings": warnings,
                 "verification": verification_payload,

package/src/qingflow_mcp/tools/solution_tools.py

@@ -38,7 +38,6 @@ 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"}
@@ -1428,7 +1427,6 @@ 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,6 +111,12 @@ 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/skills/qingflow-cli/reference/data/README.md

@@ -1,32 +0,0 @@
-# Qingflow CLI 直接数据操作
-
-直接查询、读取、新增、更新和删除分别使用：
-
-- `qingflow data query`
-- `qingflow data get`
-- `qingflow data insert`
-- `qingflow data update`
-- `qingflow data delete`
-
-参数、JSON 文件形状和可选项必须来自当前工具 schema、当次 `--help` 或响应字段能力，不得从其他命令推测。
-
-## 字段能力合同
-
-1. 首次操作当前应用时，只通过只读 `data query/get` 请求 `include_schema=true`，读取同一次响应中的 `schema` 与递归 `field_capabilities`；不得用 insert/update 探测能力。
-2. 构造 `where` 时，只使用目标字段 `filter_operators` 实际暴露的 `op`，并匹配对应 `value_shape`；不要在本文复制操作符矩阵。
-3. 写入前优先执行不设置 `columns` 的只读 `data query` 并请求 schema，检查响应中的 `access`，再检查 `insertable`、`updatable` 与 `required_on_insert`。
-4. `write_kind`、schema 与当次 `--help` 共同决定 payload 形状；运行时字段错误和权限结果优先于预检。
-
-## 执行与恢复
-
-- 已知 `app_key` 时直接执行目标业务命令；只有应用名称时先用 `app list --query` 查找并核对 `app_name/title`，目标明确且唯一时取其 `app_key`，否则请用户确认。不能把名称传给 `--app-key`。只有业务命令明确报告会话或工作区错误后才恢复认证上下文。
-- 定位目标记录时先 query，再按需 get。字段只使用当前 schema 与字段能力允许的 id、能力和形状。
-- insert、update、delete 会改变真实业务数据。删除、覆盖已有值或批量写入前，必须确认目标和影响范围。
-- 返回后先检查 `write_executed`、`retry_safe`、字段错误和 hints。已执行、部分成功或状态不明时不得重放原请求。
-- data 命令失败时只修正响应明确指出的问题，不得切换其他数据入口绕过权限或校验。
-
-## 任务分流
-
-- 批量导入：阅读 [批量导入 SOP](../record/QINGFLOW_CLI_RECORD_IMPORT_WORKFLOW.md)。
-- 统计分析：阅读 [数据分析说明](../record/analysis/README.md)，使用 `data query --all --output csv` 并读取全部 CSV 分片。
-- 待办和流程动作：阅读 [任务上下文 SOP](../task/QINGFLOW_CLI_TASK_CONTEXT_WORKFLOW.md)。

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

@@ -1,14 +0,0 @@
-{
-  "name": "项目台账视图",
-  "type": "table",
-  "columns": [100, 101, 102, 103],
-  "data_permission": {"type": "custom", "scope": "dept"},
-  "sort": [{"que_id": 100, "ascending": false}],
-  "display": {"row_height": "compact", "pin_navigate": true},
-  "query_conditions": {
-    "enabled": true,
-    "exact": false,
-    "hide_before_query": false,
-    "rows": [["项目名称", "负责人"], ["创建时间"]]
-  }
-}

package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_SPECIALIZED_WORKFLOW.md

@@ -1,50 +0,0 @@
-# Qingflow CLI：record 日志与附件参考
-
-> **适用范围**：任务需要完整数据／流程日志、附件或图片上下文时使用。普通应用数据查询使用 [`data query/get`](../core/QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md)。
-
-## record 查询链
-
-```text
-app get（解析 accessible_views，选定 VIEW_ID）
-  → record schema browse（读取该视图字段口径）
-  → record list（样本浏览或模糊定位候选）
-  → record get（可选：详情页首屏、附件与图片上下文）
-  → record logs（可选：完整数据日志与流程日志）
-```
-
-## 命令形状
-
-```bash
-qingflow --json app get --app-key APP_KEY > tmp/qingflow_app_get.json
-
-qingflow --json record schema browse \
-  --app-key APP_KEY --view-id VIEW_ID \
-  > tmp/qingflow_record_schema.json
-
-qingflow --json record list \
-  --app-key APP_KEY --view-id VIEW_ID \
-  > tmp/qingflow_record_list.json
-
-qingflow --json record get \
-  --app-key APP_KEY --record-id RECORD_ID --view-id VIEW_ID \
-  > tmp/qingflow_record_get.json
-
-qingflow --json record logs \
-  --app-key APP_KEY --record-id RECORD_ID --view-id VIEW_ID \
-  > tmp/qingflow_record_logs.json
-```
-
-`VIEW_ID` 只能来自 `app get.accessible_views`、已经确认的前端 URL 或用户明确提供的上下文。显式视图失败时不要自动换成另一系统视图。
-
-## 专有结果
-
-- `record get`：用于详情页字段、首屏日志、引用、关联资源、`media_assets` 和 `file_assets`。附件与图片优先使用返回的本地路径，不直接访问远端附件 URL。
-- `record logs`：用于完整可见数据日志和流程日志。响应只读取摘要与 JSONL 文件路径，按需筛选本地文件，不把全文放入上下文。
-- `record list`：只在用户明确指定该命令时用于样本浏览／模糊定位，不用于完整统计结论。
-
-## 边界
-
-- 统计分析仍转 `data query --all --output csv -> Python/pandas`。
-- `CUSTOM_VIEW_LIST_UNAVAILABLE` 只说明自定义视图列表读取受限；不要据此断言应用整体不可读。
-- 待办、已办和抄送属于 `task list --task-box ...`，不使用 `record list --view-id system:todo/done/cc`。
-- 所有大 JSON、附件清单和日志摘要必须落盘。

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json

@@ -1,146 +0,0 @@
-{
-  "$defs": {
-    "EmptyConfig": {
-      "additionalProperties": false,
-      "description": "该字段类型没有特殊配置。",
-      "type": "object"
-    },
-    "FieldCommon": {
-      "allOf": [
-        {
-          "if": {
-            "properties": {
-              "defaultType": {
-                "const": 2
-              }
-            },
-            "required": [
-              "defaultType"
-            ]
-          },
-          "then": {
-            "properties": {
-              "defaultValue": {
-                "type": "null"
-              }
-            }
-          }
-        },
-        {
-          "if": {
-            "properties": {
-              "defaultType": {
-                "const": 3
-              }
-            },
-            "required": [
-              "defaultType"
-            ]
-          },
-          "then": {
-            "properties": {
-              "defaultValue": {
-                "minLength": 1,
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            }
-          }
-        }
-      ],
-      "anyOf": [
-        {
-          "required": [
-            "queId"
-          ]
-        },
-        {
-          "required": [
-            "name"
-          ]
-        }
-      ],
-      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
-      "properties": {
-        "beingRequired": {
-          "description": "该字段是否必填;缺失时保留已有字段当前值。",
-          "type": "boolean"
-        },
-        "defaultType": {
-          "default": 1,
-          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
-          "enum": [
-            1,
-            2,
-            3
-          ],
-          "type": "integer"
-        },
-        "defaultValue": {
-          "$ref": "#/$defs/ScalarDefaultValue",
-          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
-        },
-        "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
-          "minLength": 1,
-          "type": "string"
-        },
-        "queId": {
-          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
-          "minimum": 1,
-          "type": "integer"
-        },
-        "questionDescription": {
-          "description": "字段说明;null 或空字符串表示清空。",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "questionType": {
-          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
-          "type": "string"
-        },
-        "width": {
-          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
-          "maximum": 100,
-          "minimum": 1,
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
-      "type": [
-        "null",
-        "string"
-      ]
-    }
-  },
-  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/rich_text.json",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "allOf": [
-    {
-      "$ref": "#/$defs/FieldCommon"
-    },
-    {
-      "properties": {
-        "config": {
-          "$ref": "#/$defs/EmptyConfig"
-        },
-        "questionType": {
-          "const": "rich_text"
-        }
-      },
-      "required": [
-        "questionType"
-      ]
-    }
-  ],
-  "title": "Qingflow AppForm v1alpha1 rich_text field",
-  "type": "object",
-  "unevaluatedProperties": false
-}

package/src/qingflow_mcp/builder_facade/schemas/views/manifest.json

@@ -1,42 +0,0 @@
-{
-  "manifestDescription": "面向 app_views_apply 的版本化公开视图契约。summary 提供最小声明，complete 覆盖当前可写能力，details 提供按配置域读取的自包含专项 Schema。后端已知但尚不可写的能力以说明性元数据列出，不会被误报为公开能力。",
-  "latestVersion": "v1alpha1",
-  "versions": {
-    "v1alpha1": {
-      "versionDescription": "AI 和 CLI/MCP 使用的 canonical views DSL。字段名、更新语义和约束与 app_views_apply 对齐；schema 返回会内联专项 Schema 的依赖定义。",
-      "apiVersion": "builder.qingflow.com/v1alpha1",
-      "applyDto": "v1alpha1",
-      "contractSource": "app_views_apply",
-      "contractVersion": "v1alpha1",
-      "enabledByDefault": true,
-      "schemaKinds": [
-        "summary",
-        "complete",
-        "display",
-        "data-permission",
-        "operation-permission",
-        "query-condition",
-        "button-config"
-      ],
-      "schemaFiles": {
-        "summary": "v1alpha1/summary.json",
-        "complete": "v1alpha1/complete.json",
-        "display": "v1alpha1/details/display.json",
-        "data-permission": "v1alpha1/details/data-permission.json",
-        "operation-permission": "v1alpha1/details/operation-permission.json",
-        "query-condition": "v1alpha1/details/query-condition.json",
-        "button-config": "v1alpha1/details/button-config.json"
-      },
-      "viewTypes": [
-        "table",
-        "card",
-        "board",
-        "gantt",
-        "hierarchy",
-        "calendar"
-      ],
-      "backendKnownUnsupportedViewTypes": [],
-      "status": "active"
-    }
-  }
-}