iter(g59): verify 检测 README 组件清单重复项

AGENTS.md

@@ -27,7 +27,7 @@
 - `apps/demo`（@ui-arch/demo）：交互演示，产物 apps/demo/dist/demo.html
 - `apps/docs`：文档站，纯产物（ua docs 生成）
 
-**门禁一条龙**：`npm run check` = build + demo + style + typecheck + smoke + index + verify，提交前必过。`ua verify` 校验清单 ↔ 文档 ↔ 演示一致（docs.components 的 id 必须在 api.exports 有对应条目、props 必须带 n/t/d、demo 锚点必须在 `apps/demo/main.ts` 中存在），检查皮肤包样式表无硬编码颜色（`#hex` 一律禁止，必须走 `--ua-*` 令牌）与令牌引用有效（`var(--ua-*)` 必须是 tokens.css 已定义或组件自设的变量），核对 README 的 `<!-- ua:components -->` 区块与「分组：」行都覆盖清单组件集合（漏写/多写都报错），并交叉校验 backlog 的 done 条目与 `.ua/iterations.log` 的 done 留痕一一对应。
+**门禁一条龙**：`npm run check` = build + demo + style + typecheck + smoke + index + verify，提交前必过。`ua verify` 校验清单 ↔ 文档 ↔ 演示一致（docs.components 的 id 必须在 api.exports 有对应条目、props 必须带 n/t/d、demo 锚点必须在 `apps/demo/main.ts` 中存在），检查皮肤包样式表无硬编码颜色（`#hex` 一律禁止，必须走 `--ua-*` 令牌）与令牌引用有效（`var(--ua-*)` 必须是 tokens.css 已定义或组件自设的变量），核对 README 的 `<!-- ua:components -->` 区块与「分组：」行都覆盖清单组件集合（漏写/多写/重复都报错），并交叉校验 backlog 的 done 条目与 `.ua/iterations.log` 的 done 留痕一一对应。
 
 **提交信息规范**：`COMMITTING.md`（`<type>(<scope>): <中文祈使句>`），`ua commit-lint` + commit-msg 钩子自动校验，迭代提交用 `iter(<条目id>): <subject>`。
 

packages/tools/cli/bin/ua.js

@@ -720,7 +720,10 @@ function checkReadme(pkgs) {
     issues.push('README.md 缺少组件区块标记（<!-- ua:components --> … <!-- /ua:components -->）');
     return issues;
   }
-  const listed = new Set(block[1].split('·').map((s) => s.trim()).filter(Boolean));
+  const blockIds = block[1].split('·').map((s) => s.trim()).filter(Boolean); // 保留原始顺序，供重复检测
+  const listed = new Set(blockIds);
+  const dupInBlock = blockIds.filter((id, i) => blockIds.indexOf(id) !== i); // 同一 id 出现多次：文档漂移
+  for (const id of new Set(dupInBlock)) issues.push(`README.md 组件区块重复列出 ${id}`);
   const actual = new Set(pkgs.flatMap((p) => (p.docs?.components ?? []).map((c) => c.id)));
   for (const id of actual) if (!listed.has(id)) issues.push(`README.md 组件区块缺少 ${id}`);
   for (const id of listed) if (!actual.has(id)) issues.push(`README.md 组件区块多出 ${id}（清单里没有）`);
@@ -732,7 +735,11 @@ function checkReadme(pkgs) {
   }
   const grouped = new Set(groupLine.match(/[a-zA-Z][A-Za-z0-9]*/g) ?? []);
   const alias = new Set(['formItem']); // formItem 与 form 共用一条文档，分组行里会单独出现
-  for (const id of actual) if (!grouped.has(id)) issues.push(`README.md 分组行缺少 ${id}`);
+  for (const id of actual) {
+    const hits = groupLine.match(new RegExp(`(?<![A-Za-z0-9])${id}(?![A-Za-z0-9])`, 'g')) ?? []; // 整词计数，避开 formItem 命中 form
+    if (!hits.length) issues.push(`README.md 分组行缺少 ${id}`);
+    else if (hits.length > 1) issues.push(`README.md 分组行重复列出 ${id}（${hits.length} 次）`);
+  }
   for (const id of grouped) if (!actual.has(id) && !alias.has(id)) issues.push(`README.md 分组行多出 ${id}（清单里没有）`);
   return issues;
 }