Document form selection-summary readOnly folding contract (revealInForm)

2026-09-03 14:50:29 +08:00
parent e7fa3c79b5
commit 3bebd6468f
11 changed files with 45 additions and 15 deletions
--- a/assets/schemas/skill-actions.schema.json
+++ b/assets/schemas/skill-actions.schema.json
@@ -110,7 +110,11 @@
        "sensitive": { "type": "boolean" },
        "readOnly": {
          "type": "boolean",
-          "description": "宿主数据管理表单只读展示该字段（仍会随提交传入 entrypoint）；用于行内/勾选预填的主键等"
+          "description": "只读。有「已选择」且字段来自 inputMapping（或约定 id 字段）时，宿主 form 默认不渲染该控件，预设值仍提交；无摘要时只读展示。勿用 visibleWhen 代替（visibleWhen 隐藏不提交）。"
+        },
+        "revealInForm": {
+          "type": "boolean",
+          "description": "可选逃生阀。true 时即使弹层有「已选择」摘要，也仍渲染该 readOnly 字段。不改变提交 payload。省略=映射只读字段在有摘要时默认折叠。"
        },
        "column": {
          "type": "string",