@qingflow-tech/qingflow-cli 1.1.62 → 1.1.63-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/README.md +3 -3
  2. package/package.json +2 -1
  3. package/pyproject.toml +2 -1
  4. package/skills/qingflow-cli/SKILL.md +112 -3
  5. package/skills/qingflow-cli/reference/builder/20-build-complete-system.md +1 -1
  6. package/skills/qingflow-cli/reference/builder/70-portal.md +46 -6
  7. package/skills/qingflow-cli/reference/builder/README.md +2 -2
  8. package/skills/qingflow-cli/reference/examples/portal/portal_sections_all_types.example.json +22 -5
  9. package/src/qingflow_mcp/builder_facade/app_form.py +5 -0
  10. package/src/qingflow_mcp/builder_facade/models.py +16 -0
  11. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json +59 -0
  12. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json +59 -0
  13. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json +59 -0
  14. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json +59 -0
  15. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/complete.json +2 -2
  16. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/filter.json +111 -29
  17. package/src/qingflow_mcp/builder_facade/service.py +8 -0
  18. package/src/qingflow_mcp/cli/formatters.py +11 -0
  19. package/src/qingflow_mcp/cli/main.py +90 -2
  20. package/src/qingflow_mcp/cli/permission_gate.py +59 -0
  21. package/src/qingflow_mcp/cloud_context.py +16 -1
  22. package/src/qingflow_mcp/entity_permissions.py +10 -0
  23. package/src/qingflow_mcp/permission_catalog.json +1210 -0
  24. package/src/qingflow_mcp/public_surface.py +67 -8
  25. package/src/qingflow_mcp/response_trim.py +2 -1
  26. package/src/qingflow_mcp/server.py +12 -6
  27. package/src/qingflow_mcp/server_app_builder.py +9 -5
  28. package/src/qingflow_mcp/server_app_user.py +9 -5
  29. package/src/qingflow_mcp/server_cloud.py +43 -7
  30. package/src/qingflow_mcp/tool_catalog.py +388 -0
  31. package/src/qingflow_mcp/tool_catalog_i18n.py +184 -0
  32. package/src/qingflow_mcp/tool_policy.py +191 -0
  33. package/src/qingflow_mcp/tools/base.py +1 -0
  34. package/src/qingflow_mcp/tools/record_tools.py +37 -2
@@ -0,0 +1,191 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ import os
5
+ from dataclasses import dataclass
6
+ from typing import Any, Literal, Mapping, Sequence
7
+ from urllib.parse import parse_qs
8
+
9
+ from mcp.server.fastmcp import FastMCP
10
+ from mcp.server.fastmcp.exceptions import ToolError
11
+
12
+ from .cloud_context import current_http_tool_policy, current_tool_policy_header
13
+ from .tool_catalog import TOOL_ID_PATTERN, require_registered_tool_id, tool_is_exempt
14
+
15
+
16
+ TOOL_POLICY_ENV = "QINGFLOW_TOOL_POLICY"
17
+ TOOL_POLICY_HEADER = "X-Qingflow-Tool-Policy"
18
+ TOOL_POLICY_INVALID = "TOOL_POLICY_INVALID"
19
+ TOOL_POLICY_DENIED = "TOOL_POLICY_DENIED"
20
+
21
+
22
+ @dataclass(frozen=True, slots=True)
23
+ class ToolPolicySnapshot:
24
+ mode: Literal["unrestricted", "restricted"]
25
+ allowed_tools: tuple[str, ...] = ()
26
+
27
+ def violation_for(self, stable_id: str) -> "ToolPolicyViolation | None":
28
+ # 基础恢复能力不受业务工具开关限制。
29
+ if tool_is_exempt(stable_id):
30
+ return None
31
+ if self.mode == "unrestricted":
32
+ return None
33
+ if stable_id in self.allowed_tools:
34
+ return None
35
+ return ToolPolicyViolation(TOOL_POLICY_DENIED, stable_id, "当前策略未允许该工具")
36
+
37
+
38
+ class ToolPolicyViolation(Exception):
39
+ def __init__(self, code: str, tool_id_value: str, message: str) -> None:
40
+ super().__init__(message)
41
+ self.code = code
42
+ self.tool_id = tool_id_value
43
+ self.message = message
44
+
45
+ def payload(self, *, camel_case: bool = False) -> dict[str, Any]:
46
+ if camel_case:
47
+ return {
48
+ "status": "failed",
49
+ "errorCode": self.code,
50
+ "message": self.message,
51
+ "toolId": self.tool_id,
52
+ }
53
+ return {
54
+ "status": "failed",
55
+ "error_code": self.code,
56
+ "message": self.message,
57
+ "toolId": self.tool_id,
58
+ }
59
+
60
+
61
+ def parse_tool_policy(value: str | Mapping[str, Any] | None) -> ToolPolicySnapshot:
62
+ """只解析工具开关;非法输入等同未配置,合法空数组仍为受限空清单。"""
63
+ if value is None:
64
+ return ToolPolicySnapshot("unrestricted")
65
+ payload: Any = value
66
+ if isinstance(value, str):
67
+ if value == "":
68
+ return ToolPolicySnapshot("unrestricted")
69
+ try:
70
+ payload = json.loads(value)
71
+ except json.JSONDecodeError:
72
+ return ToolPolicySnapshot("unrestricted")
73
+ if not isinstance(payload, Mapping):
74
+ return ToolPolicySnapshot("unrestricted")
75
+ if set(payload) != {"version", "allowed_tools"}:
76
+ return ToolPolicySnapshot("unrestricted")
77
+ if type(payload.get("version")) is not int or payload.get("version") != 1: # noqa: E721
78
+ return ToolPolicySnapshot("unrestricted")
79
+ allowed = payload.get("allowed_tools")
80
+ if not isinstance(allowed, list):
81
+ return ToolPolicySnapshot("unrestricted")
82
+ normalized: set[str] = set()
83
+ for stable_id in allowed:
84
+ if not isinstance(stable_id, str) or TOOL_ID_PATTERN.fullmatch(stable_id) is None:
85
+ return ToolPolicySnapshot("unrestricted")
86
+ normalized.add(stable_id)
87
+ return ToolPolicySnapshot("restricted", tuple(sorted(normalized)))
88
+
89
+
90
+ def parse_http_tool_policy(header: str | None, query_string: bytes) -> ToolPolicySnapshot:
91
+ # 请求头是显式配置,覆盖 URL 默认配置;非法显式配置也按未配置处理,不回落旧限制。
92
+ if header is not None:
93
+ return parse_tool_policy(header)
94
+ # 保留空值并在 URL 解码后检查重复,tools= 与缺省不能合并为同一种状态。
95
+ values = parse_qs(query_string.decode("latin1"), keep_blank_values=True).get("tools", [])
96
+ if len(values) > 1:
97
+ return ToolPolicySnapshot("unrestricted")
98
+ return parse_tool_policy(
99
+ {"version": 1, "allowed_tools": values[0].split(",") if values[0] else []}
100
+ if values else None
101
+ )
102
+
103
+
104
+ def read_current_tool_policy() -> ToolPolicySnapshot:
105
+ """只读取调用方传入的环境策略,不查询外部服务。"""
106
+ return parse_tool_policy(os.getenv(TOOL_POLICY_ENV))
107
+
108
+
109
+ class PolicyAwareFastMCP(FastMCP):
110
+ """MCP 列表与调用在 handler 边界分别读取当前工具开关。"""
111
+
112
+ def __init__(self, *args: Any, **kwargs: Any) -> None:
113
+ self._tool_policy_bindings: dict[str, str] | None = None
114
+ self._tool_policy_source: Literal["environment", "request"] = "environment"
115
+ super().__init__(*args, **kwargs)
116
+
117
+ def configure_tool_policy(
118
+ self,
119
+ bindings: Mapping[str, str],
120
+ *,
121
+ source: Literal["environment", "request"],
122
+ ) -> None:
123
+ registered = set(self._tool_manager._tools)
124
+ bound = set(bindings)
125
+ if registered != bound:
126
+ missing = sorted(registered - bound)
127
+ extra = sorted(bound - registered)
128
+ raise ValueError(f"工具策略绑定不完整: missing={missing}, extra={extra}")
129
+ for stable_id in bindings.values():
130
+ # 登记校验只依赖提供方稳定 ID,不依赖 Wingent-X 的产品分类。
131
+ require_registered_tool_id(stable_id)
132
+ self._tool_policy_bindings = dict(bindings)
133
+ self._tool_policy_source = source
134
+
135
+ @property
136
+ def tool_policy_bindings(self) -> dict[str, str]:
137
+ return dict(self._tool_policy_bindings or {})
138
+
139
+ async def list_tools(self): # type: ignore[no-untyped-def]
140
+ tools = await super().list_tools()
141
+ bindings = self._require_bindings()
142
+ snapshot = self._current_snapshot()
143
+ return [
144
+ tool
145
+ for tool in tools
146
+ if snapshot.violation_for(bindings[tool.name]) is None
147
+ ]
148
+
149
+ async def call_tool(self, name: str, arguments: dict[str, Any]) -> Sequence[Any] | dict[str, Any]:
150
+ bindings = self._require_bindings()
151
+ stable_id = bindings.get(name)
152
+ if stable_id is None:
153
+ raise ToolError(json.dumps(
154
+ {
155
+ "status": "failed",
156
+ "errorCode": TOOL_POLICY_INVALID,
157
+ "message": "工具未登记稳定 ID",
158
+ },
159
+ ensure_ascii=False,
160
+ ))
161
+ if tool_is_exempt(stable_id):
162
+ return await super().call_tool(name, arguments)
163
+ violation = self._current_snapshot().violation_for(stable_id)
164
+ if violation is not None:
165
+ raise ToolError(json.dumps(violation.payload(camel_case=True), ensure_ascii=False))
166
+ return await super().call_tool(name, arguments)
167
+
168
+ def _require_bindings(self) -> dict[str, str]:
169
+ if self._tool_policy_bindings is None:
170
+ raise RuntimeError("MCP 工具策略绑定尚未配置")
171
+ return self._tool_policy_bindings
172
+
173
+ def _current_snapshot(self) -> ToolPolicySnapshot:
174
+ if self._tool_policy_source == "request":
175
+ snapshot = current_http_tool_policy.get()
176
+ if snapshot is not None:
177
+ return snapshot
178
+ # 保留未经过 HTTP 入口的请求头上下文用法,绝不回退共享 env。
179
+ return parse_tool_policy(current_tool_policy_header.get())
180
+ # 长连接不冻结启动时的工具开关,每次列表或调用都读取当前配置。
181
+ return read_current_tool_policy()
182
+
183
+
184
+ def configure_tool_policy(
185
+ server: PolicyAwareFastMCP,
186
+ bindings: Mapping[str, str],
187
+ *,
188
+ source: Literal["environment", "request"],
189
+ ) -> PolicyAwareFastMCP:
190
+ server.configure_tool_policy(bindings, source=source)
191
+ return server
@@ -29,6 +29,7 @@ _MEMBER_CREDIT_DENIAL_MESSAGES = {
29
29
  ),
30
30
  "MEMBER_QUOTA_NOT_CONFIGURED": "当前成员尚未配置流币额度,请联系工作区管理员",
31
31
  "MEMBER_USAGE_QUERY_FAILED": "成员流币额度校验失败,请稍后重试",
32
+ "MCP_USE_SCOPE_DENIED": "当前成员暂无 MCP / CLI 使用权限,请联系工作区管理员开启",
32
33
  }
33
34
 
34
35
 
@@ -18694,6 +18694,41 @@ def _coerce_amount(value: JSONValue) -> float | None:
18694
18694
  return None
18695
18695
 
18696
18696
 
18697
+ def _decimal_flag_allows_decimal(value: JSONValue) -> bool:
18698
+ """兼容历史数据里 canDecimal 以字符串形态落库的情况("yes"/"true" 视为开,其余视为关)."""
18699
+ if value is True:
18700
+ return True
18701
+ if isinstance(value, str):
18702
+ return value.strip().lower() in {"true", "yes", "1"}
18703
+ return False
18704
+
18705
+
18706
+ def _number_format_options_allow_decimal(raw: JSONObject | None) -> bool:
18707
+ """新数字格式配置(numberFormatOptions,存于 question_extra_attr)是否允许小数.
18708
+
18709
+ 后端语义(NumberFormatOptions.normalize/fromColumns):style 非空才算新格式生效;
18710
+ maximumFractionDigits 未填时默认 MAX_FRACTION_DIGITS=10;为 0 表示仅整数.
18711
+ """
18712
+ options = (raw or {}).get("numberFormatOptions") if isinstance(raw, dict) else None
18713
+ if not isinstance(options, dict):
18714
+ return False
18715
+ if not _normalize_optional_text(options.get("style")):
18716
+ return False
18717
+ maximum = _coerce_count(options.get("maximumFractionDigits"))
18718
+ if maximum is None:
18719
+ return True
18720
+ minimum = _coerce_count(options.get("minimumFractionDigits")) or 0
18721
+ return maximum > 0 or minimum > 0
18722
+
18723
+
18724
+ def _number_field_allows_decimal(field: FormField) -> bool:
18725
+ """数字字段能否写小数:旧开关 canDecimal 或新 numberFormatOptions 任一生效即可."""
18726
+ raw = field.raw if isinstance(field.raw, dict) else {}
18727
+ if _decimal_flag_allows_decimal(raw.get("canDecimal")):
18728
+ return True
18729
+ return _number_format_options_allow_decimal(raw)
18730
+
18731
+
18697
18732
  def _normalize_amount_value_for_write(field: FormField, value: JSONValue) -> str:
18698
18733
  if isinstance(value, bool) or value is None:
18699
18734
  raise RecordInputError(
@@ -18741,7 +18776,7 @@ def _normalize_amount_value_for_write(field: FormField, value: JSONValue) -> str
18741
18776
  details={"field": _field_ref_payload(field), "received_value": value},
18742
18777
  )
18743
18778
 
18744
- allow_decimal = bool((field.raw or {}).get("canDecimal"))
18779
+ allow_decimal = _number_field_allows_decimal(field)
18745
18780
  if not allow_decimal:
18746
18781
  integral_value = decimal_value.to_integral_value()
18747
18782
  if decimal_value != integral_value:
@@ -20927,7 +20962,7 @@ def _write_format_for_field(field: FormField) -> JSONObject:
20927
20962
  if field.que_type in DATE_QUE_TYPES:
20928
20963
  return _write_support_payload(support_level="full", kind="date_string", examples=["2026-03-13 10:00:00"])
20929
20964
  if field.que_type == 8:
20930
- allow_decimal = bool((field.raw or {}).get("canDecimal"))
20965
+ allow_decimal = _number_field_allows_decimal(field)
20931
20966
  payload = _write_support_payload(
20932
20967
  support_level="full",
20933
20968
  kind="amount_number",