iter(g288): 文档步骤下限提到 4 条

packages/skin/ui/ua.manifest.json

@@ -922,7 +922,8 @@
         "steps": [
           "纯状态文案直接传 label，配 variant 定语义色",
           "要显示数量传 count（如未读数），超过 max（缺省 99）自动渲染成 99+",
-          "只提示「有更新」用 dot: true，配合 label 给出读屏名（如「有未读消息」）"
+          "只提示「有更新」用 dot: true，配合 label 给出读屏名（如「有未读消息」）",
+          "不要给 badge 挂点击：它不是按钮（无 tabindex 也无键盘响应）；「点角标进消息中心」应当把 badge 塞进 button 里，让按钮承担语义"
         ]
       },
       {
@@ -1529,7 +1530,8 @@
         "steps": [
           "在区块之间插入 divider 划分内容层次",
           "传 label 在水平线上显示居中文案，如「更多信息」",
-          "工具栏内用 vertical: true 的行内竖线，dashed: true 切虚线弱化分隔感"
+          "工具栏内用 vertical: true 的行内竖线，dashed: true 切虚线弱化分隔感",
+          "分割线是纯视觉件：没有 role 也没有焦点，读屏不会播报它。真要让读屏理解分组，用 heading 或 section，别指望横线"
         ]
       },
       {
@@ -3910,7 +3912,8 @@
         "steps": [
           "传字符串展示单键帽：kbd({ keys: \"Esc\" })，适合文档里说明单个按键",
           "传数组展示组合键：kbd({ keys: [\"Ctrl\", \"K\"] })，键帽之间以弱化的 + 连接（+ 对读屏隐藏）",
-          "常与提示文案混排：行内 baseline 对齐，键帽底边加厚一线出立体感"
+          "常与提示文案混排：行内 baseline 对齐，键帽底边加厚一线出立体感",
+          "组件只画键帽，不做平台映射：Ctrl 与 ⌘ 的替换由调用方按平台判断后传进来（写死 Ctrl 在 Mac 上就是错的）"
         ]
       },
       {
@@ -3935,7 +3938,8 @@
         "steps": [
           "传 text + keyword 即可，命中片段以淡黄 mark 底展示，适合搜索结果 / 补全列表的匹配说明",
           "两个入参都接受信号：搜索框输入实时联动高亮，无需手动重渲染",
-          "大小写不敏感且全部命中（非只第一处）；关键词两侧空白自动忽略"
+          "大小写不敏感且全部命中（非只第一处）；关键词两侧空白自动忽略",
+          "keyword 为空或纯空白时原样返回文本，既不抛错也不全高亮：搜索框清空那一刻不用特判"
         ]
       },
       {

packages/tools/cli/bin/ua.js

@@ -1591,7 +1591,7 @@ function cmdVerify() {
       if (seen.has(c.id)) issues.push(`${tag}: id 重复`);
       seen.add(c.id);
       if (!c.example) issues.push(`${tag}: 缺少 example`);
-      if ((c.steps ?? []).length < 3) issues.push(`${tag}: steps 少于 3 条`);
+      if ((c.steps ?? []).length < 4) issues.push(`${tag}: steps 少于 4 条（每件至少给 4 步：怎么传 / 怎么联动 / 边界行为 / 什么时候别用它）`);
       if (!exports.some((e) => e.startsWith(`${c.id}(`) || e.startsWith(`${c.id}.`))) {
         issues.push(`${tag}: api.exports 中没有以「${c.id}(」或「${c.id}.」开头的条目`);
       }