# 任务书 D0:儿童界面硬规则检查脚本 - 类型:工程(单人,不比赛) - ROADMAP:D0 | 版本:v1.0(2026-10-02) - 产出:`tools/check_child_ui.mjs` + `tools/README-check-child-ui.md`;运行报告写到 `bookshelf/tasks/child-ui-check.md` ## 1. 目标 把 `docs/child-ui-rules.md` 中可以机器检查的规则 R1—R5 写成脚本。原型(D1 各参赛版本)和正式实现每次交付前都跑一遍,违规就不能交给家长或验收。 ## 2. 输入 - `docs/child-ui-rules.md`(规则和标注约定:`data-primary`、`data-voice`、`data-content`) - 被检页面:一组 URL,或「原型目录 + 直达屏幕列表」(D1 原型支持 `index.html?day=1#today`、`#pu/0` 这类直达地址,见各参赛版本 README) ## 3. 要求 1. Node + Playwright(Chromium 或本机 Edge:`channel: 'msedge'`),视口默认 1180×820,可选 820×1180。 2. 用法:`node tools/check_child_ui.mjs --base http://127.0.0.1/estudy-proto/ --screens screens.txt [--out bookshelf/tasks/child-ui-check.md]`;`screens.txt` 每行一个相对地址。也支持 `--url` 直接给单个地址。 3. 每屏等待 1.5 秒(语音和动画)后检查: | 规则 | 检查 | |---|---| | R1 | `[data-primary]` 可见元素恰好 1 个;可见可点击元素(`button, a, [role=button], [onclick]`,排除 `[data-content]` 内部、排除 aria-label 为「返回」「重听」的元素)≤ 3 个(主操作 + 2) | | R2 | 可见文本中 CJK 字符数 ≤ 12(排除 `[data-content]` 内部、`.parent` 家长端、`aria-hidden`);每个按钮的可见汉字 ≤ 4 | | R3 | 屏幕根元素 `[data-screen]` 有非空 `data-voice`(进入语音) | | R4 | 可见文本不含黑名单词:Quiz, Learn, SRS, 掌握, 待检查, 校对, 节奏, 正确率, 设置, 统计, %(黑名单写在脚本顶部数组,可扩展) | | R5 | 每个可见可点击元素的包围盒 ≥ 64×64;相邻可点击元素间距 ≥ 16(报告最近的一对) | 4. 每屏输出:通过 / 违规列表(规则、元素选择器、实际值)+ 截图路径(`bookshelf/tasks/child-ui-check/<屏>.png`)。 5. 有任何违规时退出码为 1。 6. 家长端(`.parent` 内)不检查。 ## 4. 验收 - 对 `tasks/pipeline/v1-two-cards/prototype/` 跑全部直达屏幕,生成报告;故意改坏一处(例如加一行长中文)能被检出。 - README 写明安装(`npm i -D playwright` 或复用已有)、用法、如何新增规则。 ## 5. 不要做 不改 `docs/child-ui-rules.md` 的规则内容(发现规则本身不可检查或不合理,写进 README「对规则的意见」);不改被检页面。