# Easy Study 产品需求定稿 v1.1 日期:2026-10-01 状态:**需求冻结**。v1.1 并入需求变更 CR-01(PU1 改走补读写快线,见 README)。本文合并了 v0.1—v0.4、`README.md` 四轮问答(Q1—Q20)和 CR-01,是后续设计和开发的唯一需求依据。v0.x 文档保留作过程记录。 条目状态与进度只看 `docs/ROADMAP.md`。新想法先记入 ROADMAP 的「停车场」,版本回顾时再决定是否纳入。 --- ## 1. 产品定位 **一句话**:每天自动为一个 6 岁、离开双语环境的孩子排好「两件事」(Power Up 主线 + 牛津树阅读)。孩子在 iPad 上能独立完成并留下可检查的结果;家长每 1—3 天花约 15 分钟看结果、做一次亲子检查、确认下周调整。 **形态**:课程编排 + 儿童学习页面 + 家长端 Agent 助手。孩子唯一入口是 **Bookshelf Web**(iPad Safari);以后打包成 iOS App 放在 V3。 ### 1.1 用户 | 角色 | 情况 | 在产品中的职责 | |---|---|---| | 孩子 | 6 岁女孩,一年级,年底满 7 岁;喜欢牛津树、手工、动画;有好胜心,但多次没有进步会沮丧;能自己开机进入 App | 识别今天的任务,按引导完成,卡住时求助 | | 家长 | 每天可陪约 1 小时,倾向每 1—3 天集中检查;同时也是开发者 | 确认周计划、每晚用亲子卡、周六小测、讲解卡点 | | 老人 | 放学后在家,只能照看生活,不能辅导学习 | 听到休息提醒即可 | | Agent | — | 生成计划草案、分析证据、提出调整建议;**改计划必须家长确认** | ### 1.2 能力起点(家长观察,V0 基线测验后更新) - 词汇约 400—500;Starters 听力 5 盾、口语 5 盾、读写综合 1 盾。 - Power Up 1 学到第 20 页(约官方 Day 9),但 p8—12 学完后说不出人物和词。 - 已通过 Starters:听说已超过 PU1 的要求,**读写和拼写未达到**。这是 PU1 走「补读写快线」的依据(CR-01)。 - 牛津树 Stage 3 泛读较多但不扎实;Stage 4—5 能认部分句型,拼读时元音容易混淆。 - 听写:只稳在高频简单词;口语因缺少开口机会有退化趋势。 ### 1.3 目标 | 层级 | 指标 | 目标 | |---|---|---| | 北极星 | 每周「有效学习日」:两张核心卡都完成,且每张都留下可检查的结果 | ≥ 4 天/周 | | 孩子 | 不需要成人提醒就自己开始学习的天数占比 | ≥ 80% | | 家长 | 单次检查(看报告 + 亲子卡)用时 | ≤ 15 分钟 | | 学习 | 隔日听写、周小测、读前读后录音对比 | 有趋势、可对比 | | 长期 | 剑少约一年进一阶;PU1 约在 2026 年 12 月—2027 年 1 月学完,随后进入 PU2 | 努力方向,不作为软件验收门槛 | ### 1.4 产品原则(需求冲突时用来裁决) 1. **两件事**:首页只有 2 张核心卡和 1 个可折叠的「还想玩」。新增内容放进卡内部的步骤,不再增加首页卡片。 2. **先知道要找什么,再看**:每次输入前给出 2—3 个目标,看完后把它们找回来。 3. **一个动作两份价值**:优先选择既是练习又能留证据的活动,比如录音。 4. **准备在前,学习时零等待**:孩子端缺少内容时自动降级,不阻塞学习。 5. **AI 建议、家长拍板**:课程节奏以稳定为先。 6. **家长时间用在只有人能做的事上**:报告最后要落到一张可以直接执行的亲子卡。 7. **完成 ≠ 掌握**:「看过」「有结果」「待帮助」「掌握」分开记录。没有证据就显示「待检查」。 --- ## 2. 一天和一周 ### 2.1 工作日(16:00—20:00 自由安排) ``` 今天 ┌──────────────────────┐ ┌──────────────────────┐ │ ① Power Up │ │ ② 读绘本 │ │ 新课日 / 练习日 │ │ 精读巩固 / 新书挑战 │ └──────────────────────┘ └──────────────────────┘ ▸ 还想玩:已掌握的书 · 拼字游戏 · 闯关 · 复习词 · 其他讲解课 完成一张核心卡 → 得到一张单词卡 ``` - 连续使用 iPad 约 20 分钟弹出休息页(大图 + 声音,老人也能听到)。纸面步骤本身就是离开屏幕的休息。**休息页不打断课程视频**:讲解视频完整播放(课程完整性优先,约 30—35 分钟可接受),播完后再弹休息页(2026-10-02 家长决定)。 - 不限制总学习时长;基本任务完成后明确告诉孩子「今天完成了」,再提供可选活动。 - 卡住时:求助 → 仍不会就「记下并跳过」,标为「待帮助」,留给家长讲解,过几天换方式再学。 ### 2.2 一周 | 周一—周五 | 周六 | 周日 | |---|---|---| | 两张核心卡;每晚家长用亲子卡 | 约 10 分钟周小测(家长主持,App 出题和记录,题源为单元测试和本周词句) | 不排任务;用本周单词卡一起做手工(素材来自 Home Booklet) | --- ## 3. 主线:Power Up ### 3.1 课程来源 - **为什么考过 Starters 还学 PU1**:官方定位上 PU1 对应 Starters,但资料包机构路线中「剑少 2 级(Movers)= PU1 + Funskills 3&4」。孩子听说已达标、读写只有 1 盾,PU2 起步就是现在进行时、最高级,且默认已会拼写 Starters 词,所以先用 PU1 把读写和拼写补上,再进入 PU2。 - **官方每日规划表**(剑少二级:PU1 + Funskills 3&4)是课程来源,从中提取出 `data/curriculum/powerup1.json`。PU1 为 Day 1—58,Day 20、39、58 是复习日。 - 每个 Day 提取:页码、讲解视频、动画文件、音轨、重点单词、句型和「四会」要求。动画文件名与规划表一致(如 `P19-U2-1.22.mp4`,`1.22` 指 CD1 第 22 轨),可以自动对应。 - 讲解视频**主用 AJ 综合主线课**;大乔乔、Shelley 放进「还想玩」,作为阶段复习试用,家长观察孩子的兴趣。 - 正式资源目录为 `E:\BaiduNetdiskDownload\PowerUp\2_PowerUpN\`,nginx 新增 `/pu/` 直接指向这里,不再复制视频。旧资料包目录不动,是否删除由家长决定。 - 原有的拼读路线课程数据(`data/curriculum/` 中的 26 周例词、高频词等)降级为「还想玩」和 V1.1 拼读专项的题源,不再作为主线。 ### 3.2 补读写快线:单元前测 + 按单元设定节奏 **每个单元的流程**: 1. **单元前测**(约 15 分钟):开始新单元前,做该单元的单元测试(`自制单元测试PU1/PU1 Un/`,含听力和答案)。V1 由家长用纸质卷执行,在亲子卡里录入分数;V1.2 再做成数字化。 2. **按前测结果设定本单元节奏**: | 前测结果 | 节奏 | 学法 | |---|---|---| | ≥ 80% | **快线**(1 个官方 Day = 1 个学习日,约 3—4 天学完一个单元) | 讲解视频只看重点段,时间花在四会词抄写、听写和读句子上 | | < 80% | **巩固**(1 个官方 Day = 2 个学习日) | 按下表的 A 新课日和 B 练习日完整学习 | 3. **单元后测**:单元结束时的周六小测换一套单元题(或抽取四会词听写)。不达标的四会词进入复习(SRS),不阻塞下一单元。 **巩固节奏下的学习日**: | 学习日 | 步骤 | 证据 | |---|---|---| | **A 新课日** | 预告卡(2—3 个重点词 + 1 个句型)→ AJ 课本讲解 → 动画 / 音频 → 找回来(以读和拼为主:看词选图、听音拼词 2—3 题 + 用句型录 1 句) | 选择 / 拼写结果、录音 | | **B 练习日** | AJ 练习册讲解 → 纸质练习册 → 每个重点词抄写 4 遍(纸上)→ 录读句子 | 家长翻看练习册后在亲子卡里勾选;**第二天亲子卡口头听写 3 个词** | **快线的一个学习日**:重点段视频 → 纸质练习册 → 四会词抄写 4 遍 → 「找回来」读和拼 2 题;第二天亲子卡口头听写 3 个词。 **通用规则**: - 某天重点词超过 8 个时,把一半抄写挪到前一个学习日。 - 「找回来」的题目来自 `PU 1 课后练习/`(每单元 L1—L5)。 - 官方复习日(Day 20/39/58)并入周六小测。 - **起点**:从 Unit 1 开始,用前测分流。已经学过、掌握较好的单元前测会达标,自然走快线,不需要另外决定从 Day 3 还是 Day 9 开始。 - **时间**:PU1 预计 2026 年 12 月—2027 年 1 月学完,然后进入 PU2(剑少 3 级规划表,提取方式相同)。PU1 不达标的四会词继续在复习中出现。Funskills 是否购买,在 PU2 期间再评估。 --- ## 4. 阅读:牛津树 | 类型 | 频率 | 用书 | 步骤 | 达标标准 | |---|---|---|---|---| | **精读巩固** | 每周 3 天 | Stage 3(40 本,文字和音频都有) | 自己先读并录音 → 卡住的词求助 → 听原音 → 回答 2 个问题 / 复述 → 再录一遍 | 不听音频能自己读出约 9 成,并能回答 2 个问题 | | **新书挑战** | 每周 2 天 | Stage 4 没读过的书 | 先听 → 跟读 → 3 个词 → 录一段 | 能读完、能说出大意 | - 达标的书标记为「已掌握」,移进「还想玩」;每 4 周的周六小测抽查 2 本。 - Stage 3 约 3/4 达标后,App 建议升级为「Stage 4 精读 + Stage 5 新书」,家长确认后生效。 - Stage 5—9 缺少文字识别数据和音频:在 V1 试用期间慢慢处理,**不阻塞 V1**。没有原版音频时用 edge-tts 朗读,并标注「电脑朗读」。 --- ## 5. 帮助、激励与家长端 ### 5.1 求助(逐版增强) | 版本 | 能力 | |---|---| | V1 | 点词:发音 + 中文意思 + 预先准备的图;失败可以重听或标为「不会」后继续 | | V1.1 | 语音查词(识别不准时给 3 个候选图)、图解词库(备课时批量生成)、结合当页内容的中英混合讲解 | 中文解释优先,便于直接理解;不强制用英文释义。 ### 5.2 激励 - 完成一张核心卡得一张单词卡(今天学的词 + 图);连续天数。只按完成和留下证据计算,不按分数。 - 周日用单词卡做手工。 - **60 秒挑战**(V1.1):孩子自己选择要不要挑战,只和自己的最好成绩比,不显示失败;连续 2 次没有进步就自动降档,并提示「先练一练」。没有排名。 ### 5.3 家长端 - **日报 + 今晚亲子卡**(5—10 分钟):3 个要问的问题、2 句要听她读的句子、1 个卡点、练习册勾选、口头听写 3 个词。家长勾选的结果也进入学习记录。 - 读前、读后录音对比;「待帮助」清单。 - **周计划**:系统按课程进度和节奏生成,家长确认后发布。Agent 周末给出下周建议(含理由和依据),家长确认、修改或拒绝;调整可以追溯,已完成的记录不会被改写。 - 报告在 App 内查看。Hermes 微信提醒保持现有能力,但不再投入开发。 --- ## 6. 技术与成本约束 | 项目 | 决定 | |---|---| | 数据 | 服务端 `data/learning/` 是唯一数据来源(JSON + JSONL,有备份),iPad 只做缓存和离线队列;7 天重签不会丢数据。暂不迁移 SQLite | | 新增数据 | 录音(`data/learning//audio/`,纳入备份)、课程进度位置(当前官方 Day)、各单元前测 / 后测分数与节奏 | | 录音 | iPad Safari 需要 HTTPS:局域网证书由 mkcert 生成,在 iPad 上信任一次 | | 视频 | 同源相对路径 `/pu/...` | | 已有代码 | 在 daily-plan-engine 基础上修订(五卡改两卡),不重写。原 c1 新词并入绘本卡,复习词放进「还想玩」;c2、c3 并入绘本卡;c5 改为练习日的纸面步骤;c6 放进「还想玩」和周六小测;星星改为单词卡 | | 冻结 | studydeck-ipad(→ V3)、studydeck-ai-assist(→ V2)、studydeck-video-ai-chrome(→ V2)、studydeck-phoneme-48-audio(→ V1.1 时评估) | | AI 费用 | V1 运行时约 0 元(TTS 用 edge-tts);V1.1 起运行时 API ≤100 元/月,超过 80 元在家长端提醒;高档开发订阅(≤1000 元)在 V1 开发月开通 | | 产能 | 约 11 小时/周;技术验证每项限 1 个晚上,超过 2 个晚上就改用降级方案 | --- ## 7. 版本路线 | 版本 | 主题 | 范围 | 退出条件 | |---|---|---|---| | **V0** | 收敛与起点(约 2 周) | 归档 2 个 change、冻结 4 个、HTTPS 录音、提取规划表(脚本按级别参数化)、nginx `/pu/`、基线测验(Starters 读写卷 + PU1 U5 单元测试 + 10 词听写)、书单、起草修订 change | ROADMAP V0 全部完成,WIP = 1 | | **V1** | 每天两件事(开发 3—4 周 + 试用 2 周) | 第 3、4、5.1(V1 部分)、5.2(单词卡)、5.3 节;含单元前测分数录入与按单元设定节奏 | 连续 2 周:每周有效学习日 ≥ 4;孩子自己开始 ≥ 80%;家长检查 ≤ 15 分钟;无 P0 | | **V1.1** | 卡住有人帮 | 语音查词、图解词库、复习词进入核心卡、拼读听写(复用拼字游戏)、60 秒挑战、上下文讲解 | 孩子能自己解决典型卡点;复习有来源、可检查 | | **V1.2** | 看见进步 | 单元前测 / 周小测数字化、分技能趋势、升级与节奏建议、手工建议库、三个月回顾 | 能用证据回答「有没有进步」 | | **V2** | 开口与扩展 | AI 口语小对话、视频中途提问、AI 问答、动画片段、Movers 练习、逐句音频 | 每一项都接入同一个闭环 | | **V3** | 打包与通用 | iOS App 打包、可替换的课程模板、多家庭 | 暂不排期 | V1 明确**不做**:语音查词、现场生成图片、逐句音频、自动升级、AI 对话、考试题库、拍照上传。 --- ## 8. V1 验收场景 | ID | 场景 | 通过标准 | |---|---|---| | A01 | 家长确认周计划 | 确认前不生效;发布内容与确认版本一致 | | A02 | 孩子自己进入「今天」 | 不识字也能开始;在真实 iPad 上观察并记录成人介入 | | A03 | 新课日 | 只看完视频记为「看过」;选图或录音后才记为「有结果」 | | A04 | 练习日 | 纸面步骤清楚;家长在亲子卡勾选后记录完整 | | A10 | 单元前测分流 | 家长录入前测分数后,该单元节奏按 ≥80% 快线 / <80% 巩固自动生成计划草案,家长确认后生效 | | A05 | 精读:两次录音 | 家长端能对比读前和读后 | | A06 | 卡住、跳过、休息、退出 | 已有结果不丢失;「待帮助」可见;能恢复 | | A07 | 家长隔 1—3 天检查 | 15 分钟内完成;能追溯到任务和证据 | | A08 | Agent 建议调整 | 确认前原计划不变;确认后明确从哪天生效 | | A09 | 断网 | 结果暂存在离线队列,恢复后同步;状态显示「待同步」 | 涉及孩子端的改动,按仓库约定调用 child-ux-tester,并处理报告中的 P0/P1。 --- ## 9. 版本管理规则 1. `docs/ROADMAP.md` 是唯一的路线图;openspec change 必须写明对应的 ROADMAP ID,没有 ID 不开工。 2. 同一时间只有 1 个进行中的 change(WIP = 1);新想法先记入停车场。 3. Bug 分级:P0(无法继续、结果丢失、错误判定)立刻修;P1(影响验收标准)在本版本内修;其他进停车场。每个 bug 要注明影响哪条验收。 4. 时间盒:一个版本超出计划时间 50% 时,在缩减范围和延期之间二选一,并记录下来。 5. 版本门禁:逐条核对退出条件,并让孩子完整走一遍流程(孩子视角回顾)后,才能进入下一版。 6. 提醒时机:退出条件已满足、某个 change 连续 2 周没有推进、停车场达到 10 条、孩子不愿意用。