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

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 (39) hide show
  1. package/README.md +3 -3
  2. package/package.json +1 -1
  3. package/pyproject.toml +1 -1
  4. package/skills/qingflow-cli/SKILL.md +37 -0
  5. package/skills/qingflow-cli/reference/builder/50-views.md +12 -0
  6. package/skills/qingflow-cli/reference/builder/80-buttons-associated-resources.md +2 -0
  7. package/src/qingflow_mcp/app_form_validator.py +53 -14
  8. package/src/qingflow_mcp/builder_facade/app_form.py +152 -47
  9. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json +3 -3
  10. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/address.json +1 -1
  11. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json +1 -1
  12. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/attachment.json +1 -1
  13. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/code_block.json +3 -3
  14. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/data_relation.json +3 -3
  15. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date.json +1 -1
  16. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/datetime.json +1 -1
  17. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/department.json +3 -3
  18. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/email.json +1 -1
  19. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/link.json +1 -1
  20. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/long_text.json +1 -1
  21. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/member.json +3 -3
  22. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/multi_select.json +1 -1
  23. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json +1 -1
  24. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/phone.json +1 -1
  25. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/q_linker.json +3 -3
  26. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/relation.json +3 -3
  27. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json +1 -1
  28. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_choice.json +1 -1
  29. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_select.json +1 -1
  30. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json +3 -3
  31. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.json +1 -1
  32. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/formula.json +35 -0
  33. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json +2 -2
  34. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json +1 -1
  35. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/button-config.json +3 -3
  36. package/src/qingflow_mcp/builder_facade/service.py +170 -88
  37. package/src/qingflow_mcp/cli/commands/builder.py +4 -2
  38. package/src/qingflow_mcp/server_app_builder.py +2 -2
  39. package/src/qingflow_mcp/tools/ai_builder_tools.py +7 -5
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json CHANGED
@@ -1275,7 +1275,7 @@
1275
1275
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
1276
1276
  },
1277
1277
  "name": {
1278
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
1278
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
1279
1279
  "minLength": 1,
1280
1280
  "type": "string"
1281
1281
  },
@@ -1337,10 +1337,10 @@
1337
1337
  ]
1338
1338
  }
1339
1339
  ],
1340
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
1340
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
1341
1341
  "properties": {
1342
1342
  "name": {
1343
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
1343
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
1344
1344
  "minLength": 1,
1345
1345
  "type": "string"
1346
1346
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/address.json CHANGED
@@ -301,7 +301,7 @@
301
301
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
302
302
  },
303
303
  "name": {
304
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
304
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
305
305
  "minLength": 1,
306
306
  "type": "string"
307
307
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/attachment.json CHANGED
@@ -334,7 +334,7 @@
334
334
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
335
335
  },
336
336
  "name": {
337
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
337
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
338
338
  "minLength": 1,
339
339
  "type": "string"
340
340
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/code_block.json CHANGED
@@ -221,7 +221,7 @@
221
221
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
222
222
  },
223
223
  "name": {
224
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
224
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
225
225
  "minLength": 1,
226
226
  "type": "string"
227
227
  },
@@ -264,10 +264,10 @@
264
264
  ]
265
265
  }
266
266
  ],
267
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
267
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
268
268
  "properties": {
269
269
  "name": {
270
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
270
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
271
271
  "minLength": 1,
272
272
  "type": "string"
273
273
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/data_relation.json CHANGED
@@ -480,7 +480,7 @@
480
480
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
481
481
  },
482
482
  "name": {
483
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
483
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
484
484
  "minLength": 1,
485
485
  "type": "string"
486
486
  },
@@ -523,10 +523,10 @@
523
523
  ]
524
524
  }
525
525
  ],
526
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
526
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
527
527
  "properties": {
528
528
  "name": {
529
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
529
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
530
530
  "minLength": 1,
531
531
  "type": "string"
532
532
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date.json CHANGED
@@ -83,7 +83,7 @@
83
83
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
84
84
  },
85
85
  "name": {
86
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
86
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
87
87
  "minLength": 1,
88
88
  "type": "string"
89
89
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/datetime.json CHANGED
@@ -83,7 +83,7 @@
83
83
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
84
84
  },
85
85
  "name": {
86
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
86
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
87
87
  "minLength": 1,
88
88
  "type": "string"
89
89
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/department.json CHANGED
@@ -201,7 +201,7 @@
201
201
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
202
202
  },
203
203
  "name": {
204
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
204
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
205
205
  "minLength": 1,
206
206
  "type": "string"
207
207
  },
@@ -244,10 +244,10 @@
244
244
  ]
245
245
  }
246
246
  ],
247
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
247
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
248
248
  "properties": {
249
249
  "name": {
250
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
250
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
251
251
  "minLength": 1,
252
252
  "type": "string"
253
253
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/email.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/link.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/long_text.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/member.json CHANGED
@@ -150,7 +150,7 @@
150
150
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
151
151
  },
152
152
  "name": {
153
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
153
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
154
154
  "minLength": 1,
155
155
  "type": "string"
156
156
  },
@@ -193,10 +193,10 @@
193
193
  ]
194
194
  }
195
195
  ],
196
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
196
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
197
197
  "properties": {
198
198
  "name": {
199
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
199
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
200
200
  "minLength": 1,
201
201
  "type": "string"
202
202
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/multi_select.json CHANGED
@@ -146,7 +146,7 @@
146
146
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
147
147
  },
148
148
  "name": {
149
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
149
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
150
150
  "minLength": 1,
151
151
  "type": "string"
152
152
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/phone.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/q_linker.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
@@ -121,10 +121,10 @@
121
121
  ]
122
122
  }
123
123
  ],
124
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
124
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
125
125
  "properties": {
126
126
  "name": {
127
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
127
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
128
128
  "minLength": 1,
129
129
  "type": "string"
130
130
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/relation.json CHANGED
@@ -258,7 +258,7 @@
258
258
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
259
259
  },
260
260
  "name": {
261
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
261
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
262
262
  "minLength": 1,
263
263
  "type": "string"
264
264
  },
@@ -301,10 +301,10 @@
301
301
  ]
302
302
  }
303
303
  ],
304
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
304
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
305
305
  "properties": {
306
306
  "name": {
307
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
307
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
308
308
  "minLength": 1,
309
309
  "type": "string"
310
310
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json CHANGED
@@ -83,7 +83,7 @@
83
83
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
84
84
  },
85
85
  "name": {
86
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
86
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
87
87
  "minLength": 1,
88
88
  "type": "string"
89
89
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_choice.json CHANGED
@@ -146,7 +146,7 @@
146
146
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
147
147
  },
148
148
  "name": {
149
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
149
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
150
150
  "minLength": 1,
151
151
  "type": "string"
152
152
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_select.json CHANGED
@@ -146,7 +146,7 @@
146
146
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
147
147
  },
148
148
  "name": {
149
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
149
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
150
150
  "minLength": 1,
151
151
  "type": "string"
152
152
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json CHANGED
@@ -986,7 +986,7 @@
986
986
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
987
987
  },
988
988
  "name": {
989
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
989
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
990
990
  "minLength": 1,
991
991
  "type": "string"
992
992
  },
@@ -1029,10 +1029,10 @@
1029
1029
  ]
1030
1030
  }
1031
1031
  ],
1032
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
1032
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
1033
1033
  "properties": {
1034
1034
  "name": {
1035
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
1035
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
1036
1036
  "minLength": 1,
1037
1037
  "type": "string"
1038
1038
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.json CHANGED
@@ -78,7 +78,7 @@
78
78
  "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
79
79
  },
80
80
  "name": {
81
- "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
81
+ "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
82
82
  "minLength": 1,
83
83
  "type": "string"
84
84
  },
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/formula.json CHANGED
@@ -236,6 +236,28 @@
236
236
  "DATEDELTA(date, number, unit)"
237
237
  ]
238
238
  },
239
+ "DATEDIF": {
240
+ "category": "date",
241
+ "example": "DATEDIF(#queId_102$, #queId_101$)",
242
+ "meaning": "历史日期差函数名，仅存在于存量公式中（当前公式引擎未注册，日期差请使用 DAYS(end, start)）。为使存量声明的 validate/round-trip 通过而保留声明，不建议新公式使用。",
243
+ "parameters": [
244
+ {
245
+ "description": "结束日期或列表",
246
+ "name": "end"
247
+ },
248
+ {
249
+ "description": "开始日期或列表",
250
+ "name": "start"
251
+ }
252
+ ],
253
+ "returns": {
254
+ "description": "天数差文本列表",
255
+ "type": "list"
256
+ },
257
+ "signatures": [
258
+ "DATEDIF(end, start)"
259
+ ]
260
+ },
239
261
  "DATETOTIMESTAMP": {
240
262
  "category": "date",
241
263
  "example": "DATETOTIMESTAMP(#queId_101$)",
@@ -363,6 +385,19 @@
363
385
  "GETUSEREMAIL()"
364
386
  ]
365
387
  },
388
+ "GETUSERENAME": {
389
+ "category": "context",
390
+ "example": "GETUSERENAME()",
391
+ "meaning": "历史拼写（GETUSERNAME 的讹写），仅存在于存量公式中（当前公式引擎未注册，请使用 GETUSERNAME()）。为使存量声明的 validate/round-trip 通过而保留声明，不建议新公式使用。",
392
+ "parameters": [],
393
+ "returns": {
394
+ "description": "当前用户显示名称；无法取得时为空字符串",
395
+ "type": "string"
396
+ },
397
+ "signatures": [
398
+ "GETUSERENAME()"
399
+ ]
400
+ },
366
401
  "GETUSERNAME": {
367
402
  "category": "context",
368
403
  "example": "GETUSERNAME()",
package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json CHANGED
@@ -136,10 +136,10 @@
136
136
  ]
137
137
  }
138
138
  ],
139
- "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
139
+ "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
140
140
  "properties": {
141
141
  "name": {
142
- "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
142
+ "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
143
143
  "minLength": 1,
144
144
  "type": "string"
145
145
  },
package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json CHANGED
@@ -727,7 +727,7 @@
727
727
  },
728
728
  "button_id": {
729
729
  "type": "integer",
730
- "buttonIdDescription": "按钮 id。别名 buttonId/id。",
730
+ "buttonIdDescription": "按钮 id(创建前先 app_get_buttons 传 button_text 查重,唯一命中直接复用本 id;未命中才用 app_custom_buttons_apply 创建)。别名 buttonId/id。",
731
731
  "x-backend": "button_config.id / custom_button_id"
732
732
  },
733
733
  "button_text": {
package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/button-config.json CHANGED
@@ -42,9 +42,9 @@
42
42
  "buttons": "引用应用中已存在的自定义按钮，只维护视图绑定、位置、主次和显隐条件。"
43
43
  },
44
44
  "x-qingflow-custom-button-workflow": {
45
- "query": "先使用 app_get 获取应用中已有自定义按钮及 button_id。",
46
- "createOrUpdate": "需要维护按钮主体、样式、跨视图复用或 qRobot/wings 细节时使用 app_custom_buttons_apply。",
47
- "viewBinding": "普通业务动作优先声明 action_buttons；已有自定义按钮使用 buttons 绑定。"
45
+ "query": "创建前先用 app_get_buttons 传 button_text 按文案精确查重(CLI: builder button get --app-key APP --button-text 文案);唯一命中直接复用其 button_id,同名多条用 button_id 精确指定。",
46
+ "createOrUpdate": "未命中再用 app_custom_buttons_apply 创建;它自身也按 button_text 去重(无 button_id 时唯一同名匹配转为更新),不要重复创建同名按钮。需要维护按钮主体、样式、跨视图复用或 qRobot/wings 细节时同样使用 app_custom_buttons_apply。",
47
+ "viewBinding": "普通业务动作优先声明 action_buttons;已有自定义按钮使用 buttons 绑定(button_id 来自查询结果)。"
48
48
  },
49
49
  "examples": [
50
50
  { "action_buttons": [{ "text": "新增", "action": "add_data", "placement": "header", "primary": true }], "action_buttons_mode": "merge" },