@qingflow-tech/qingflow-cli 1.1.44-beta.1 → 1.1.44-beta.2

package/README.md

@@ -7,7 +7,7 @@ Qingflow CLI 是轻流面向开发者和 AI Agent 的命令行工具。它把轻
 ## 安装
 
 ```bash
-npm install @qingflow-tech/qingflow-cli@1.1.44-beta.1
+npm install @qingflow-tech/qingflow-cli@1.1.44-beta.2
 ```
 
 推荐从官网复制这一条一键安装 Qingflow CLI：
@@ -21,7 +21,7 @@ npx qingflow-cli@latest install
 ## 运行
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.44-beta.1 qingflow
+npx -y -p @qingflow-tech/qingflow-cli@1.1.44-beta.2 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.44-beta.1 qingflow-skills install --agent codex --scope user --copy
+npx -y -p @qingflow-tech/qingflow-cli@1.1.44-beta.2 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.44-beta.1",
+  "version": "1.1.44-beta.2",
   "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.44b1"
+version = "1.1.44b2"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

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

@@ -219,6 +219,8 @@ current CLI payload.
 | `data_relation` | 数据关联/引用填充 |
 | `subtable` | 子表（**`subfields[]`**） |
 
+历史表单中的后端 `queType=1` 是“描述文字”布局控件，不属于上述新建字段类型。`app-form get` 为了保持完整声明可校验，会将它兼容输出为 `long_text`；`app-form apply` 会根据已有字段模板恢复原始 `queType=1` 和 `queDefaultValue`，所以修改其他字段时不会丢失描述文字。新建可填写多行文本仍使用 `long_text`，不要用它创建描述文字控件。
+
 **`config.relationMode`**：仅 **`relation`** 使用，取值为 **`single`** 或 **`multiple`**。一个应用可以有多个 `relation` 字段；不要因为 relation 数量超过 1 就改成文本字段。
 
 ### 1.1 历史字段类型别名

package/src/qingflow_mcp/builder_facade/app_form.py

@@ -31,6 +31,10 @@ from .service import (
 
 API_VERSION = "builder.qingflow.com/v1alpha1"
 QUE_TYPE_TO_CANONICAL = {
+    # Historical description-text controls are read as long_text for the
+    # public declaration shape; the compiler restores queType=1 from the
+    # existing backend template when writing them back.
+    1: "long_text",
     2: "text",
     3: "long_text",
     5: "member",
@@ -2377,6 +2381,11 @@ class AppFormCompiler:
                 "queHint": field.get("questionDescription") or "",
             }
         )
+        if _positive_int((template or {}).get("queType")) == 1 and field_type == "long_text":
+            # queType=1 is a non-data description control. Keep its backend
+            # type and template-only settings while allowing the declaration
+            # to carry its stable identity and default content.
+            question["queType"] = 1
         config = field.get("config") if isinstance(field.get("config"), dict) else {}
         if field_type in {"text", "long_text", "link", "phone", "email"}:
             for key in ("minWordCount", "maxWordCount", "noRepeat", "canScan", "scanType"):