# Easy Study 产品思路与版本规划 v0.2 日期:2026-09-30 依据:v0.1 + `README.md` 第一轮 Q1—Q8 回答 + 仓库核对(`openspec/changes/*`、`deploy/nginx/nginx-win.conf`、`E:\nginx-1.8.0\html\video\PU-AJ\`)。 相对 v0.1 的变化集中在第 1、2 节;版本路线(第 3 节)已按回答修订。条目级状态以 `docs/ROADMAP.md` 为准,本文只写思路和规则。 --- ## 1. 第一轮已定决策 | # | 决策 | 对版本的影响 | |---|---|---| | D1 | **孩子唯一入口 = Bookshelf Web(A)**。Power Up 视频走 nginx `/video/PU-AJ/...`,在 Bookshelf 内加播放页 | studydeck 桌面/iOS 相关 change 全部冻结;AI 问答、组课能力 V2 起并入 A;最终打包 iPad App 放 V3 | | D2 | 首页 **两张核心卡 + 「还想玩」** | daily-plan-engine 五卡需要一个修订 change(见 2.3) | | D3 | Power Up 有课本、练习册(实体)+ 教师用书、答案、视频、音频、闪卡(电子);题目由 AI 按课本 + 学习数据生成,也可直接用练习册 | 「预告卡 / 找回来」的来源 = 教师用书的课时目标;每周备课由 AI 生成、家长确认 | | D4 | 放学后有老人在,孩子能独立开机进 App;老人不能辅导学习 | 引导仍需全部靠 App;休息提醒可以同时提示老人(声音 + 画面) | | D5 | 最喜欢做手工;无排名;**60 秒挑战可以,但多次没进步会沮丧** | 激励 = 收集单词卡 → 周末手工;挑战只和自己比,有保护机制(见 2.4) | | D6 | 纸质与 iPad 穿插 | 练习册、实体书是正式任务步骤 | | D7 | 愿意每天用「今晚亲子卡」 | 亲子卡进 V1,是开口练习与证据的主要来源 | | D8 | 已订阅 ChatGPT Pro、Cursor;增量不超过约 300 元/月;可用国产模型做 OCR/TTS/ASR/文生图 | AI 分为「备课期」和「运行期」两类,运行期控制在低成本(见 2.5) | --- ## 2. 根据回答补充的设计 ### 2.1 Power Up 课时拆解(从视频结构得出) `PowerUp1` 目录共 62 个视频,命名规律是一课一对:`05--p8.mp4`(课本第 8 页讲解)+ `06--p8 AB 7-11.mp4`(练习册 7—11 页讲解)。这正好对应「输入 → 练习」,建议每课拆成 3 个学习日: | 学习日 | 主线卡内的步骤 | 结果(证据) | |---|---|---| | 新课日 | 预告卡(3 个目标:人物 / 单词 / 句型,来自教师用书)→ 看课本视频 → 找回来(选图 2—3 题 + 录 1 句) | 选图结果、录音 | | 练习日 | 看练习册视频 → 在**纸质练习册**上完成指定页 | 家长晚上看练习册,在亲子卡中勾选 | | 复习日 | 闪卡认读 → 录读本课 2—3 个句子 → (可选)60 秒挑战 | 录音、挑战成绩 | - 节奏候选:每周约 2 课(6 个学习日 + 周六小测)。按 62 个视频约 30 课估算,PowerUp1 约 15—17 周,符合「约一年进一阶」。[待确认 Q9] - 看完视频只记「看过」;选图 / 录音 / 练习册勾选才算「有结果」。 ### 2.2 一天的样子(工作日) ``` 今天 ┌────────────────────────┐ ┌────────────────────────┐ │ ① Power Up(新课日) │ │ ② 读绘本 │ │ 目标 → 看视频 → 找回来 │ │ 听读新书 → 3个词 → 录一段│ └────────────────────────┘ └────────────────────────┘ ▸ 还想玩:旧书自由读 · 拼字游戏 · 闯关 · 复习词 完成一张卡 → 得到一张单词卡(带图,来自今天的内容) ``` - 绘本卡:每天一本**当前级别新书**(主读 Level 4—5);喜欢的旧书放在「还想玩」。 - 连续使用 iPad 约 20 分钟弹出休息页(大图 + 声音,老人也能听到);练习册、实体书步骤本身就是离开屏幕的休息。 - 周六:周小测(约 10 分钟,家长主持,App 出题和记录);周日:用本周单词卡做手工,不排任务。[待确认 Q13] ### 2.3 已实现五卡的去向 daily-plan-engine 的后端和前端已完成 43/45 项,**不重写,改为修订**: | 现有卡 | V1 去向 | |---|---| | c1 拼读新词 + 复习 | 新词:绘本卡里的「3 个词」步骤(复用 Learn);复习词:「还想玩」(SRS 保留,V1.1 再进核心) | | c2 听一听(绘本音频) | 并入绘本卡第一步 | | c3 读绘本 | 绘本卡主体 | | c5 写一写(家长长按确认) | 改为 Power Up 练习日的纸质练习册步骤,确认入口移到亲子卡 | | c6 小测 | 「还想玩」+ 周六小测 | | 星星 / 连续天数 | 改为单词卡收集 + 连续天数 | | Hermes 微信提醒 | 保持现有能力,不再投入 | 做法:先关掉 daily-plan-engine(剩 11.1 端到端脚本、11.4 儿童体验测试),再开一个修订 change `daily-plan-v1-two-cards`,只描述差异。[待确认 Q10] ### 2.4 激励与挑战(根据 D5) - **单词卡收集**:完成一张核心卡得一张单词卡(今天学的词 + 图)。周末用这周的卡做手工(贴成小书、做词语转盘等),App 给一个手工建议。奖励只看完成,不看分数。 - **60 秒挑战(V1.1)**: - 只在已练过、正确率较高的内容上出现,孩子自己选择要不要挑战; - 只和「自己的最好成绩」比,不显示失败; - 连续 2 次没超过最好成绩:自动降一档(减少数量或换熟悉的词),并提示「先练一练再来」; - 家长报告里显示挑战曲线,沮丧信号(连续放弃)进入亲子卡。 ### 2.5 AI 与成本架构(根据 D8) 注意:ChatGPT Pro、Cursor 这类订阅**不包含 App 运行时调用的 API**。所以把 AI 分成两类: | 类别 | 做什么 | 用什么 | 成本 | |---|---|---|---| | 备课期(每周一次,家长触发) | 从教师用书、课本页生成本周内容包:课时目标、预告卡、找回来题、绘本 3 词、亲子卡问题、图解 | 已有订阅(ChatGPT / Codex / Claude),用固定提示词,输出 JSON 后导入并确认 | 0 增量 | | 运行期(孩子使用时) | 发音 TTS、V1.1 语音查词 ASR、上下文讲解、周报分析 | TTS 用 edge-tts(已有,免费);ASR / 讲解用国产 API 按量付费(仓库已有 `ark-volcengine`) | 预估 < 50 元/月 [待确认 Q12] | | 文生图 | 单词图解 | 备课期批量生成并缓存,不在孩子学习时现场生成 | 一次性,少量 | 原则:V1 运行期可以做到**零 AI 调用**,孩子端所有内容都是备课期准备好的。 ### 2.6 需要提前处理的技术约束 | 约束 | 影响 | 处理 | |---|---|---| | iPad Safari 只有在 **HTTPS** 下才能用麦克风录音;当前 nginx 只有 `listen 80` | V1 的录音(找回来、读绘本、复习日)无法使用 | V0 配置局域网 HTTPS(mkcert 证书,在 iPad 上信任一次根证书)[待确认 Q11] | | iPad 不能访问 `localhost` | 视频地址要使用局域网 IP 或同源相对路径 | 视频地址使用同源相对路径 `/video/...`(与 `EASYSTUDY_HOST` 为空一致) | | 纸质练习册的检查 | 拍照上传会增加开发量和孩子的操作 | V1 不做拍照;家长晚上翻练习册,在亲子卡里勾选 [待确认 Q11] | --- ## 3. 版本路线(v0.2) | 版本 | 主题 | 范围要点 | 退出条件 | |---|---|---|---| | **V0** | 收敛与起点 | 关闭/冻结 change、HTTPS、起点观察、第一周内容包、备课提示词 | 见 3.1 | | **V1** | 每天两件事 | 两卡首页、Power Up 三日课时、绘本卡、视频播放页、录音、基础求助、单词卡收集、休息页、日报 + 亲子卡、周计划确认 | 连续 2 周:每周有效学习日 ≥4;孩子独立开始 ≥80%;家长检查 ≤15 分钟;无 P0 | | **V1.1** | 卡住有人帮 | 语音查词、图解词库、复习词进核心、拼读听写(复用拼字游戏)、60 秒挑战、上下文讲解 | 典型卡点孩子能自己解决;复习有来源、可检查 | | **V1.2** | 看见进步 | 周小测数字化、分技能趋势、升级/复习建议、手工建议库、三个月回顾 | 能用证据回答「有没有进步」 | | **V2** | 开口与扩展 | AI 口语小对话、视频中途提问(吸收 studydeck-video-ai)、AI 问答(吸收 studydeck-ai-assist)、动画片段、Movers 练习 | 每项接入同一闭环 | | **V3** | 打包与通用 | iPad App 打包、课程模板可替换、多家庭 | 暂不排期 | ### 3.1 V0 执行清单 | # | 事项 | 负责 | 产出 / 完成标准 | |---|---|---|---| | V0-1 | 收尾 daily-plan-engine(11.1 端到端、11.4 儿童体验测试)并归档 | 开发 | change 归档 | | V0-2 | 收尾 book-word-spelling-game(7.3 儿童体验测试)并归档 | 开发 | change 归档 | | V0-3 | 冻结 studydeck-ipad / studydeck-ai-assist / studydeck-video-ai-chrome / studydeck-phoneme-48-audio,在 ROADMAP 中注明归属版本 | 开发 | 冻结说明 | | V0-4 | 局域网 HTTPS:nginx 443 + mkcert,iPad 信任证书,测试 Safari 录音 | 开发 | iPad 上能录一段并回放 | | V0-5 | 起点观察(约 20 分钟):陌生 Level 4、5 各读一页并讲述;10 个学过的词听写(纸上);5 个日常英语问题;录音存档 | 家长 | 第 0 周基线记录 | | V0-6 | 备课提示词 v1:输入课本页 + 教师用书页,输出课时目标 / 预告卡 / 找回来题 / 亲子卡问题(JSON) | 开发 + AI | 用 p8 这一课跑通一次 | | V0-7 | 第一周内容包:2 课 Power Up(从孩子当前进度开始)+ 6 本 Level 4—5 新书(OCR 可用) | 家长 + AI | 可直接导入 | | V0-8 | 起草修订 change `daily-plan-v1-two-cards` | 开发 | proposal 通过 | 退出条件:V0-1~V0-8 完成;同一时间只有 1 个进行中的 change。 --- ## 4. 版本管理规则(沿用 v0.1,补一条) 1. 唯一真源 `docs/ROADMAP.md`;change 必须写对应 ROADMAP ID。 2. WIP = 1;新想法进「停车场」。 3. bug 分 P0 / P1 / 其他,注明影响的验收项。 4. 时间盒:超出计划时间 50% 时,在砍范围和延期之间二选一。 5. 版本门禁:退出条件逐条核对后再进入下一版。 6. **(新增)每个版本结束时做一次孩子视角回顾**:让孩子用一次完整流程,家长记录她在哪里卡住、哪里开心。这是比 bug 列表更重要的输入。