From cf251640b3967ef2bd4a5526e513215356c50f53 Mon Sep 17 00:00:00 2001 From: HIsheR Date: Mon, 26 Oct 2026 11:52:25 +0800 Subject: [PATCH] =?UTF-8?q?iter(g41):=20verify=20=E6=A0=A1=E9=AA=8C=20READ?= =?UTF-8?q?ME=20=E5=88=86=E7=BB=84=E8=A1=8C=E4=B8=8E=E6=B8=85=E5=8D=95?= =?UTF-8?q?=E4=B8=80=E8=87=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .ua/backlog.json | 8 ++++++++ AGENTS.md | 2 +- packages/tools/cli/bin/ua.js | 12 +++++++++++- 3 files changed, 20 insertions(+), 2 deletions(-) diff --git a/.ua/backlog.json b/.ua/backlog.json index 21086d6..ad98e21 100644 --- a/.ua/backlog.json +++ b/.ua/backlog.json @@ -684,6 +684,14 @@ "acceptance": "ButtonProps 增 type（缺省 button）；form 内提交按钮用 submit、重置用 button；单行输入框 Enter 等同提交且 textarea 不受影响；文档同步；npm run check 全绿", "status": "done", "notes": "自补：缺陷修复；textarea 保留换行语义" + }, + { + "id": "g41", + "title": "verify 校验 README 分组行", + "motivation": "README「分组：」行是第二份组件清单，新增组件只改 ua:components 区块时分组行会静默过期（本轮之前已漏 6 个组件）", + "acceptance": "verify 解析分组行并比对清单集合，漏写/多写均报错（formItem 作为别名放行）；负向删除 tree 即失败；npm run check 全绿", + "status": "open", + "notes": "自补：构建/门禁工具链改进" } ] } diff --git a/AGENTS.md b/AGENTS.md index 1824e56..f95ed6d 100644 --- a/AGENTS.md +++ b/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 的 `` 区块与清单组件集合完全一致，并交叉校验 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 的 `` 区块与「分组：」行都覆盖清单组件集合（漏写/多写都报错），并交叉校验 backlog 的 done 条目与 `.ua/iterations.log` 的 done 留痕一一对应。 **提交信息规范**：`COMMITTING.md`（`(): <中文祈使句>`），`ua commit-lint` + commit-msg 钩子自动校验，迭代提交用 `iter(<条目id>): `。 diff --git a/packages/tools/cli/bin/ua.js b/packages/tools/cli/bin/ua.js index 3e8119d..d3ca7dd 100644 --- a/packages/tools/cli/bin/ua.js +++ b/packages/tools/cli/bin/ua.js @@ -709,6 +709,16 @@ function checkReadme(pkgs) { 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}（清单里没有）`); + // 分组行同一份清单的另一种表述：漏写/多写同样算文档漂移 + const groupLine = fs.readFileSync(file, 'utf8').split(/\r?\n/).find((line) => line.startsWith('分组：')); + if (!groupLine) { + issues.push('README.md 缺少「分组：」行（组件分类导航）'); + return issues; + } + 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 grouped) if (!actual.has(id) && !alias.has(id)) issues.push(`README.md 分组行多出 ${id}（清单里没有）`); return issues; } @@ -871,7 +881,7 @@ function cmdVerify() { console.error(`${issues.length} violation(s)`); process.exit(1); } - console.log('verify OK (manifest ↔ docs ↔ demo 一致，皮肤无硬编码颜色与未定义令牌，README 组件清单同步，backlog ↔ 留痕一致)'); + console.log('verify OK (manifest ↔ docs ↔ demo 一致，皮肤无硬编码颜色与未定义令牌，README 组件清单与分组同步，backlog ↔ 留痕一致)'); } /*** 校验 git 提交信息是否符合 COMMITTING.md 规范（参数为 message 文件路径或直接 message 文本），违规退出码 1 ***/