# 任务书 D1:V1「两件事」屏幕清单 + iPad 可操作原型 - 类型:**竞赛**(多个 agent 各做一版,按 `RUBRIC.md` 对比) - ROADMAP:D1 | 版本:v1.0(2026-10-02 冻结) - 产出位置:`tasks/briefs/D1-v1-two-cards-prototype/entries/<你的 agent 名>/` - 采用版位置(评审后):`tasks/pipeline/v1-two-cards/` --- ## 1. 目标 做一个**给 6 岁孩子在 iPad 上真实试用 2 天**的可操作原型,用来在写正式代码之前验证:孩子能不能自己用起来、愿不愿意用、能不能学会。原型不接后端,不进入正式代码;评审选定后,它就是正式开发的**界面规格**。 一句话产品:每天给孩子排好「两件事」——① Power Up 课程主线,② 牛津树绘本精读。孩子在 iPad 上自己完成并留下录音和答题结果;家长晚上用 5—10 分钟检查。 ## 2. 必读输入 | 文件 | 读什么 | |---|---| | `easy-study-analysis/00_思路梳理/v3-claude/产品需求定稿-v1.1.md` | 全文。重点:§1.1 用户、§1.4 产品原则、§2 一天和一周、§3.2 学习日步骤、§4 精读、§5 激励与家长端、§8 验收场景 | | `docs/child-ui-rules.md` | 儿童界面硬规则 R1—R11(**必须遵守**) | | `easy-study-analysis/00_思路梳理/v3-claude/研发流程-v0.2.md` | §2.3 屏幕清单格式、§2.5 原型自带的两个工具 | | `tasks/pipeline/challenges.md` | C001—C004:家长以前指出过的问题,不要再犯 | **第 1 轮禁读**(保证各版独立):`tasks/pipeline/v1-two-cards/`、`tasks/briefs/D1-v1-two-cards-prototype/entries/` 下其他 agent 的目录、`tasks/pipeline/daily-plan-engine/prototype/`。 可以参考现有正式代码的做法(不是必须复用):`bookshelf/frontend/src/pages/child/`(阅读器 `ChildBookReader.tsx`、查词 `WordDictPanel.tsx`、拼字 `SpellingGame.tsx`)。 ## 3. 用户(摘要,详见需求定稿) - 孩子:6 岁女孩,一年级,**识字少、读不了中文长句**,只会听和点,不会打字。喜欢牛津树、手工、动画;有好胜心,但多次没进步会沮丧。能自己开 iPad 进 App。放学后家里只有老人,老人不能辅导学习。 - 家长:每 1—3 天集中检查,目标每次 ≤ 15 分钟;晚上用「今晚亲子卡」和孩子互动 5—10 分钟。 ## 4. 试用内容(已确定,直接使用) | 试用日 | 卡 ① Power Up | 卡 ② 绘本精读 | |---|---|---| | 第 1 天 | **新课日**:课本 p20—21。重点词 **he / she / eggs**,句型 **Who is she? — She's …**。步骤:预告重点 → AJ 课本讲解视频(完整播放)→ 官方动画 → 「找回来」练习 → 用句型录一句 | *Nobody Wanted to Play* | | 第 2 天 | **练习日**:AJ 练习册讲解视频(完整播放)→ 纸质练习册 p20—21 → 重点词各抄写 4 遍(纸上)→ 录读句子 | *By the Stream* | 精读步骤(两天相同):不听音频自己读一遍(录音)→ 卡住的词点开求助(发音 + 中文 + 图)→ 听原音 → 回答 2 个理解小问题 → 再读一遍(录音)→ 两次录音对比。 **家长已定的规则**:讲解视频**完整播放、不切分**(课程完整性优先,约 30—35 分钟可以接受);休息提示**不打断视频**,视频播完再弹;完成一张核心卡得一张单词卡;纸面任务由家长晚上在亲子卡里核对,不拍照上传。 ### 4.1 资源地址(同源,经 nginx) | 资源 | URL | |---|---| | 绘本页图片 | `/estudy/images/stage-03/<书>/NNN.png`(三位数,`000` 是封面) | | 绘本整本音频 | `/estudy/audio/books/stage-03/<书>.mp3` | | AJ 课本讲解(p18—21,34:48) | `/video/PU-AJ/PowerUp1/10--p18.mp4` | | AJ 练习册讲解(AB p19—23,31:04) | `/video/PU-AJ/PowerUp1/12--p23 AB 19-23.mp4` | | 官方动画(p20,2:10) | `/pu/2_PowerUp1/1级视频录播/PU1视频/Unit 2/P20-U2-1.24.mp4`(需要 nginx `/pu/` → `E:/BaiduNetdiskDownload/PowerUp/`) | | 课本音轨 | `/pu/2_PowerUp1/Student's Book Class Audio Level 1/PEC L1 Power Up CD1 Track 23.mp3`~`25` | 资源地址要能在家长端修改(部署环境可能不同)。 ### 4.2 绘本文字(按原书图片人工转写;现有 OCR 数据漏句,不要用) *Nobody Wanted to Play*(`NobodyWantedToPlay`,图片序号 → 文字): 002 Wilf was cross. | 003 Nobody wanted to play. | 004 He went to the park. | 005 Wilf played on the rocket. | 006 "I am a spaceman," he said. | 007 He played on the see-saw. | 008 "I am a juggler," he said. | 009 He played on the horse. | 010 "I am a cowboy," he said. | 011 He played on his bicycle. | 012 "I am a stuntman," he said. | 013 He climbed up the ladder. | 014 "I am a fireman," he said. | 015 He climbed on the wall. | 016 "I am a spiderman," he said. | 017 Whoops! (000 封面;001、018、019 是教师说明和封底,不展示) *By the Stream*(`ByTheStream`): 002 Mum and Dad sat on the rug. | 003 The children played by the stream. | 004 Biff went on the bridge. | 005 They dropped sticks in the water. | 006 Kipper couldn't see. | 007 Kipper climbed up. | 008 He dropped Teddy in the water. | 009 "Get Teddy," said Kipper. | 010 Biff couldn't get Teddy. | 011 "Get Teddy," said Kipper. | 012 Mum couldn't get Teddy. | 013 "I want Teddy," said Kipper. | 014 Dad couldn't get Teddy. | 015 Dad fell in. | 016 Splash! | 017 "I am a frogman," said Dad. (000 封面;001 教师说明) ## 5. 产出(放在你的 entries 目录) | 文件 | 要求 | |---|---| | `screens.md` | **一页屏幕清单**(格式见研发流程 §2.3):每个孩子端屏幕一行——唯一主操作、进入语音(≤ 5 秒)、可见汉字(≤ 12 个)、其他元素及保留理由。另列:家长端屏幕、出错处理、要在试用中验证的假设(每条写通过标准和数据来源) | | `prototype/index.html` 及其他静态文件 | 纯静态 HTML/CSS/JS,**无构建步骤、无外部依赖**,部署到 nginx `/estudy-proto/` 即可在 iPad Safari 运行 | | `prototype/README.md` | 部署方法(nginx 片段)、家长端入口、如何切换第 1/2 天、如何直达某一屏 | | `NOTES.md` | 设计取舍、没做的部分、对任务书的意见、自检结果(第 7 节逐条打勾)、大约用时 | ## 6. 功能要求 ### 6.1 孩子端(必须) 1. 两张核心卡的「今天」页;完成后有明确的「今天完成」。 2. 第 1 天、第 2 天两套流程(第 4 节),每一步可以真实操作:视频能播、录音能录能回放、题能答、页能翻、词能查。 3. 「找回来」练习**不能对着屏幕找到答案**(R6)。至少包含听音选、看词选、拼词三种之一以上的形式,由你设计。 4. 录音:MediaRecorder,存 IndexedDB;没有麦克风权限或 http 环境时给出可跳过的出错处理(R10)。 5. 中途退出再进来,回到原来那一步;视频记住播放位置。 6. 休息提示:连续使用约 20 分钟(可配置)在步骤之间弹出,不打断视频;看完 ≥ 30 分钟视频后一定弹;休息时有声音提示(老人能听到),倒计时结束后孩子自己回来。 7. 单词卡:完成核心卡得一张;可以查看收集的卡。 8. 每屏进入时自动播放语音说明,有重听按钮(语音可用 speechSynthesis)。 ### 6.2 家长端(必须) 1. 入口有成人门禁(孩子不容易误入),不在孩子屏上出现文字入口。 2. **今晚亲子卡**:问题、听读句子、当天卡点(来自孩子求助 / 跳过)、练习册核对、口头听写勾选、检查计时(目标 ≤ 15 分钟)。 3. **今天记录**:每一步用时、答题结果、录音回放和下载、求助记录。 4. **试用工具**:批注模式(打开后在孩子端点任意元素写意见,记录屏幕和元素位置)、每日观察表、导出 JSON(试用记录 + 批注 + 观察表 + 亲子卡)、清空重来。 5. **内容设置**:切换试用日、休息参数、资源地址、调试用的跳过按钮(家长自己快速走流程用)。 ### 6.3 可选(做了加分,见 RUBRIC) 视频中途暂停点(默认关);更好的激励表现;更好的绘本翻页 / 查词体验;你认为能明显提升 6 岁孩子体验的其他设计(写进 NOTES 说明理由,**不得违反硬规则**)。 ## 7. 硬约束与自检清单(交付前逐条确认,写进 NOTES.md) - [ ] 孩子端每屏可见汉字 ≤ 12 个(不含英文学习内容);按钮优先图标(R2) - [ ] 每屏 1 个主操作,标 `data-primary`;其他可点击元素 ≤ 2 个,返回和重听除外(R1) - [ ] 每屏根元素有 `data-voice`(进入语音文本);学习内容区标 `data-content`(R3,供检查脚本使用) - [ ] 孩子端不出现统计数字、设置、术语(R4) - [ ] 可点击区域 ≥ 64×64 px(R5) - [ ] 测验界面不能对照出答案(R6) - [ ] 符号统一:▶ 播放 · 🔊 重听 · 🎤 录音 · ✅ 完成 · ✕ 关闭 · ← 返回(R8) - [ ] 任何加载失败都有「再试 / 跳过」,不卡住任务(R10) - [ ] 屏幕清单里每个元素都写了保留理由(R11) - [ ] 在 1180×820(iPad 横屏)和 820×1180(竖屏)下都能用 - [ ] 两天流程完整走通(可用调试跳过按钮),截图放在 `entries/<你>/shots/` ## 8. 不要做 - 不接后端、不改 `bookshelf/` 下任何正式代码、不改 nginx 配置(部署由另一个任务负责)。 - 不加课程解析、计划生成、复习算法、AI 对话。 - 不用 React / 构建工具(保证家长和其他 agent 能直接打开和对比)。 ## 9. 时间 建议 2—4 小时。超出时先保证第 6.1、6.2 的必须项可用。