Release v1.0.120: document bind.visibleWhen for row menu visibility

assets/schemas/skill-actions.schema.json

@@ -90,6 +90,48 @@
     "scalarArg": {
       "type": ["string", "number", "boolean"]
     },
+    "visibleWhenRule": {
+      "description": "条件显隐规则。支持 {field,equals} / {field,in:[...]}，或单键简写 {status:\"approved\"} / {status:[\"a\",\"b\"]}。",
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["field", "equals"],
+          "additionalProperties": false,
+          "properties": {
+            "field": { "type": "string", "minLength": 1 },
+            "equals": { "type": ["string", "number", "boolean"] }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["field", "in"],
+          "additionalProperties": false,
+          "properties": {
+            "field": { "type": "string", "minLength": 1 },
+            "in": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "type": ["string", "number", "boolean"] }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "minProperties": 1,
+          "maxProperties": 1,
+          "additionalProperties": {
+            "oneOf": [
+              { "type": ["string", "number", "boolean"] },
+              {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": ["string", "number", "boolean"] }
+              }
+            ]
+          }
+        }
+      ]
+    },
     "inputProperty": {
       "type": "object",
       "required": ["type"],
@@ -142,46 +184,8 @@
           "description": "可选。Action 内联 Lookup：local_sql（同库表）/ skill_cli（兄弟技能 CLI JSON）/ external_api（预留）。打开表单时由宿主解析。推荐同时设 display_type=lookup。见 ACTIONS.md「跨表引用：Lookup」。"
         },
         "visibleWhen": {
-          "description": "可选。表单字段条件显隐。宿主在数据管理/定时任务参数表单中：规则不满足则隐藏该字段、提交时省略、且不校验 required。支持 {field,equals} / {field,in:[...]}，或单键简写 {collectMode:\"按关键词采集\"} / {collectMode:[\"a\",\"b\"]}。Agent/CLI 无 UI 时同样按当前 input 求值后剥离隐藏字段。",
-          "oneOf": [
-            {
-              "type": "object",
-              "required": ["field", "equals"],
-              "additionalProperties": false,
-              "properties": {
-                "field": { "type": "string", "minLength": 1 },
-                "equals": { "type": ["string", "number", "boolean"] }
-              }
-            },
-            {
-              "type": "object",
-              "required": ["field", "in"],
-              "additionalProperties": false,
-              "properties": {
-                "field": { "type": "string", "minLength": 1 },
-                "in": {
-                  "type": "array",
-                  "minItems": 1,
-                  "items": { "type": ["string", "number", "boolean"] }
-                }
-              }
-            },
-            {
-              "type": "object",
-              "minProperties": 1,
-              "maxProperties": 1,
-              "additionalProperties": {
-                "oneOf": [
-                  { "type": ["string", "number", "boolean"] },
-                  {
-                    "type": "array",
-                    "minItems": 1,
-                    "items": { "type": ["string", "number", "boolean"] }
-                  }
-                ]
-              }
-            }
-          ]
+          "description": "可选。表单字段条件显隐。宿主在数据管理/定时任务参数表单中：规则不满足则隐藏该字段、提交时省略、且不校验 required。Agent/CLI 无 UI 时同样按当前 input 求值后剥离隐藏字段。≠ bind.visibleWhen（行菜单），≠ Policy L3。",
+          "allOf": [{ "$ref": "#/$defs/visibleWhenRule" }]
         }
       }
     },
@@ -397,9 +401,13 @@
           "type": "string",
           "enum": ["required", "none", "optional"],
           "description": "可选。数据管理勾选如何驱动本 Action：required=必须有勾选（无勾选禁用）；none=忽略表勾选（不出现假「已选择」）；optional=有勾选走 $selection.ids，无勾选走 pickCount/maxLeads 等空选数量字段。省略时宿主推断：有 $selection.ids 或 batch → required，否则 → none。与 placements/executionProfile 正交。"
+        },
+        "visibleWhen": {
+          "description": "可选。placements 含 row 时：按当前行原始列值决定是否出现在行菜单/行按钮（宿主已支持）。形状同表单字段 visibleWhen。省略=始终显示。≠ inputSchema 字段 visibleWhen，≠ Policy L3 预留。见 ACTIONS.md「行菜单显隐」。",
+          "allOf": [{ "$ref": "#/$defs/visibleWhenRule" }]
         }
       },
-      "description": "表级绑定；toolbar 必填。可选 inputMapping / columnMapping / labelColumn / selectionMode。concurrency/locks 勿写入。"
+      "description": "表级绑定；toolbar 必填。可选 inputMapping / columnMapping / labelColumn / selectionMode / visibleWhen。concurrency/locks 勿写入。"
     },
     "hostEffectId": {
       "type": "string",