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

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

@@ -319,7 +319,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/cli/commands/builder.py

@@ -104,6 +104,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     app_form_schema = app_form_subparsers.add_parser("schema", help="读取 AppForm Schema")
     app_form_schema.add_argument("--schema-version")
+    app_form_schema.add_argument("--schema-kind", choices=("summary", "field", "formula"))
     app_form_schema.add_argument("--field-type")
     app_form_schema.set_defaults(handler=_handle_app_form_schema, format_hint="builder_summary", force_json_output=True)
 
@@ -335,6 +336,7 @@ def _handle_app_form_schema(args: argparse.Namespace, context: CliContext) -> di
     return context.builder.app_form_schema(
         schema_version=args.schema_version,
         field_type=args.field_type,
+        schema_kind=args.schema_kind,
     )
 
 

package/src/qingflow_mcp/server_app_builder.py

@@ -37,7 +37,7 @@ def build_builder_server() -> FastMCP:
             "Use solution_install when the user explicitly wants to install a packaged solution/template by solution_key, optionally copying bundled demo data. "
             "Use package_list to find visible app packages by keyword and package_get to read package detail before editing; if creating or updating an app package may be appropriate, use package_apply with explicit user intent; otherwise use app_resolve to locate app resources, "
             "Use workspace_icon_catalog_get before creating app packages or portals when supported icon/color candidates are needed; those resources require explicit non-template icon + color. AppForm-created apps derive a stable default icon and color from spec.appName. "
-            "app_form_schema plus app_form_get for versioned form work, using being_draft=true only for editing and the published default for relation or record consumers; use app_get as the default non-form app map read, then app_get_fields/app_repair_code_blocks/app_get_layout/app_get_views/app_get_flow/app_get_charts/portal_list/portal_get/view_get/chart_get for focused compatibility or non-form reads, "
+            "app_form_schema plus app_form_get for versioned form work; query app_form_schema with schema_kind=formula before writing defaultType=3 formulas, and use being_draft=true only for editing and the published default for relation or record consumers; use app_get as the default non-form app map read, then app_get_fields/app_repair_code_blocks/app_get_layout/app_get_views/app_get_flow/app_get_charts/portal_list/portal_get/view_get/chart_get for focused compatibility or non-form reads, "
             "member_search/role_search/role_create when workflow assignees must come from the directory or role catalog, preferring roles over explicit members unless the user explicitly names members, "
             "then app_form_apply for complete app form targets, explicit app_delete for application deletion, and app_flow_apply/app_views_apply/app_associated_resources_apply/app_charts_apply/portal_apply/portal_delete for non-form patches. app_custom_buttons_apply is maintenance-only for explicit standalone button work outside normal view design. These apply/delete tools perform validation, normalization, writes, and readback verification where applicable. AppForm publishes only after a draft change or when the published form lags behind; views noop requests skip publish, app_custom_buttons_apply and app_associated_resources_apply publish after at least one write succeeds and expose no draft-only parameter, charts are immediate-live without publish and resolve targets by chart_id first then exact unique chart name, portal updates use replace semantics only when sections are supplied and edit-mode base-info-only updates may omit sections, portal delete separates DELETE execution from readback verification, portal pc layout is a 24-column grid and mobile is a 6-column grid so omit position or use layout_preset when unsure, publish=false only guarantees draft/base-info updates for tools that still expose that parameter, and flow should use publish=false whenever you only want draft/precheck behavior. "
             "Builder apply/write outputs include schema_version, operation, summary, and resources[]; use resources[].id/key/name/ids/parent as the stable UI and agent display entry, and keep legacy fields such as field_diff/views_diff/chart_results only for compatibility or troubleshooting. "
@@ -184,8 +184,13 @@ def build_builder_server() -> FastMCP:
     def app_form_schema(
         schema_version: str | None = None,
         field_type: str | None = None,
+        schema_kind: str | None = None,
     ) -> dict:
-        return ai_builder.app_form_schema(schema_version=schema_version, field_type=field_type)
+        return ai_builder.app_form_schema(
+            schema_version=schema_version,
+            field_type=field_type,
+            schema_kind=schema_kind,
+        )
 
     @server.tool()
     def app_form_get(

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -384,8 +384,13 @@ class AiBuilderTools(ToolBase):
         def app_form_schema(
             schema_version: str | None = None,
             field_type: str | None = None,
+            schema_kind: str | None = None,
         ) -> JSONObject:
-            return self.app_form_schema(schema_version=schema_version, field_type=field_type)
+            return self.app_form_schema(
+                schema_version=schema_version,
+                field_type=field_type,
+                schema_kind=schema_kind,
+            )
 
         @mcp.tool()
         def app_form_get(
@@ -818,9 +823,14 @@ class AiBuilderTools(ToolBase):
         *,
         schema_version: str | None = None,
         field_type: str | None = None,
+        schema_kind: str | None = None,
     ) -> JSONObject:
-        """Return the versioned AppForm summary or one field-type schema."""
-        return self._app_form.schema(schema_version=schema_version, field_type=field_type)
+        """Return a versioned AppForm summary, field, or formula schema."""
+        return self._app_form.schema(
+            schema_version=schema_version,
+            field_type=field_type,
+            schema_kind=schema_kind,
+        )
 
     def app_form_get(
         self,