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

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

@@ -0,0 +1,1594 @@
+{
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/formula.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "轻流 AppForm 公式表达式契约。用于 defaultType=3 的 defaultValue，以及其他明确声明接受公式文本的配置。",
+  "minLength": 1,
+  "title": "Qingflow AppForm v1alpha1 formula expression",
+  "type": "string",
+  "x-qingflow-field-references": {
+    "dynamicConcatExample": {
+      "fieldMapping": [
+        {
+          "fieldName": "文本字段",
+          "queId": 101,
+          "reference": "#queId_101$"
+        },
+        {
+          "fieldName": "数字字段",
+          "queId": 102,
+          "reference": "#queId_102$"
+        }
+      ],
+      "formula": "CONCAT(\"文本字段：\", #queId_101$, \" / 数字字段：\", #queId_102$)",
+      "meaning": "随两个字段当前值变化的动态拼接。"
+    },
+    "examples": [
+      "#queId_101$",
+      "CONCAT(\"文本字段：\", #queId_101$, \" / 数字字段：\", #queId_102$)",
+      "IF(#queId_103$ > 0, #queId_101$, #queId_102$)"
+    ],
+    "meaning": "引用当前应用中 queId 为 fieldId 的字段值。",
+    "nonDynamicExamples": [
+      {
+        "expression": "CONCAT(\"文本字段：\", \"测试文本\", \" / 数字字段：\", \"12.50\")",
+        "meaning": "仅拼接固定字符串；它不会引用文本字段或数字字段的当前值。"
+      },
+      {
+        "expression": "CONCAT(\"文本字段：\", \"文本字段\", \" / 数字字段：\", \"数字字段\")",
+        "meaning": "字段名称被当作固定字符串，不能作为字段引用。"
+      }
+    ],
+    "rules": [
+      "fieldId 必须是目标字段实际保存后的十进制 queId；引用标记必须完整且不能加引号。",
+      "字段 name、字段标题、字段描述及字段默认值不能作为公式变量或引用标记。",
+      "动态拼接必须在 CONCAT 中传入 #queId_<fieldId>$，不能以字段名称或默认值字符串代替。"
+    ],
+    "syntax": "#queId_<fieldId>$"
+  },
+  "x-qingflow-functions": {
+    "AND": {
+      "category": "logical",
+      "example": "AND(#queId_101$ > 0, #queId_102$ > 0)",
+      "meaning": "判断所有条件是否都为真。",
+      "parameters": [
+        {
+          "description": "一个或多个布尔条件",
+          "name": "conditions",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "全部为真时返回 TRUE，否则返回 FALSE",
+        "type": "boolean"
+      },
+      "signatures": [
+        "AND(condition1, condition2, ...)"
+      ]
+    },
+    "AVERAGE": {
+      "category": "number",
+      "example": "AVERAGE(#queId_101$, #queId_102$)",
+      "meaning": "计算所有数字参数和列表元素的算术平均值。",
+      "parameters": [
+        {
+          "description": "数字、数字字段或数字列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "平均值；没有数值时返回 0",
+        "type": "number"
+      },
+      "signatures": [
+        "AVERAGE(value1, value2, ...)"
+      ]
+    },
+    "BASE64": {
+      "category": "utility",
+      "example": "BASE64(#queId_101$)",
+      "meaning": "将文本编码为 Base64。",
+      "parameters": [
+        {
+          "description": "待编码值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "Base64 文本",
+        "type": "string"
+      },
+      "signatures": [
+        "BASE64(value)"
+      ]
+    },
+    "CONCAT": {
+      "category": "text",
+      "example": "CONCAT(\"文本字段：\", #queId_101$, \" / 数字字段：\", #queId_102$)",
+      "meaning": "按参数顺序直接拼接文本；列表参数会先展开。要拼接字段当前值时，字段参数必须使用未加引号的 #queId_<字段ID>$，不能使用字段 name 或默认值字符串。",
+      "parameters": [
+        {
+          "description": "要拼接的字段当前值（#queId_<字段ID>$）、静态文本或其他值；字段 name 不是合法变量",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "拼接后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "CONCAT(value1, value2, ...)"
+      ]
+    },
+    "COUNT": {
+      "category": "number",
+      "example": "COUNT(#queId_101$, #queId_102$)",
+      "meaning": "统计非 null 参数包含的值数量，列表按元素计数。",
+      "parameters": [
+        {
+          "description": "待计数的值或列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "值数量",
+        "type": "number"
+      },
+      "signatures": [
+        "COUNT(value1, value2, ...)"
+      ]
+    },
+    "COUNTIF": {
+      "category": "number",
+      "example": "COUNTIF(#queId_101$, \">=60\")",
+      "meaning": "统计列表中满足比较条件的元素数量。",
+      "parameters": [
+        {
+          "description": "待统计列表",
+          "name": "values"
+        },
+        {
+          "description": "精确匹配文本，或以 !、>、<、= 开头的比较表达式文本",
+          "name": "compare"
+        }
+      ],
+      "returns": {
+        "description": "满足条件的元素数量",
+        "type": "number"
+      },
+      "signatures": [
+        "COUNTIF(values, compare)"
+      ]
+    },
+    "CURDATE": {
+      "category": "date",
+      "example": "CURDATE()",
+      "meaning": "取得公式执行时的当前日期。",
+      "parameters": [],
+      "returns": {
+        "description": "yyyy-MM-dd 格式的当前日期",
+        "type": "string"
+      },
+      "signatures": [
+        "CURDATE()"
+      ]
+    },
+    "DATE": {
+      "category": "date",
+      "example": "DATE(2026, 8, 20, 9, 30, 0)",
+      "meaning": "用年、月、日以及可选的时、分、秒构造日期时间。",
+      "parameters": [
+        {
+          "description": "年份",
+          "name": "year"
+        },
+        {
+          "description": "月份",
+          "name": "month"
+        },
+        {
+          "description": "日",
+          "name": "day"
+        },
+        {
+          "description": "可选的小时、分钟、秒",
+          "name": "timeParts",
+          "optional": true,
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "yyyy-MM-dd HH:mm:ss 格式文本；参数无效时返回 null",
+        "type": "string | null"
+      },
+      "signatures": [
+        "DATE(year, month, day)",
+        "DATE(year, month, day, hour, minute, second)"
+      ]
+    },
+    "DATEDELTA": {
+      "category": "date",
+      "example": "DATEDELTA(#queId_101$, 7, \"D\")",
+      "meaning": "给日期时间增加或减少指定单位的数量。",
+      "parameters": [
+        {
+          "description": "原日期或日期时间",
+          "name": "date"
+        },
+        {
+          "description": "增减数量，正数增加、负数减少",
+          "name": "number"
+        },
+        {
+          "description": "可选单位：Y 年、M 月、D 日、H 时、MIN 分；省略或无法识别时按 D",
+          "name": "unit",
+          "optional": true
+        }
+      ],
+      "returns": {
+        "description": "yyyy-MM-dd HH:mm:ss 格式的计算结果",
+        "type": "string | null"
+      },
+      "signatures": [
+        "DATEDELTA(date, days)",
+        "DATEDELTA(date, number, unit)"
+      ]
+    },
+    "DATETOTIMESTAMP": {
+      "category": "date",
+      "example": "DATETOTIMESTAMP(#queId_101$)",
+      "meaning": "将日期时间转换为 13 位毫秒时间戳。",
+      "parameters": [
+        {
+          "description": "日期或日期时间",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "毫秒时间戳文本；无法解析时返回 null",
+        "type": "string | null"
+      },
+      "signatures": [
+        "DATETOTIMESTAMP(value)"
+      ]
+    },
+    "DAY": {
+      "category": "date",
+      "example": "DAY(#queId_101$)",
+      "meaning": "提取日期或日期时间中的日。",
+      "parameters": [
+        {
+          "description": "日期或日期时间",
+          "name": "date"
+        }
+      ],
+      "returns": {
+        "description": "月内日期文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "DAY(date)"
+      ]
+    },
+    "DAYS": {
+      "category": "date",
+      "example": "DAYS(#queId_102$, #queId_101$)",
+      "meaning": "计算结束日期时间与开始日期时间之间的天数，支持按行对齐的列表。",
+      "parameters": [
+        {
+          "description": "结束日期或列表",
+          "name": "end"
+        },
+        {
+          "description": "开始日期或列表",
+          "name": "start"
+        }
+      ],
+      "returns": {
+        "description": "天数文本列表，可包含负数",
+        "type": "list"
+      },
+      "signatures": [
+        "DAYS(end, start)"
+      ]
+    },
+    "DETRIPLEDES": {
+      "category": "utility",
+      "example": "DETRIPLEDES(#queId_101$, \"123456789012345678901234\")",
+      "meaning": "解密由兼容 3DES 参数生成的 Base64 密文。",
+      "parameters": [
+        {
+          "description": "Base64 密文",
+          "name": "content"
+        },
+        {
+          "description": "加密时使用的密钥",
+          "name": "secret"
+        },
+        {
+          "description": "非 ECB 模式使用的 8 字节向量",
+          "name": "iv",
+          "optional": true
+        },
+        {
+          "description": "加密时使用的模式",
+          "name": "mode",
+          "optional": true
+        },
+        {
+          "description": "加密时使用的填充模式",
+          "name": "padding",
+          "optional": true
+        }
+      ],
+      "returns": {
+        "description": "解密后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "DETRIPLEDES(content, secret)",
+        "DETRIPLEDES(content, secret, iv, mode, padding)"
+      ]
+    },
+    "FIRST": {
+      "category": "text",
+      "example": "FIRST(#queId_101$)",
+      "meaning": "取得列表中的第一个值并转为文本。",
+      "parameters": [
+        {
+          "description": "列表或产生列表的字段引用",
+          "name": "values"
+        }
+      ],
+      "returns": {
+        "description": "第一个值；空列表返回空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "FIRST(values)"
+      ]
+    },
+    "GETUSEREMAIL": {
+      "category": "context",
+      "example": "GETUSEREMAIL()",
+      "meaning": "取得当前执行用户的邮箱。",
+      "parameters": [],
+      "returns": {
+        "description": "当前用户邮箱；无法取得时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "GETUSEREMAIL()"
+      ]
+    },
+    "GETUSERNAME": {
+      "category": "context",
+      "example": "GETUSERNAME()",
+      "meaning": "取得当前执行用户在当前工作区中的显示名称。",
+      "parameters": [],
+      "returns": {
+        "description": "当前用户显示名称；无法取得时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "GETUSERNAME()"
+      ]
+    },
+    "HOUR": {
+      "category": "date",
+      "example": "HOUR(#queId_101$)",
+      "meaning": "提取日期时间中的小时。",
+      "parameters": [
+        {
+          "description": "日期时间",
+          "name": "date"
+        }
+      ],
+      "returns": {
+        "description": "0 至 23 的小时文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "HOUR(date)"
+      ]
+    },
+    "IF": {
+      "category": "logical",
+      "example": "IF(#queId_101$ >= 60, \"通过\", \"未通过\")",
+      "meaning": "根据一个条件返回两个候选值之一。",
+      "parameters": [
+        {
+          "description": "布尔条件",
+          "name": "condition"
+        },
+        {
+          "description": "条件为真时返回的值",
+          "name": "valueIfTrue"
+        },
+        {
+          "description": "条件为假时返回的值",
+          "name": "valueIfFalse"
+        }
+      ],
+      "returns": {
+        "description": "选中的分支值",
+        "type": "any"
+      },
+      "signatures": [
+        "IF(condition, valueIfTrue, valueIfFalse)"
+      ]
+    },
+    "IFS": {
+      "category": "logical",
+      "example": "IFS(#queId_101$ >= 90, \"优秀\", #queId_101$ >= 60, \"通过\", TRUE, \"未通过\")",
+      "meaning": "按顺序判断多组条件并返回第一组真条件对应的文本。",
+      "parameters": [
+        {
+          "description": "条件和值交替排列，条件按顺序求值",
+          "name": "conditionValuePairs",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "第一组成立条件对应的文本；均不成立时返回空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "IFS(condition1, value1, condition2, value2, ...)"
+      ]
+    },
+    "INT": {
+      "category": "number",
+      "example": "INT(#queId_101$)",
+      "meaning": "将数字向负无穷方向取整。",
+      "parameters": [
+        {
+          "description": "数字",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "整数值",
+        "type": "number"
+      },
+      "signatures": [
+        "INT(value)"
+      ]
+    },
+    "ISEMPTY": {
+      "category": "text",
+      "example": "ISEMPTY(#queId_101$)",
+      "meaning": "判断值转换为文本后是否为空。",
+      "parameters": [
+        {
+          "description": "待判断值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "为空时返回 TRUE，否则返回 FALSE",
+        "type": "boolean"
+      },
+      "signatures": [
+        "ISEMPTY(value)"
+      ]
+    },
+    "JADEPTID": {
+      "category": "context",
+      "example": "JADEPTID()",
+      "meaning": "取得当前用户的集成组织 ID。",
+      "parameters": [],
+      "returns": {
+        "description": "组织 ID；没有对应信息时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "JADEPTID()"
+      ]
+    },
+    "JADEPTNAME": {
+      "category": "context",
+      "example": "JADEPTNAME()",
+      "meaning": "取得当前用户的集成组织名称。",
+      "parameters": [],
+      "returns": {
+        "description": "组织名称；没有对应信息时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "JADEPTNAME()"
+      ]
+    },
+    "JAID": {
+      "category": "context",
+      "example": "JAID()",
+      "meaning": "取得当前用户的集成身份 SID。",
+      "parameters": [],
+      "returns": {
+        "description": "集成身份 SID；没有对应信息时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "JAID()"
+      ]
+    },
+    "JANAME": {
+      "category": "context",
+      "example": "JANAME()",
+      "meaning": "取得当前用户名称，与 GETUSERNAME 的当前实现一致。",
+      "parameters": [],
+      "returns": {
+        "description": "当前用户显示名称",
+        "type": "string"
+      },
+      "signatures": [
+        "JANAME()"
+      ]
+    },
+    "JATYPE": {
+      "category": "context",
+      "example": "JATYPE()",
+      "meaning": "取得当前用户的集成用户类型。",
+      "parameters": [],
+      "returns": {
+        "description": "学生、校友、教职工、博士后、集体账号或其他；没有对应信息时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "JATYPE()"
+      ]
+    },
+    "JOIN": {
+      "category": "text",
+      "example": "JOIN(\",\", #queId_101$, #queId_102$)",
+      "meaning": "使用指定分隔符连接一个或多个值；列表参数会先展开。",
+      "parameters": [
+        {
+          "description": "连接分隔符",
+          "name": "delimiter"
+        },
+        {
+          "description": "要连接的值",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "带分隔符的连接文本",
+        "type": "string"
+      },
+      "signatures": [
+        "JOIN(delimiter, value1, value2, ...)"
+      ]
+    },
+    "LAST": {
+      "category": "text",
+      "example": "LAST(#queId_101$)",
+      "meaning": "取得列表中的最后一个值并转为文本。",
+      "parameters": [
+        {
+          "description": "列表或产生列表的字段引用",
+          "name": "values"
+        }
+      ],
+      "returns": {
+        "description": "最后一个值；空列表返回空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "LAST(values)"
+      ]
+    },
+    "LEFT": {
+      "category": "text",
+      "example": "LEFT(#queId_101$, 3)",
+      "meaning": "从文本左侧截取指定数量的字符。",
+      "parameters": [
+        {
+          "description": "原文本",
+          "name": "text"
+        },
+        {
+          "description": "截取字符数",
+          "name": "numChars"
+        }
+      ],
+      "returns": {
+        "description": "截取后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "LEFT(text, numChars)"
+      ]
+    },
+    "LEN": {
+      "category": "text",
+      "example": "LEN(#queId_101$)",
+      "meaning": "返回文本字符数。",
+      "parameters": [
+        {
+          "description": "待计算长度的值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "字符数；空文本返回 0",
+        "type": "number"
+      },
+      "signatures": [
+        "LEN(value)"
+      ]
+    },
+    "LN": {
+      "category": "number",
+      "example": "LN(#queId_101$)",
+      "meaning": "计算正数的自然对数。",
+      "parameters": [
+        {
+          "description": "大于 0 的数字",
+          "name": "number"
+        }
+      ],
+      "returns": {
+        "description": "自然对数；输入不大于 0 时返回 null",
+        "type": "number | null"
+      },
+      "signatures": [
+        "LN(number)"
+      ]
+    },
+    "LOWER": {
+      "category": "text",
+      "example": "LOWER(#queId_101$)",
+      "meaning": "将文本转换为小写。",
+      "parameters": [
+        {
+          "description": "待转换值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "小写文本",
+        "type": "string"
+      },
+      "signatures": [
+        "LOWER(value)"
+      ]
+    },
+    "MAX": {
+      "category": "number",
+      "example": "MAX(#queId_101$, #queId_102$)",
+      "meaning": "返回数字或日期参数中的最大值。",
+      "parameters": [
+        {
+          "description": "数字、日期或对应列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "最大数字或最晚日期",
+        "type": "number | string | null"
+      },
+      "signatures": [
+        "MAX(value1, value2, ...)"
+      ]
+    },
+    "MD5": {
+      "category": "utility",
+      "example": "MD5(#queId_101$, 32)",
+      "meaning": "计算文本的 MD5 摘要。",
+      "parameters": [
+        {
+          "description": "待摘要值",
+          "name": "value"
+        },
+        {
+          "description": "可选 16 或 32；其他值按 32 位处理",
+          "name": "length",
+          "optional": true
+        }
+      ],
+      "returns": {
+        "description": "16 位或 32 位小写十六进制摘要；空文本返回 null",
+        "type": "string | null"
+      },
+      "signatures": [
+        "MD5(value)",
+        "MD5(value, length)"
+      ]
+    },
+    "MID": {
+      "category": "text",
+      "example": "MID(#queId_101$, 2, 3)",
+      "meaning": "从文本的指定位置开始截取指定数量的字符，位置从 1 开始。",
+      "parameters": [
+        {
+          "description": "原文本",
+          "name": "text"
+        },
+        {
+          "description": "起始位置，从 1 开始",
+          "name": "startNum"
+        },
+        {
+          "description": "截取字符数",
+          "name": "numChars"
+        }
+      ],
+      "returns": {
+        "description": "截取后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "MID(text, startNum, numChars)"
+      ]
+    },
+    "MIN": {
+      "category": "number",
+      "example": "MIN(#queId_101$, #queId_102$)",
+      "meaning": "返回数字或日期参数中的最小值。",
+      "parameters": [
+        {
+          "description": "数字、日期或对应列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "最小数字或最早日期",
+        "type": "number | string | null"
+      },
+      "signatures": [
+        "MIN(value1, value2, ...)"
+      ]
+    },
+    "MINUTE": {
+      "category": "date",
+      "example": "MINUTE(#queId_101$)",
+      "meaning": "提取日期时间中的分钟。",
+      "parameters": [
+        {
+          "description": "日期时间",
+          "name": "date"
+        }
+      ],
+      "returns": {
+        "description": "分钟文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "MINUTE(date)"
+      ]
+    },
+    "MOD": {
+      "category": "number",
+      "example": "MOD(#queId_101$, 2)",
+      "meaning": "返回两数相除的整数余数。",
+      "parameters": [
+        {
+          "description": "被除数",
+          "name": "number"
+        },
+        {
+          "description": "除数",
+          "name": "divisor"
+        }
+      ],
+      "returns": {
+        "description": "余数；除数为 0 时返回 0",
+        "type": "integer | null"
+      },
+      "signatures": [
+        "MOD(number, divisor)"
+      ]
+    },
+    "MONTH": {
+      "category": "date",
+      "example": "MONTH(#queId_101$)",
+      "meaning": "提取日期或日期时间中的月份。",
+      "parameters": [
+        {
+          "description": "日期或日期时间",
+          "name": "date"
+        }
+      ],
+      "returns": {
+        "description": "1 至 12 的月份文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "MONTH(date)"
+      ]
+    },
+    "NETWORKDAYS": {
+      "category": "date",
+      "example": "NETWORKDAYS(#queId_101$, #queId_102$, \"1000001\", \"2026-10-01\")",
+      "meaning": "计算两个日期之间包含首尾日期的工作日数，可自定义休息日和假期。",
+      "parameters": [
+        {
+          "description": "开始日期",
+          "name": "startDate"
+        },
+        {
+          "description": "结束日期",
+          "name": "endDate"
+        },
+        {
+          "description": "可选 7 位 0/1 文本，从周日到周六，1 表示休息；省略时为 1000001",
+          "name": "weekend",
+          "optional": true
+        },
+        {
+          "description": "可选假期日期",
+          "name": "holidays",
+          "optional": true,
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "工作日数量文本；反向区间返回负数",
+        "type": "string | null"
+      },
+      "signatures": [
+        "NETWORKDAYS(startDate, endDate)",
+        "NETWORKDAYS(startDate, endDate, weekend, holiday1, holiday2, ...)"
+      ]
+    },
+    "NOT": {
+      "category": "logical",
+      "example": "NOT(ISEMPTY(#queId_101$))",
+      "meaning": "对布尔值取反。",
+      "parameters": [
+        {
+          "description": "布尔值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "输入值的逻辑反值",
+        "type": "boolean"
+      },
+      "signatures": [
+        "NOT(value)"
+      ]
+    },
+    "NOW": {
+      "category": "date",
+      "example": "NOW()",
+      "meaning": "取得公式执行时的当前日期时间。",
+      "parameters": [],
+      "returns": {
+        "description": "yyyy-MM-dd HH:mm:ss 格式的当前日期时间",
+        "type": "string"
+      },
+      "signatures": [
+        "NOW()"
+      ]
+    },
+    "NUM": {
+      "category": "text",
+      "example": "NUM(\"订单金额 12.50 元\")",
+      "meaning": "从每个文本值中提取首次出现的数字。",
+      "parameters": [
+        {
+          "description": "包含数字的文本或列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "单个输入返回首个数字，多个值返回数字列表，未找到时返回 null",
+        "type": "number | list | null"
+      },
+      "signatures": [
+        "NUM(value1, value2, ...)"
+      ]
+    },
+    "OR": {
+      "category": "logical",
+      "example": "OR(#queId_101$ == \"A\", #queId_101$ == \"B\")",
+      "meaning": "判断是否至少有一个条件为真。",
+      "parameters": [
+        {
+          "description": "一个或多个布尔条件",
+          "name": "conditions",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "至少一个为真时返回 TRUE，否则返回 FALSE",
+        "type": "boolean"
+      },
+      "signatures": [
+        "OR(condition1, condition2, ...)"
+      ]
+    },
+    "POWER": {
+      "category": "number",
+      "example": "POWER(#queId_101$, 2)",
+      "meaning": "计算指定数字的幂。",
+      "parameters": [
+        {
+          "description": "底数",
+          "name": "number"
+        },
+        {
+          "description": "指数，可为整数或小数",
+          "name": "power"
+        }
+      ],
+      "returns": {
+        "description": "幂运算结果的数字文本",
+        "type": "string"
+      },
+      "signatures": [
+        "POWER(number, power)"
+      ]
+    },
+    "PRODUCT": {
+      "category": "number",
+      "example": "PRODUCT(#queId_101$, #queId_102$)",
+      "meaning": "计算所有数字参数和列表元素的乘积。",
+      "parameters": [
+        {
+          "description": "数字、数字字段或数字列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "数值乘积；没有数值时返回 1",
+        "type": "number"
+      },
+      "signatures": [
+        "PRODUCT(value1, value2, ...)"
+      ]
+    },
+    "RDID": {
+      "category": "utility",
+      "example": "RDID()",
+      "meaning": "生成一个随机 UUID。",
+      "parameters": [],
+      "returns": {
+        "description": "UUID 文本",
+        "type": "string"
+      },
+      "signatures": [
+        "RDID()"
+      ]
+    },
+    "RECNO": {
+      "category": "context",
+      "example": "RECNO()",
+      "meaning": "取得当前表单被打开的次数。",
+      "parameters": [],
+      "returns": {
+        "description": "表单访问次数；无法取得时返回 0",
+        "type": "integer"
+      },
+      "signatures": [
+        "RECNO()"
+      ]
+    },
+    "REGTEST": {
+      "category": "utility",
+      "example": "REGTEST(#queId_101$, \"^[A-Z]+$\", \"i\")",
+      "meaning": "使用正则表达式测试文本或列表中是否有匹配项。",
+      "parameters": [
+        {
+          "description": "待测试文本或列表",
+          "name": "text"
+        },
+        {
+          "description": "正则表达式文本",
+          "name": "pattern"
+        },
+        {
+          "description": "正则标志，例如 i、m 或空字符串",
+          "name": "flags"
+        }
+      ],
+      "returns": {
+        "description": "任一值匹配时返回 TRUE",
+        "type": "boolean"
+      },
+      "signatures": [
+        "REGTEST(text, pattern, flags)"
+      ]
+    },
+    "REPLACE": {
+      "category": "text",
+      "example": "REPLACE(#queId_101$, 1, 2, \"新\")",
+      "meaning": "从指定位置替换指定数量的字符，位置从 1 开始。",
+      "parameters": [
+        {
+          "description": "原文本",
+          "name": "oldText"
+        },
+        {
+          "description": "替换起始位置，从 1 开始",
+          "name": "startNumber"
+        },
+        {
+          "description": "要替换的字符数",
+          "name": "numberChars"
+        },
+        {
+          "description": "替代文本",
+          "name": "newText"
+        }
+      ],
+      "returns": {
+        "description": "替换后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "REPLACE(oldText, startNumber, numberChars, newText)"
+      ]
+    },
+    "RIGHT": {
+      "category": "text",
+      "example": "RIGHT(#queId_101$, 4)",
+      "meaning": "从文本右侧截取指定数量的字符。",
+      "parameters": [
+        {
+          "description": "原文本",
+          "name": "text"
+        },
+        {
+          "description": "截取字符数",
+          "name": "numChars"
+        }
+      ],
+      "returns": {
+        "description": "截取后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "RIGHT(text, numChars)"
+      ]
+    },
+    "RMBUPPER": {
+      "category": "text",
+      "example": "RMBUPPER(#queId_101$)",
+      "meaning": "将数字转换为中文大写金额。",
+      "parameters": [
+        {
+          "description": "不超过 15 位的数字",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "中文大写金额；输入无效或过大时返回 null",
+        "type": "string | null"
+      },
+      "signatures": [
+        "RMBUPPER(value)"
+      ]
+    },
+    "ROUND": {
+      "category": "number",
+      "example": "ROUND(#queId_101$, 2)",
+      "meaning": "按四舍五入保留指定小数位。",
+      "parameters": [
+        {
+          "description": "数字",
+          "name": "value"
+        },
+        {
+          "description": "保留的小数位数",
+          "name": "numDigits"
+        }
+      ],
+      "returns": {
+        "description": "保留固定位数的数字文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "ROUND(value, numDigits)"
+      ]
+    },
+    "ROUNDDOWN": {
+      "category": "number",
+      "example": "ROUNDDOWN(#queId_101$, 2)",
+      "meaning": "向负无穷方向舍入并保留指定小数位。",
+      "parameters": [
+        {
+          "description": "数字",
+          "name": "value"
+        },
+        {
+          "description": "保留的小数位数",
+          "name": "numDigits"
+        }
+      ],
+      "returns": {
+        "description": "舍入后的数字文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "ROUNDDOWN(value, numDigits)"
+      ]
+    },
+    "ROUNDUP": {
+      "category": "number",
+      "example": "ROUNDUP(#queId_101$, 2)",
+      "meaning": "向正无穷方向舍入并保留指定小数位。",
+      "parameters": [
+        {
+          "description": "数字",
+          "name": "value"
+        },
+        {
+          "description": "保留的小数位数",
+          "name": "numDigits"
+        }
+      ],
+      "returns": {
+        "description": "舍入后的数字文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "ROUNDUP(value, numDigits)"
+      ]
+    },
+    "SEARCH": {
+      "category": "text",
+      "example": "SEARCH(\"-\", #queId_101$)",
+      "meaning": "查找文本首次出现的位置，位置从 1 开始。",
+      "parameters": [
+        {
+          "description": "要查找的文本",
+          "name": "searchText"
+        },
+        {
+          "description": "被查找的原文本",
+          "name": "targetText"
+        },
+        {
+          "description": "可选起始位置，从 1 开始",
+          "name": "beginPos",
+          "optional": true
+        }
+      ],
+      "returns": {
+        "description": "首次出现的位置；未找到返回 0",
+        "type": "integer"
+      },
+      "signatures": [
+        "SEARCH(searchText, targetText)",
+        "SEARCH(searchText, targetText, beginPos)"
+      ]
+    },
+    "SECOND": {
+      "category": "date",
+      "example": "SECOND(#queId_101$)",
+      "meaning": "提取日期时间中的秒。",
+      "parameters": [
+        {
+          "description": "日期时间",
+          "name": "date"
+        }
+      ],
+      "returns": {
+        "description": "秒文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "SECOND(date)"
+      ]
+    },
+    "SQRT": {
+      "category": "number",
+      "example": "SQRT(#queId_101$)",
+      "meaning": "计算非负数的平方根。",
+      "parameters": [
+        {
+          "description": "非负数字",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "平方根的数字文本；负数或 null 返回 null",
+        "type": "string | null"
+      },
+      "signatures": [
+        "SQRT(value)"
+      ]
+    },
+    "SUM": {
+      "category": "number",
+      "example": "SUM(#queId_101$, #queId_102$, 10)",
+      "meaning": "计算所有数字参数和列表元素的总和。",
+      "parameters": [
+        {
+          "description": "数字、数字字段或数字列表",
+          "name": "values",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "数值总和",
+        "type": "number"
+      },
+      "signatures": [
+        "SUM(value1, value2, ...)"
+      ]
+    },
+    "SUMIF": {
+      "category": "number",
+      "example": "SUMIF(#queId_101$, \"华东\", #queId_102$)",
+      "meaning": "对条件范围中等于指定值的对应数字求和。",
+      "parameters": [
+        {
+          "description": "用于逐项比较的列表",
+          "name": "base"
+        },
+        {
+          "description": "匹配值",
+          "name": "compare"
+        },
+        {
+          "description": "匹配后按相同索引求和的数字列表",
+          "name": "values"
+        }
+      ],
+      "returns": {
+        "description": "满足条件项对应数值的总和",
+        "type": "number"
+      },
+      "signatures": [
+        "SUMIF(base, compare, values)"
+      ]
+    },
+    "SUMPRODUCT": {
+      "category": "number",
+      "example": "SUMPRODUCT(#queId_101$, #queId_102$)",
+      "meaning": "将多个等序列按索引逐项相乘后求和，以最短序列长度为准。",
+      "parameters": [
+        {
+          "description": "两个或更多按行对齐的数字列表",
+          "name": "valueLists",
+          "variadic": true
+        }
+      ],
+      "returns": {
+        "description": "逐项乘积之和",
+        "type": "number"
+      },
+      "signatures": [
+        "SUMPRODUCT(values1, values2, ...)"
+      ]
+    },
+    "TEXT": {
+      "category": "text",
+      "example": "TEXT(#queId_101$, \"yyyy-MM-dd\")",
+      "meaning": "将日期或日期时间按指定格式转为文本，也支持 E、EE、EEE 星期格式。",
+      "parameters": [
+        {
+          "description": "日期、日期时间或可转换值",
+          "name": "value"
+        },
+        {
+          "description": "格式，例如 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、E、EE 或 EEE",
+          "name": "textFormat"
+        }
+      ],
+      "returns": {
+        "description": "格式化后的文本；无法解析日期时返回空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "TEXT(value, textFormat)"
+      ]
+    },
+    "TEXTDEPT": {
+      "category": "context",
+      "example": "TEXTDEPT(#queId_101$, \"name\")",
+      "meaning": "把部门字段中的部门 ID 转换为 ID 或部门名称，列表结果用逗号连接。",
+      "parameters": [
+        {
+          "description": "部门 ID 或其列表，通常来自部门字段",
+          "name": "departmentIds"
+        },
+        {
+          "description": "id 返回部门 ID，name 返回部门名称",
+          "name": "mode"
+        }
+      ],
+      "returns": {
+        "description": "转换后的部门 ID 或名称",
+        "type": "string | integer"
+      },
+      "signatures": [
+        "TEXTDEPT(departmentIds, mode)"
+      ]
+    },
+    "TEXTUSER": {
+      "category": "context",
+      "example": "TEXTUSER(#queId_101$, \"name\")",
+      "meaning": "把成员字段中的邮箱标识转换为邮箱或成员名称，列表结果用逗号连接。",
+      "parameters": [
+        {
+          "description": "成员邮箱标识或其列表，通常来自成员字段",
+          "name": "emails"
+        },
+        {
+          "description": "email 返回邮箱，name 返回名称",
+          "name": "mode"
+        }
+      ],
+      "returns": {
+        "description": "转换后的邮箱或名称文本",
+        "type": "string"
+      },
+      "signatures": [
+        "TEXTUSER(emails, mode)"
+      ]
+    },
+    "TIMESTAMPTODATE": {
+      "category": "date",
+      "example": "TIMESTAMPTODATE(1755648000000)",
+      "meaning": "将 10 位秒时间戳或 13 位毫秒时间戳转换为日期时间。",
+      "parameters": [
+        {
+          "description": "10 位或 13 位时间戳",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "yyyy-MM-dd HH:mm:ss 格式文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "TIMESTAMPTODATE(value)"
+      ]
+    },
+    "TRIPLEDES": {
+      "category": "utility",
+      "example": "TRIPLEDES(#queId_101$, \"123456789012345678901234\", NULL, \"ECB\", \"PKCS5PADDING\")",
+      "meaning": "使用 3DES 加密文本并返回 Base64 密文。",
+      "parameters": [
+        {
+          "description": "明文",
+          "name": "content"
+        },
+        {
+          "description": "长度至少 24 且为 8 的倍数的密钥",
+          "name": "secret"
+        },
+        {
+          "description": "8 字节向量；ECB 模式可传 NULL",
+          "name": "iv"
+        },
+        {
+          "description": "可选 ECB、CBC、CTR、OFB、CFB；省略时为 ECB",
+          "name": "mode",
+          "optional": true
+        },
+        {
+          "description": "可选 NOPADDING、PKCS5PADDING、ISO10126；省略时为 NOPADDING",
+          "name": "padding",
+          "optional": true
+        }
+      ],
+      "returns": {
+        "description": "Base64 编码的加密结果",
+        "type": "string"
+      },
+      "signatures": [
+        "TRIPLEDES(content, secret, iv)",
+        "TRIPLEDES(content, secret, iv, mode)",
+        "TRIPLEDES(content, secret, iv, mode, padding)"
+      ]
+    },
+    "UNICODEDECODE": {
+      "category": "utility",
+      "example": "UNICODEDECODE(#queId_101$)",
+      "meaning": "将文本中的四位十六进制 Unicode 转义序列解码为字符。",
+      "parameters": [
+        {
+          "description": "包含 \\uXXXX 序列的文本",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "解码后的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "UNICODEDECODE(value)"
+      ]
+    },
+    "UNICODEENCODE": {
+      "category": "utility",
+      "example": "UNICODEENCODE(#queId_101$)",
+      "meaning": "将每个字符编码为四位十六进制 Unicode 转义序列。",
+      "parameters": [
+        {
+          "description": "待编码值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "由 \\uXXXX 序列组成的文本",
+        "type": "string"
+      },
+      "signatures": [
+        "UNICODEENCODE(value)"
+      ]
+    },
+    "UPPER": {
+      "category": "text",
+      "example": "UPPER(#queId_101$)",
+      "meaning": "将文本转换为大写。",
+      "parameters": [
+        {
+          "description": "待转换值",
+          "name": "value"
+        }
+      ],
+      "returns": {
+        "description": "大写文本",
+        "type": "string"
+      },
+      "signatures": [
+        "UPPER(value)"
+      ]
+    },
+    "XOR": {
+      "category": "logical",
+      "example": "XOR(#queId_101$ > 0, #queId_102$ > 0)",
+      "meaning": "对两个布尔值执行异或。",
+      "parameters": [
+        {
+          "description": "第一个布尔值",
+          "name": "value1"
+        },
+        {
+          "description": "第二个布尔值",
+          "name": "value2"
+        }
+      ],
+      "returns": {
+        "description": "两个值不同时返回 TRUE，相同时返回 FALSE",
+        "type": "boolean"
+      },
+      "signatures": [
+        "XOR(value1, value2)"
+      ]
+    },
+    "YEAR": {
+      "category": "date",
+      "example": "YEAR(#queId_101$)",
+      "meaning": "提取日期或日期时间中的年份。",
+      "parameters": [
+        {
+          "description": "日期或日期时间",
+          "name": "date"
+        }
+      ],
+      "returns": {
+        "description": "四位年份文本",
+        "type": "string | null"
+      },
+      "signatures": [
+        "YEAR(date)"
+      ]
+    }
+  },
+  "x-qingflow-literals": [
+    {
+      "kind": "integer",
+      "meaning": "整数",
+      "syntax": "123"
+    },
+    {
+      "kind": "decimal",
+      "meaning": "小数",
+      "syntax": "12.50"
+    },
+    {
+      "kind": "string",
+      "meaning": "双引号字符串，支持常见反斜杠转义和 Unicode 转义",
+      "syntax": "\"文本\""
+    },
+    {
+      "kind": "boolean",
+      "meaning": "布尔值，也接受对应的小写形式",
+      "syntax": "TRUE | FALSE"
+    },
+    {
+      "kind": "null",
+      "meaning": "空值，也接受小写 null",
+      "syntax": "NULL"
+    },
+    {
+      "kind": "list",
+      "meaning": "表达式列表",
+      "syntax": "[expr1, expr2, ...]"
+    }
+  ],
+  "x-qingflow-operators": [
+    {
+      "example": "-#queId_101$",
+      "meaning": "数值取负",
+      "syntax": "-expr"
+    },
+    {
+      "example": "#queId_101$ * 2",
+      "meaning": "乘法",
+      "syntax": "expr * expr"
+    },
+    {
+      "example": "#queId_101$ / 100",
+      "meaning": "除法；除数为 0 时结果按后端公式引擎规则处理为 0",
+      "syntax": "expr / expr"
+    },
+    {
+      "example": "#queId_101$ + #queId_102$",
+      "meaning": "数值加法",
+      "syntax": "expr + expr"
+    },
+    {
+      "example": "#queId_101$ - #queId_102$",
+      "meaning": "数值减法",
+      "syntax": "expr - expr"
+    },
+    {
+      "example": "#queId_101$ >= 60",
+      "meaning": "相等、不等及大小比较，返回布尔值",
+      "syntax": "== | != | < | <= | > | >="
+    },
+    {
+      "example": "NOT #queId_101$",
+      "meaning": "逻辑非",
+      "syntax": "NOT expr"
+    },
+    {
+      "example": "#queId_101$ XOR #queId_102$",
+      "meaning": "逻辑异或",
+      "syntax": "expr XOR expr"
+    },
+    {
+      "example": "#queId_101$ > 0 and #queId_102$ > 0",
+      "meaning": "逻辑与",
+      "syntax": "expr and expr"
+    },
+    {
+      "example": "#queId_101$ > 0 or #queId_102$ > 0",
+      "meaning": "逻辑或",
+      "syntax": "expr or expr"
+    },
+    {
+      "example": "(#queId_101$ + #queId_102$) * 2",
+      "meaning": "显式控制计算优先级",
+      "syntax": "(expr)"
+    }
+  ],
+  "x-qingflow-usage": {
+    "appFormExample": {
+      "defaultType": 3,
+      "defaultValue": "CONCAT(\"文本字段：\", #queId_101$, \" / 数字字段：\", #queId_102$)",
+      "questionType": "text"
+    },
+    "notes": [
+      "不要把 #queId_<字段ID>$ 当作普通字符串加引号。",
+      "字段 name 仅用于 AppForm 声明中的字段定位，不能写入公式作为变量；例如 文本字段 和 \"文本字段\" 都不是字段引用。",
+      "\"测试文本\"、\"12.50\" 等带引号文本只是静态字面量，不会随对应字段值变化。",
+      "创建声明中没有已回读 queId 的字段不能作为动态公式引用；无法解析的 ID 会导致校验或绑定失败。",
+      "函数参数使用英文逗号或中文逗号分隔，括号支持半角或全角形式。"
+    ],
+    "steps": [
+      "先通过 app_form_get 获取已保存字段的 queId。",
+      "将公式字段的 defaultType 设置为 3。",
+      "将未编码的公式文本直接写入 defaultValue；builder 负责后端所需的编码处理。",
+      "字段引用必须使用 #queId_<字段ID>$，函数名使用大写形式，字符串使用双引号。",
+      "需要拼接字段当前值时，将该字段的实际 queId 写成未加引号的 #queId_<字段ID>$；字段 name、字段标题和字段默认值都不能替代字段引用。",
+      "新建应用的同一次 create 声明中尚未获得 queId 时，不得虚构 queId 或以字段 name 代替：先创建字段，app_form_get 回读实际 queId 后，再提交公式默认值更新。"
+    ]
+  }
+}