# 04 掌握度判定与复习调度规则 > 所属:`tasks/0913-EnglishStudyAnalysis/`(阶段 1 文档) > 版本:v1.0(2026-09-17) > 上游:`01`(P7 调皮/自评难、P9 多次尝试、P13 家长三段度量标准)、`02`(新学内容池)、`03`(每日卡片与周测/月测) > 下游:`05`(`srs.json` 结构、`/api/srs`、`/api/plan/generate` 实现)、流水线 `daily-plan-engine` --- ## 1. 目标 把家长给出的度量标准「**3 天内反复练习测验 → 1 周后随机测 → 1 月后系统测,按正确率与错误率判断**」做成一台可以自动运转的状态机,并给出: 1. 什么算「一次正确」(按题型); 2. 学习项如何在状态间流转、何时到期; 3. 计划引擎每天如何从状态机与课程地图里挑内容; 4. 怎样识别并抵消「故意选错」; 5. 现有 `bookStudy.ts` 的 localStorage 状态如何迁移; 6. 报告用到的指标定义。 ## 2. 学习项(Item) | 类型 `kind` | 说明 | 来源 | 典型题型 | | --- | --- | --- | --- | | `letter` | 字母大小写(`Bb`)及混淆对 | `letters.json`、基线错误 | 听音选字母、配对 | | `phoneme` | 音素或字母组合(`sh`、`a_e`) | `phonics-units.json` | 听音选字(Learn 第一关)、六宫格 | | `word` | 拼读词(`cake`)或高频词(`they`),`subkind: phonics\|hf` | 本周规则池、高频词组、绘本生词、读后「不会」、闯关错词 | 字母块选拼法、点选拼写、听词选词、朗读评分 | | `sentence` | 今日一句 | `clips.json` | 跟读评分、听句排序(远期) | | `pattern` | 句子选词模式(`go/went`) | `hf-words.json` 模板 | 句子选词 | | `qa` | 问答题 | `qa-bank.json` | 口语关键词命中 | Item 的唯一键 `itemId = {kind}:{normalized}`,如 `word:cake`、`phoneme:eɪ`、`pattern:go-went`。同一个词只有一条状态,不再按书隔离(现有 localStorage 是按书隔离的,迁移时合并,保留 `sources[]` 出处)。 ## 3. 状态机 ```mermaid stateDiagram-v2 [*] --> new: 进入本周池 / 绘本点词 / 基线错误 new --> learning: 首次出现在卡片中 (D0) learning --> weekly: 巩固窗内不同日 ≥2 次正确 且 最后一次正确 learning --> learning: 窗内 <2 次正确 → 延长 3 天 (最多 2 次) weekly --> monthly: D7 随机测正确 weekly --> learning: D7 错 (lapse) monthly --> mastered: D30 系统测正确 monthly --> weekly: D30 错 mastered --> weekly: 90 天抽检错 mastered --> [*] ``` | 状态 | 含义 | 到期规则 `dueAt` | 被哪张卡消费 | | --- | --- | --- | --- | | `new` | 已进入候选池,未学 | 无 | 卡 1(新词位)、卡 5(新字母/新词) | | `learning` | 3 天巩固窗 | `enteredAt + 1d`、`+3d` 各测一次;窗外未达标每 3 天延一次 | 卡 1 复习位、卡 6 闯关、卡 4 说一说 | | `weekly` | 一周后随机测 | `enteredAt + 7d ± 1d`(随机抖动,避免同日堆积) | 周六周测(周五「本周 10 题」可提前消费到期 ≤ 1 天的) | | `monthly` | 一月后系统测 | `enteredAt + 30d`,实际落在最近的月测日 | 月测 | | `mastered` | 已掌握 | `enteredAt + 90d` 抽检(每次月测抽 10%) | 月测 | 进入 `weekly` 的条件里「不同日」是关键:同一天连对 3 次只算 1 次,逼着复习跨天发生(家长标准中的「反复」)。 ## 4. 「一次正确」的定义(按题型) | 题型 | 正确 `correct` | 通过 `pass`(不推进、不惩罚) | 错误 `wrong` | | --- | --- | --- | --- | | 听音选字 / 听词选词 / 字母块选拼法 / 句子选词(选择题) | 首次点击即对,且 `responseMs ≥ 1500` | 首次错、重试后对(≤ 3 次) | 3 次仍错,或放弃 | | 点选拼写(SpellingGame) | `firstAttemptCorrect` 且 `mistakeCount == 0` | `completedAfterRetry` | 未完成或 `mistakeCount ≥ 3` | | Learn 三连关(听音选字 → 六宫格 → 拼词) | 三关都首次对 | 任一关重试后过 | 中途放弃 | | 朗读评分(词) | 三次内任一次 `score ≥ 70` | 三次内 `score 55-69` | 三次都 `< 55`,或 ASR 三次都未识别(记 `noSignal`,不计 wrong) | | 跟读评分(句) | 三次内 `score ≥ 65` | 三次内 `score 50-64` | 同上 | | 问答(qa) | 关键词命中 | 部分命中(半数关键词) | 未命中 | | 读后自检「会读 / 不会」 | **不算判定**,只把「不会」的词加入 `new/learning` | — | — | | 家长判定(基线朗读/书写/问答) | 家长选「对」 | 「部分」 | 「错」 | 计数字段:`correctCount`、`passCount`、`wrongCount`、`hastyCount`、`noSignalCount`;`lastResult`、`lastAt`;`history[]` 保留最近 20 条 `{at, result, source, score?}`。 ## 5. 随意作答检测(对应 P7) | 信号 | 判定 | 处理 | | --- | --- | --- | | 单题 `responseMs < 1500` 且错 | `hasty` | 不计 wrong、不计 correct;该题重新出现在本轮末尾 | | 连续 2 题 hasty | 提示 | 页面弹「慢一点,先听一遍 👂」并自动重播题目音频,2 秒内不可点选 | | 同一轮 hasty ≥ 3 | 降温 | 本轮剩余题改为「听 → 再听 → 点」两段式;今天页不扣星;日报标注 | | 一轮内选项位置全相同(如全选第 1 个)且正确率 ≤ 25% | `pattern` | 同「降温」;周报标注「疑似随意作答」 | | 首次选项与正确项互为混淆对(b/d、they/them)且 `responseMs ≥ 1500` | 真实混淆 | 正常计 wrong,并给该混淆对加权(`confusionWeight += 1`),下次干扰项必含 | hasty 数据只进日报/周报供家长判断,不用于自动升降档。 ## 6. 每日计划生成算法 运行时机:每日 04:00 定时(`POST /api/plan/generate`),以及今天页首次打开时若当日计划不存在则即时生成(幂等,同日重复调用返回同一份)。 ```text 输入:profile(stage、weekCursor、schedule、level 调整)、curriculum(本周规则/词组/集数/字母游标)、srs(全部 item)、events(近 7 天)、昨日计划(deferred 项) 输出:plans/YYYY-MM-DD.json(6 张卡 + 每卡 items) 1. 判定日型:weekday / saturday / sunday / month_end_sat / month_end_sun / day_off - sunday 或 day_off → 不生成任务卡,只生成「自由玩」入口 2. 取本周上下文:week = phonics-units[weekCursor];hfGroup = 当月词组;episode/clips = 本周集;book = ort-sequence 当前书与 D1/D2/D3 游标 3. 到期集合 due = srs.items.filter(dueAt ≤ today 23:59 且 status ∈ {learning, weekly(周五/周六), monthly(月测日)}) 排序键 dueScore = overdueHours + wrongCount*8 + confusionWeight*4 − passCount*2 4. 卡 1 拼一拼: newWords = week.words 中 status==new 的前 2 个(按例词池顺序) reviewWords = due 中 kind==word 且 subkind==phonics 的前 2 个 若 newWords 不足 → 用 reviewWords 补到 4;若 due 不足 → 用 week.words 中 learning 的补 5. 卡 2 听一听:clip = clips[weekday index](周五:本周 5 句轮播) 6. 卡 3 读一读:按 §7 书游标;mode = D1 listen / D2 read / D3 review 7. 卡 4 说一说:items = 卡 1 前 3 词 + 卡 2 句 + (month ≥ 3)qa 随机 1 题(避开近 7 天出过的) 8. 卡 5 写一写:letter = letters 游标(基线错字母优先插队);words = hfGroup 中 writtenCount==0 的前 2 个(循环) 9. 卡 6 闯关:questions = due 排序取 5(周五取 10,含本周新词);题型按 item.kind 映射;不足用 week.words / hfGroup 的 new 项补 若 hasty 上周 ≥ 5 → 本卡前 2 题强制「听 → 再听 → 点」 10. 顺延:昨日 deferred 卡 → 今日同位卡加 `carriedOver: true`;已 carriedOver 再未完成 → skipped 11. 限额:新项/日 ≤ 6(2 拼读词 + 2 高频词 + 1 句 + 1 字母对);复习项/日 ≤ 12;总预估时长 ≤ profile.dailyMinutes(默认 20) 12. 自适应(§8)后写盘,并生成微信文案缓存 ``` ## 7. 阅读游标 ```text book = ort-sequence[cursor] D1 listen → D2 read → D3 review D3 完成条件:读后检测 unknown_words ≤ 3 达标 → cursor += 1;生词进 srs(new) 未达标且 retried == false → 明日再 D3(retried = true) 仍未达标 → cursor += 1,但把该书放入「重读队列」,周六重读段优先取 非 readable 书:D2 不安排点词,改为「跟着音频读」;周报列出待校对 ``` ## 8. 自适应升降档 | 触发 | 动作 | 恢复 | | --- | --- | --- | | 连续 3 个工作日完成 < 3 卡 | 降档:新项/日减半;卡 3 只安排 D1;卡 6 改 3 题 | 连续 3 天完成 ≥ 5 卡后恢复 | | 连续 5 个工作日全完成且首次正确率 ≥ 90% | 升档:每周规则 1 → 1.5 个(本周多引入下周前 4 个例词);卡 6 改 7 题 | 首次正确率 < 75% 时回到标准 | | 基线/月测某模块「起步」 | 该模块相关 kind 的新项减半,复习位加倍 | 下次月测 ≥ 60 | | 基线/月测某模块「熟练」 | 该模块相关新项 ×1.5;月复测抽样减半 | 下次月测 < 85 | | 周测正确率 < 60% | 下周不引入新规则,整周复习 | 一次性 | ## 9. 周测 / 月测抽样 | 测 | 池 | 抽样 | 不足时 | | --- | --- | --- | --- | | 周五「本周 10 题」 | 本周新引入的 word/phoneme/pattern | 全部 ≤ 10 则全考;> 10 按 wrongCount 降序取 10 | 用 `learning` 到期项补 | | 周六周测 15 题 | `weekly` 且 dueAt ≤ 周六 | 按 dueScore 取 15;至少 3 题来自高频词组、3 题来自音素 | 用 `learning` 项补,并标 `filler: true`(不推进 weekly 逻辑) | | 月测 20 题 | `monthly` 且 dueAt ≤ 月测日 + `mastered` 抽 10% | 优先 monthly;mastered 抽检最多 4 题 | 用 `weekly` 项补 | 测验中的 `correct/wrong` 同样按 §4 判定,并按 §3 流转(周测正确 → monthly,错 → learning)。 ## 10. 口语与音素的特殊规则 - 朗读评分产生的 `weakPhonemes`(如 `/eɪ/`)写入 `phoneme:eɪ` 项:`wrongCount += 1`,状态若为 `mastered/monthly/weekly` 则回到 `learning`。 - `phoneme` 项到期时优先出现在卡 1 第一关(听音选字)和卡 6。 - 三次 `noSignal`(ASR 无结果)不计错,但日报提示「今天麦克风好像没声音」,连续两天则提醒家长检查设备。 ## 11. 从 `bookStudy.ts` 迁移 一次性 `POST /api/srs/sync`(今天页首次加载时触发,成功后本地打标 `easy-study:synced=1`;服务端按 `(itemId)` 幂等合并)。 | localStorage 字段 | 服务端 | | --- | --- | | `StudyWordProgress.word` | `itemId = word:{normalized}`,`subkind` 由是否在 `phonics-data.json` 判定 | | `status: new` | `new` | | `status: learning` | `learning`,`enteredAt = updatedAt`,巩固窗从同步日起算 | | `status: mastered` | **`weekly`**(现有「连对 2 次」不满足跨天条件,需再经一次周测确认),`dueAt = 同步日 + 7d` | | `correctCount / wrongCount` | 原值保留;`passCount = 0` | | `source: reader/quiz/spelling/book` | `sources[] += {type, bookId, at}` | | `quizAttempts[]`、`spellingAttempts[]` | 转为历史 `quiz/spelling` 事件(`at` 用原时间戳,`migrated: true`) | | 多本书含同一词 | 合并为一条,`wrongCount` 取和,`status` 取最靠前的(learning 优先于 weekly) | 同步后前端继续以服务端为真源;`peekTodayWords/peekReviewTask` 的启发式退役,书架三条引导(今天读这本 / 今天练这些词 / 还要再练)全部改读 `/api/plan/today`。 ## 12. 指标定义(报告用) | 指标 | 定义 | | --- | --- | | 完成率 | 完成卡数 / 计划卡数(周:按工作日累计) | | 首次正确率 | correct / (correct + pass + wrong),排除 hasty、noSignal | | 掌握数 | 状态 ∈ {monthly, mastered} 的 word 项数(周报报「本周新增」) | | 回落率 | 本周 lapse 次数 / 本周周测题数 | | 薄弱项 | 近 14 天 wrongCount 增量 Top 5(词)与 Top 3(音素);混淆对按 confusionWeight | | 口语均分 | 近 7 天 speaking 事件 score 的均值(按 word/sentence 分开) | | 疑似随意作答 | hasty 事件数与触发「降温」次数 | | Starters 覆盖 | `starters-words.json` 中出现过 correct 事件的词占比 | | 连续天数 | 见 03 §5 | ## 13. 可配置参数(`profile.json`) ```json { "childId": "default", "nick": "小丫", "dailyMinutes": 20, "schedule": {"weekday": "19:30", "nudge": "20:15", "evening": "20:45", "saturday": "10:00", "weeklyReport": "20:00"}, "limits": {"newPerDay": 6, "reviewPerDay": 12, "quizQuestions": 5, "fridayQuestions": 10, "weeklyTest": 15, "monthlyTest": 20}, "thresholds": {"wordScore": 70, "sentenceScore": 65, "hastyMs": 1500, "bookUnknownMax": 3}, "windows": {"learningDays": 3, "learningExtendMax": 2, "weeklyDays": 7, "weeklyJitterDays": 1, "monthlyDays": 30, "masteredRecheckDays": 90}, "streak": {"minCardsForDay": 4, "graceDaysPerWeek": 1}, "cursors": {"phonicsWeek": 1, "ortIndex": 0, "ortDay": 1, "letterIndex": 0}, "level": "standard", "publicBaseUrl": "https://estudy.home/estudy" } ``` ## 14. 待用户确认 1. 通过线:词 70 / 句 65 是否合适(初期可放宽到 60/55,两周后按均分校准)。 2. `mastered` 是否需要 90 天抽检,还是「进入 mastered 即不再复习」。 3. 迁移时把现有「已掌握」降为 `weekly` 需再考一次——是否接受(会让第一周周测题偏多)。