# Easy Study 产品需求定稿 v1.0 日期:2026-10-01 状态:**需求冻结**。本文合并了 v0.1—v0.4 和 `README.md` 四轮问答(Q1—Q20),是后续设计和开发的唯一需求依据。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 学完后说不出人物和词。 - 牛津树 Stage 3 泛读较多但不扎实;Stage 4—5 能认部分句型,拼读时元音容易混淆。 - 听写:只稳在高频简单词;口语因缺少开口机会有退化趋势。 ### 1.3 目标 | 层级 | 指标 | 目标 | |---|---|---| | 北极星 | 每周「有效学习日」:两张核心卡都完成,且每张都留下可检查的结果 | ≥ 4 天/周 | | 孩子 | 不需要成人提醒就自己开始学习的天数占比 | ≥ 80% | | 家长 | 单次检查(看报告 + 亲子卡)用时 | ≤ 15 分钟 | | 学习 | 隔日听写、周小测、读前读后录音对比 | 有趋势、可对比 | | 长期 | 剑少约一年进一阶;PU1 约在 2027 年 3 月学完 | 努力方向,不作为软件验收门槛 | ### 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 分钟弹出休息页(大图 + 声音,老人也能听到)。纸面步骤本身就是离开屏幕的休息。 - 不限制总学习时长;基本任务完成后明确告诉孩子「今天完成了」,再提供可选活动。 - 卡住时:求助 → 仍不会就「记下并跳过」,标为「待帮助」,留给家长讲解,过几天换方式再学。 ### 2.2 一周 | 周一—周五 | 周六 | 周日 | |---|---|---| | 两张核心卡;每晚家长用亲子卡 | 约 10 分钟周小测(家长主持,App 出题和记录,题源为单元测试和本周词句) | 不排任务;用本周单词卡一起做手工(素材来自 Home Booklet) | --- ## 3. 主线:Power Up ### 3.1 课程来源 - **官方每日规划表**(剑少二级: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 一个官方 Day = 两个学习日(巩固节奏,默认) | 学习日 | 步骤 | 证据 | |---|---|---| | **A 新课日** | 预告卡(2—3 个重点词 + 1 个句型)→ AJ 课本讲解 → 动画 / 音频 → 找回来(选图 2—3 题 + 用句型录 1 句) | 选图结果、录音 | | **B 练习日** | AJ 练习册讲解 → 纸质练习册 → 每个重点词抄写 4 遍(纸上)→ 录读句子 | 家长翻看练习册后在亲子卡里勾选;**第二天亲子卡口头听写 3 个词** | | 官方复习日 | 并入周六小测,使用单元测试卷 | 小测结果 | - 某天重点词超过 8 个时,把一半抄写挪到新课日。 - 「找回来」的题目来自 `PU 1 课后练习/`(每单元 L1—L5)。 - 节奏切换:连续 2 周「找回来」基本都答对时,App 建议改为「标准节奏」(一个官方 Day 用一个学习日),家长确认后生效。 - 起点:V0 用「PU 第一册定级卷(简单版)+ Unit 1 单元测试」做测验。Unit 1 掌握不好就从 Day 3 快速回补(一个官方 Day 用一个学习日),否则从 Day 9 开始。 - PU1 学完后:建议直接进入 PU2(有剑少三级规划表),2027 年 2 月的版本回顾时决定。 --- ## 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/`、起点测验、书单、起草修订 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 | 练习日 | 纸面步骤清楚;家长在亲子卡勾选后记录完整 | | 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 条、孩子不愿意用。