@qingflow-tech/qingflow-cli 1.1.43-beta.4 → 1.1.43-beta.5

package/README.md

@@ -7,7 +7,7 @@ Qingflow CLI 是轻流面向开发者和 AI Agent 的命令行工具。它把轻
 ## 安装
 
 ```bash
-npm install @qingflow-tech/qingflow-cli@1.1.43-beta.4
+npm install @qingflow-tech/qingflow-cli@1.1.43-beta.5
 ```
 
 推荐从官网复制这一条一键安装 Qingflow CLI：
@@ -21,7 +21,7 @@ npx qingflow-cli@latest install
 ## 运行
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.43-beta.4 qingflow
+npx -y -p @qingflow-tech/qingflow-cli@1.1.43-beta.5 qingflow
 ```
 
 全局安装后可以直接运行：
@@ -62,7 +62,7 @@ qingflow-skills install --agent codex --scope user
 如果你通过一次性 `npx -p` 执行 skills 安装，建议加 `--copy`，避免 symlink 指向 npm 临时执行缓存：
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.43-beta.4 qingflow-skills install --agent codex --scope user --copy
+npx -y -p @qingflow-tech/qingflow-cli@1.1.43-beta.5 qingflow-skills install --agent codex --scope user --copy
 ```
 
 `qingflow-skills install` 默认使用 symlink，且遇到同名 skill 不会覆盖；只有显式传入 `--force` 才会替换。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-cli",
-  "version": "1.1.43-beta.4",
+  "version": "1.1.43-beta.5",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "1.1.43b4"
+version = "1.1.43b5"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/skills/qingflow-app-form/SKILL.md

@@ -21,11 +21,12 @@ Before creating an app, let AppForm derive a stable default icon and color from
 
 1. Read the AppForm Schema and pin its `schemaVersion` and `apiVersion` for the entire operation.
 2. Read the pinned field Schema for every canonical field type used, including subtable child types.
-3. For an update, read the draft form with `being_draft=true`. Preserve every field, row, section, and subfield that should remain. For a create, build a declaration without `appKey` and with `packageId`, `spec.appName`, and complete `spec.body`; AppForm derives the icon and color from `spec.appName`.
-4. Keep existing `queId`, `sectionId`, `attachId`, and `aliasId` values from get. Omit them only for new resources. Treat `body`, `subfields`, explicit `attachments`, and custom serial-number `components` as complete target state.
-5. Save the declaration as JSON. In CLI, run `qingflow --json builder app-form validate --schema-version PINNED --file DECLARATION.json` before every apply and fix every reported pointer. In MCP, call apply directly; it performs the same declaration validation internally. YAML is not accepted.
-6. Apply the declaration on the selected surface. Record a newly returned `appKey` immediately. On success, show only `operation`, the non-empty `changes/actions` summary, and warnings. On any non-success result, show the recovery diagnostics, especially deleted/changed field names in `diff/remainingDiff`, and the failed phase.
-7. A successful apply has already read back the draft, verified the complete target, and verified the published form. Do not call get only to verify it again. For any non-success result, follow Recovery; never replay a saved backend payload or edit version.
+3. When a field uses `defaultType: 3` or another config accepts a formula, read the pinned formula Schema with CLI `--schema-kind formula` or MCP `schema_kind="formula"`; use its field-reference, operator, and function catalog instead of inventing formula syntax.
+4. For an update, read the draft form with `being_draft=true`. Preserve every field, row, section, and subfield that should remain. For a create, build a declaration without `appKey` and with `packageId`, `spec.appName`, and complete `spec.body`; AppForm derives the icon and color from `spec.appName`.
+5. Keep existing `queId`, `sectionId`, `attachId`, and `aliasId` values from get. Omit them only for new resources. Treat `body`, `subfields`, explicit `attachments`, and custom serial-number `components` as complete target state.
+6. Save the declaration as JSON. In CLI, run `qingflow --json builder app-form validate --schema-version PINNED --file DECLARATION.json` before every apply and fix every reported pointer. In MCP, call apply directly; it performs the same declaration validation internally. YAML is not accepted.
+7. Apply the declaration on the selected surface. Record a newly returned `appKey` immediately. On success, show only `operation`, the non-empty `changes/actions` summary, and warnings. On any non-success result, show the recovery diagnostics, especially deleted/changed field names in `diff/remainingDiff`, and the failed phase.
+8. A successful apply has already read back the draft, verified the complete target, and verified the published form. Do not call get only to verify it again. For any non-success result, follow Recovery; never replay a saved backend payload or edit version.
 
 ## Read Source
 
@@ -56,7 +57,7 @@ Before creating an app, let AppForm derive a stable default icon and color from
 
 - Pin one Schema version; never combine details from different versions or silently upgrade recovery work.
 - Ordinary and section rows contain one to four fields. A section is its own outer block. Subtable columns use only the allowed subfield types returned by the subtable detail Schema.
-- Field declarations may set `defaultType` (`1` static, `2` relation/binding, `3` formula) and `defaultValue`; `defaultValue` is `string | null` because the backend `queDefaultValue` is a string, so numeric literals must be passed as strings. Use `null` to clear a default. These properties also apply to subtable fields. Choice defaults belong in `config.defaultOptions`; address, attachment, subtable, and relation defaults belong in `config.defaultValues`. Omit a default when none is intended.
+- Field declarations may set `defaultType` (`1` static, `2` relation/binding, `3` formula) and `defaultValue`; `defaultValue` is `string | null` because the backend `queDefaultValue` is a string, so numeric literals must be passed as strings. For `defaultType: 3`, query the same version with `--schema-kind formula` or `schema_kind="formula"` before composing the formula. Use `null` to clear a default. These properties also apply to subtable fields. Choice defaults belong in `config.defaultOptions`; address, attachment, subtable, and relation defaults belong in `config.defaultValues`. Omit a default when none is intended.
 - For `code_block`, when `config.codeBlockBinding.outputs` is non-empty, the `code` must explicitly assign `qf_output`, for example `qf_output = { score: input.score };`; `return {...}` alone does not satisfy output writeback, and each output `path` must point under `qf_output`.
 - A relation formula default is `config.defaultValueFormula` and must satisfy the pinned `relation` field Schema's `FormulaExpression`; do not infer its syntax from another version or from backend DTO names.
 - If widths are present, every field in that row must have one and the total must equal 100.

package/skills/qingflow-cli/reference/builder/30-schema-fields.md

@@ -164,7 +164,7 @@ current CLI payload.
 
 ## Field type reference
 
-> **口径**：`field.questionType` 枚举和字段形状以固定版本的 **`qingflow --json builder app-form schema`** 返回结果为准；每个 canonical 类型还可用 `--field-type TYPE` 获取细节。不要从已退休的 `app_schema_apply` contract 推断当前 AppForm payload。
+> **口径**：`field.questionType` 枚举和字段形状以固定版本的 **`qingflow --json builder app-form schema`** 返回结果为准；每个 canonical 类型还可用 `--field-type TYPE` 获取细节，`defaultType: 3` 的公式语法和函数目录用 `--schema-kind formula` 获取。不要从已退休的 `app_schema_apply` contract 推断当前 AppForm payload。
 > **CLI**：表单写入使用 `qingflow [--profile NAME] --json builder app-form schema/get/validate/apply`；`validate/apply` 接受 `--file`，`get` 接受 `--app-key`。旧 `builder schema apply` 及 `builder layout apply` 不在当前 parser 的公开命令集合中。
 > **新建应用主规则**：`spec.body` 非空时必须用 `spec.dataTitleField` 唯一选择一个顶层字段作为数据标题；数据封面可选，只能用 `spec.dataCoverField` 选择顶层 `attachment` 字段。
 > **权限**：包内新建应用按后端 `CreateAppBean` 链路只预检目标包 **AddAppAuth**；已有应用的字段/基础信息变更才走应用自身 **EditAppAuth**。
@@ -292,7 +292,8 @@ current CLI payload.
 |------|------|
 | **当前完整系统主入口** | [20-build-complete-system.md](./20-build-complete-system.md) |
 | **历史字段类型能力探针（不是新建主模板）** | [schema_apply_add_fields_all_types.json](../examples/schema/schema_apply_add_fields_all_types.json)（仅用于旧字段能力覆盖测试；当前新建和更新统一使用上文 AppForm） |
-| **`q_linker` / `code_block` / relation 公式**（契约内置形状） | `qingflow --json builder app-form schema --schema-version VERSION --field-type TYPE` 返回的固定版本字段详情 |
+| **`q_linker` / `code_block` / relation 配置**（契约内置形状） | `qingflow --json builder app-form schema --schema-version VERSION --field-type TYPE` 返回的固定版本字段详情 |
+| **默认值与其他公式文本** | `qingflow --json builder app-form schema --schema-version VERSION --schema-kind formula` 返回的同版本公式语法、字段引用、运算符和函数目录 |
 | 最小新建字段（1 个 text 标题字段） | [schema_add_fields_minimal.example.json](../examples/schema/schema_add_fields_minimal.example.json) |
 | 历史 scalar / complex 批测（可选） | [_batch_schema_scalar.json](../examples/schema/_batch_schema_scalar.json)、[_batch_schema_complex.json](../examples/schema/_batch_schema_complex.json) |
 

package/src/qingflow_mcp/app_form_validator.py

@@ -23,6 +23,7 @@ _INTEGRATION_OUTPUT_TARGET_FIELD_TYPES = {
     "multi_select",
 }
 _Q_LINKER_TEMPLATE_RE = re.compile(r"\{\{(?P<key>[^{}\s]+)\}\}")
+_FORMULA_IDENTIFIER_RE = re.compile(r"[A-Za-z_][A-Za-z0-9_]*")
 
 
 class AppFormValidationError(ValueError):
@@ -68,6 +69,18 @@ def _local_schema_call(schema_version: str | None, field_type: str | None) -> di
     return {"status": "success", **app_form_schema_registry().schema(schema_version=schema_version, field_type=field_type)}
 
 
+def _supported_formula_functions(schema_version: str) -> frozenset[str]:
+    """Load the version-pinned formula function catalogue used by local validation."""
+    from .builder_facade.app_form_schema import app_form_schema_registry
+
+    response = app_form_schema_registry().schema(schema_version=schema_version, schema_kind="formula")
+    schema = response.get("schema") if isinstance(response, dict) else None
+    functions = schema.get("x-qingflow-functions") if isinstance(schema, dict) else None
+    if not isinstance(functions, dict) or not functions:
+        raise RuntimeError(f"/: AppForm formula Schema has no function catalogue for {schema_version}")
+    return frozenset(str(name).upper() for name in functions if isinstance(name, str) and name)
+
+
 def _compose(summary: dict[str, Any], details: list[dict[str, Any]]) -> dict[str, Any]:
     if not details:
         raise RuntimeError("at least one field Schema is required to compose AppForm validation")
@@ -101,6 +114,87 @@ def _pointer(parts: Iterable[Any]) -> str:
     return "/" + "/".join(encoded) if encoded else "/"
 
 
+def _formula_function_calls(expression: str) -> set[str]:
+    """Extract calls outside quoted string literals without parsing the full formula grammar."""
+    calls: set[str] = set()
+    index = 0
+    while index < len(expression):
+        character = expression[index]
+        if character in {"'", '"'}:
+            quote = character
+            index += 1
+            while index < len(expression):
+                if expression[index] == "\\":
+                    index += 2
+                    continue
+                if expression[index] == quote:
+                    index += 1
+                    break
+                index += 1
+            continue
+        match = _FORMULA_IDENTIFIER_RE.match(expression, index)
+        if match is None:
+            index += 1
+            continue
+        name = match.group(0)
+        cursor = match.end()
+        while cursor < len(expression) and expression[cursor].isspace():
+            cursor += 1
+        if cursor < len(expression) and expression[cursor] in {"(", "（"}:
+            calls.add(name)
+        index = match.end()
+    return calls
+
+
+def _iter_formula_expressions(payload: dict[str, Any]) -> Iterable[tuple[str, str]]:
+    spec = payload.get("spec")
+    body = spec.get("body") if isinstance(spec, dict) else None
+    if not isinstance(body, list):
+        return
+
+    def visit(field: Any, path: str) -> Iterable[tuple[str, str]]:
+        if not isinstance(field, dict):
+            return
+        if field.get("defaultType") == 3 and isinstance(field.get("defaultValue"), str):
+            yield f"{path}/defaultValue", field["defaultValue"]
+        config = field.get("config") if isinstance(field.get("config"), dict) else {}
+        default_value_formula = config.get("defaultValueFormula")
+        if isinstance(default_value_formula, str):
+            yield f"{path}/config/defaultValueFormula", default_value_formula
+        filters = config.get("filters") if isinstance(config.get("filters"), dict) else {}
+        if filters.get("mode") == "advanced" and isinstance(filters.get("formula"), str):
+            yield f"{path}/config/filters/formula", filters["formula"]
+        for child_index, child in enumerate(field.get("subfields") or []):
+            yield from visit(child, f"{path}/subfields/{child_index}")
+
+    for block_index, block in enumerate(body):
+        if not isinstance(block, dict):
+            continue
+        rows = [(block, f"/spec/body/{block_index}")] if block.get("kind") == "row" else [
+            (row, f"/spec/body/{block_index}/rows/{row_index}")
+            for row_index, row in enumerate(block.get("rows") or [])
+        ]
+        for row, row_path in rows:
+            if not isinstance(row, dict):
+                continue
+            for field_index, field in enumerate(row.get("fields") or []):
+                yield from visit(field, f"{row_path}/fields/{field_index}")
+
+
+def _formula_errors(payload: dict[str, Any], supported_functions: frozenset[str]) -> list[tuple[str, str]]:
+    errors: list[tuple[str, str]] = []
+    for pointer, expression in _iter_formula_expressions(payload):
+        unknown = sorted(name for name in _formula_function_calls(expression) if name.upper() not in supported_functions)
+        for name in unknown:
+            errors.append(
+                (
+                    pointer,
+                    f"unsupported formula function '{name}'; use a function declared by builder app-form schema --schema-kind formula",
+                )
+            )
+    return errors
+
+
 def _static_errors(payload: dict[str, Any]) -> list[tuple[str, str]]:
     errors: list[tuple[str, str]] = []
     spec = payload.get("spec")
@@ -346,6 +440,7 @@ def validate_declaration(
         ) from error
     if declaration.get("apiVersion") != api_version:
         raise ValueError(f"/apiVersion: expected {api_version!r} for schemaVersion {pinned!r}")
+    supported_formula_functions = _supported_formula_functions(pinned)
     types = _field_types(declaration)
     details = [schema_call(pinned, field_type) for field_type in (types or ("text",))]
     for detail in details:
@@ -359,6 +454,8 @@ def validate_declaration(
         found[(_pointer(error.absolute_path), f"{error.validator}: {schema_error_message(error)}")] = None
     for pointer, message in _static_errors(declaration):
         found[(pointer, message)] = None
+    for pointer, message in _formula_errors(declaration, supported_formula_functions):
+        found[(pointer, message)] = None
     if found:
         issues = [{"pointer": pointer, "message": message} for pointer, message in sorted(found)]
         raise AppFormValidationError(issues, schema_version=pinned, api_version=api_version)

package/src/qingflow_mcp/builder_facade/app_form.py

@@ -2834,9 +2834,22 @@ class AppFormReconciler:
         self.normalizer = AppFormNormalizer()
         self.compiler = AppFormCompiler(apps)
 
-    def schema(self, *, schema_version: str | None, field_type: str | None) -> JSONObject:
+    def schema(
+        self,
+        *,
+        schema_version: str | None,
+        field_type: str | None,
+        schema_kind: str | None = None,
+    ) -> JSONObject:
         try:
-            return {"status": "success", **self.registry.schema(schema_version=schema_version, field_type=field_type)}
+            return {
+                "status": "success",
+                **self.registry.schema(
+                    schema_version=schema_version,
+                    field_type=field_type,
+                    schema_kind=schema_kind,
+                ),
+            }
         except AppFormContractError as error:
             return self._failure(error.error_code, error.message, "SCHEMA", details=error.details)
 

package/src/qingflow_mcp/builder_facade/app_form_schema.py

@@ -139,6 +139,7 @@ class AppFormSchemaContext:
     api_version: str
     complete_schema: JSONObject
     supported_types: tuple[str, ...]
+    supported_schema_kinds: tuple[str, ...]
     contract_source: str
     contract_version: str
     normalizer_version: str
@@ -242,6 +243,9 @@ class AppFormSchemaRegistry:
             api_version = str(metadata.get("apiVersion") or "")
             complete = self._read_json(root / version / "complete.json")
             supported = tuple(str(item) for item in metadata.get("fieldTypes") or ())
+            supported_schema_kinds = tuple(str(item) for item in metadata.get("schemaKinds") or ("summary", "field"))
+            if not {"summary", "field"}.issubset(supported_schema_kinds):
+                raise RuntimeError(f"AppForm schema version must support summary and field Schemas: {version}")
             if complete.get("properties", {}).get("apiVersion", {}).get("const") != api_version:
                 raise RuntimeError(f"AppForm schema apiVersion mismatch for {version}")
             schema_id = str(complete.get("$id") or "")
@@ -254,6 +258,11 @@ class AppFormSchemaRegistry:
                 raise RuntimeError(f"AppForm summary apiVersion mismatch for {version}")
             Draft202012Validator.check_schema(summary)
             self._validate_local_refs(summary, root / version / "summary.json")
+            if "formula" in supported_schema_kinds:
+                formula_path = root / version / "formula.json"
+                formula = self._read_json(formula_path)
+                Draft202012Validator.check_schema(formula)
+                self._validate_local_refs(formula, formula_path)
             for field_type in supported:
                 field_path = root / version / "fields" / f"{field_type}.json"
                 field_schema = self._read_json(field_path)
@@ -264,6 +273,7 @@ class AppFormSchemaRegistry:
                 api_version,
                 complete,
                 supported,
+                supported_schema_kinds,
                 str(metadata.get("contractSource") or "app_form"),
                 str(metadata.get("contractVersion") or version),
                 str(metadata.get("normalizerVersion") or version),
@@ -272,12 +282,46 @@ class AppFormSchemaRegistry:
             self._contexts[version] = context
             self._api_to_version[api_version] = version
 
-    def schema(self, *, schema_version: str | None = None, field_type: str | None = None) -> JSONObject:
+    def schema(
+        self,
+        *,
+        schema_version: str | None = None,
+        field_type: str | None = None,
+        schema_kind: str | None = None,
+    ) -> JSONObject:
         context = self.resolve_schema_version(schema_version)
-        if field_type is None:
+        requested_kind = str(schema_kind or ("field" if field_type is not None else "summary")).strip()
+        if requested_kind not in context.supported_schema_kinds:
+            raise AppFormContractError(
+                "UNSUPPORTED_SCHEMA_KIND",
+                f"unsupported AppForm schema kind: {requested_kind}",
+                details={"supportedKinds": list(context.supported_schema_kinds)},
+            )
+        if requested_kind == "formula":
+            if field_type is not None:
+                raise AppFormContractError(
+                    "INVALID_SCHEMA_SELECTION",
+                    "field_type cannot be combined with schema_kind=formula",
+                    details={"schemaKind": requested_kind, "fieldType": field_type},
+                )
+            schema = self._read_json(self.root / context.schema_version / "formula.json")
+            resolved_kind = "formula"
+        elif requested_kind == "summary":
+            if field_type is not None:
+                raise AppFormContractError(
+                    "INVALID_SCHEMA_SELECTION",
+                    "field_type requires schema_kind=field or an omitted schema_kind",
+                    details={"schemaKind": requested_kind, "fieldType": field_type},
+                )
             schema = self._read_json(self.root / context.schema_version / "summary.json")
-            schema_kind = "summary"
+            resolved_kind = "summary"
         else:
+            if field_type is None:
+                raise AppFormContractError(
+                    "INVALID_SCHEMA_SELECTION",
+                    "schema_kind=field requires field_type",
+                    details={"schemaKind": requested_kind, "supportedTypes": list(context.supported_types)},
+                )
             if field_type not in context.supported_types:
                 raise AppFormContractError(
                     "UNSUPPORTED_SCHEMA_FIELD_TYPE",
@@ -285,14 +329,15 @@ class AppFormSchemaRegistry:
                     details={"supportedTypes": list(context.supported_types)},
                 )
             schema = self._read_json(self.root / context.schema_version / "fields" / f"{field_type}.json")
-            schema_kind = "field"
+            resolved_kind = "field"
         return {
             "schemaVersion": context.schema_version,
             "apiVersion": context.api_version,
             "latestVersion": self.latest_version,
             "storedVersions": list(self.stored_versions),
             "enabledVersions": list(self.enabled_versions),
-            "schemaKind": schema_kind,
+            "supportedSchemaKinds": list(context.supported_schema_kinds),
+            "schemaKind": resolved_kind,
             "fieldType": field_type,
             "schema": schema,
         }

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

@@ -31,6 +31,11 @@
         "subtable"
       ],
       "normalizerVersion": "v1alpha1",
+      "schemaKinds": [
+        "summary",
+        "field",
+        "formula"
+      ],
       "status": "active"
     }
   }

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json

@@ -1593,10 +1593,12 @@
           ]
         },
         "currencyType": {
-          "default": 1,
-          "description": "货币类型 ID;后端发布要求为非空正整数,即使 currencyStatus 为 false 也不得传 null。无需指定时省略并使用默认值 1。",
+          "description": "货币类型 ID。",
           "minimum": 1,
-          "type": "integer"
+          "type": [
+            "integer",
+            "null"
+          ]
         },
         "decimalDigit": {
           "description": "小数位数。",
@@ -2083,7 +2085,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"
@@ -2624,14 +2626,7 @@
           ]
         },
         "tableRowHeight": {
-          "description": "子表行高;只允许 compact（紧凑）、moderate（适中）、easy（宽松）或 highest（最高）。省略表示保留现有值，null 表示清除并使用后端默认的紧凑行高。",
-          "enum": [
-            "compact",
-            "moderate",
-            "easy",
-            "highest",
-            null
-          ],
+          "minLength": 1,
           "type": [
             "string",
             "null"

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

@@ -359,7 +359,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -137,10 +137,12 @@
           ]
         },
         "currencyType": {
-          "default": 1,
-          "description": "货币类型 ID;后端发布要求为非空正整数,即使 currencyStatus 为 false 也不得传 null。无需指定时省略并使用默认值 1。",
+          "description": "货币类型 ID。",
           "minimum": 1,
-          "type": "integer"
+          "type": [
+            "integer",
+            "null"
+          ]
         },
         "decimalDigit": {
           "description": "小数位数。",
@@ -201,7 +203,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -392,7 +392,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -284,7 +284,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -546,7 +546,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -117,7 +117,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -117,7 +117,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -264,7 +264,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -112,7 +112,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -112,7 +112,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -112,7 +112,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -404,7 +404,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -180,7 +180,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"

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

@@ -137,10 +137,12 @@
           ]
         },
         "currencyType": {
-          "default": 1,
-          "description": "货币类型 ID;后端发布要求为非空正整数,即使 currencyStatus 为 false 也不得传 null。无需指定时省略并使用默认值 1。",
+          "description": "货币类型 ID。",
           "minimum": 1,
-          "type": "integer"
+          "type": [
+            "integer",
+            "null"
+          ]
         },
         "decimalDigit": {
           "description": "小数位数。",
@@ -201,7 +203,7 @@
       "type": "object"
     },
     "ScalarDefaultValue": {
-      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。需要配置结构化默认值时,通过 AppForm Schema 查询能力传入当前 schema_version,并将字段的 questionType 作为 field_type 获取该字段类型的详细 Schema,再按其中的字段专用 config 定义填写。",
+      "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"