# 产品设计方案 - 日期 / 轮次:2026-09-06 / 第 1 轮 - 输入:00-request.md、10-analysis.md@第 1 轮 - 应用的历史教训:无 - 结论:方案完成,交 UI/UX(阶段 4 体验审查通过后停在「原型确认停点」,用户确认前不得开发) ## 我对需求的独立理解 本需求要把“读完一本绘本”自然延伸为一次适合 6 岁儿童的拼写测验:大人先为具体绘本维护重点单词与相关句子,孩子读完这本书后,通过听词、从有限且乱序的字母块中依次点选来拼出目标词;候选区加入 1–2 个有辨析价值的干扰字母,以测到孩子是否真的记住拼写,而不是测键盘操作。功能应分别落在现有家长校对区与孩子读后闭环中,并且本轮只交付可确认的设计,不进入开发。 ## 上游核对 ### 核对结论 核心诉求与我的独立理解一致,P0-1 至 P0-8 均可直接支撑产品设计;儿童画像中“不打字、字母不熟、易混字母、大热区、少文字”等能力边界足以支撑有限候选、听觉引导和低惩罚交互。逐条核对无偏离,无需退回需求分析。 ### 逐条核对与本方案落点 - P0-1 / U10:由大人在每本书的校对页维护重点单词和重点句子,后端按书持久化。 - P0-2 / U20、U80:默写入口放在现有读后检测完成态,不增加孩子底栏入口。 - P0-3 / U30:每轮只从当前书“可出题”的重点单词中随机、不重复抽取。 - P0-4 / U40、U50:完整保留目标词每个字母及重复次数,乱序后加入 1–2 个同类元音或易混辅音。 - P0-5 / U60:全程只点有限字母块,不出现文本输入框和 26 字母键盘。 - P0-6 / U70:记录首次成词是否正确,并在本轮结果中区分“自己拼对”和“再试后拼对”。 - P0-7 / U10、U20、U80:配置归大人校对区,游戏归孩子读后路径,角色控件不混用。 - P0-8 / U90:本方案交 UI/UX 后只能继续原型和体验审查;阶段 4 通过后必须等待用户确认。 - P1-1:没有可出题单词时,不显示孩子默写入口;大人侧说明需要补充什么。 - P1-2:重复字母视为独立字母块,判题只比较目标标准拼写,随机算法必须保留可解性。 ### 自行补齐的小缺口与待用户确认决策 以下均未改变诉求与范围,作为本轮明确设计提案,需在原型确认停点由用户一并确认: 1. **录入者角色**:V1 定为能进入校对模式的大人;不另建“老师”角色。 2. **句子用途**:句子作为单词的可选语境,不做句子级默写,也不自动拆句生成题目。 3. **入口时机**:放在现有读后检测完成态,避免孩子翻到末页时被同时出现的多个任务分流。 4. **单轮题数**:最多 5 题;不足 5 个时全部出题且不重复。 5. **提示方式**:单词音频为必备主提示;可选语境通过“听听书里的话”播放或由后续 UI/UX 选择不泄露拼写的呈现方式,不能直接显示目标单词。 6. **纠错口径**:填满目标长度后判定;允许撤回;首次填满即记录测验结果,后续改对不覆盖首次错误。 7. **结果范围**:V1 显示本轮词级结果,并复用当前每书学习状态保存在本机;跨设备默写历史和统计报表留到 V2。 8. **可出题字符**:V1 仅接受规范化后为 `a-z` 的单个英文单词;连字符、撇号、数字及多词短语不能标记为可出题。 ## 功能清单(追溯矩阵) | # | 功能 | 优先级 | 对应诉求# | 说明 | | --- | --- | --- | --- | --- | | F01 | 每书重点内容管理 | P0 | P0-1、P0-7 / U10、U80 | 在家长校对区为当前绘本新增、编辑、删除重点单词与重点句子,保存后仍与该书稳定关联。 | | F02 | 单词可出题校验 | P0 | P0-1、P1-1 / U10、U30 | 仅 `a-z` 单词可标记为默写题;重复项、空值和非法字符在保存前明确提示。 | | F03 | 读后默写入口 | P0 | P0-2、P0-7 / U20、U80 | 读后检测完成态显示主行动“玩拼字”;无可用词时不显示该入口。 | | F04 | 当前书随机组题 | P0 | P0-3、P1-2 / U30 | 从当前书可出题单词随机抽取,单轮最多 5 题且不重复;不同书互不混入。 | | F05 | 听音识词 | P0 | P0-5、P0-6 / U60、U70 | 每题进入时自动播一次,提供可反复点击的大热区“再听一次”,不展示目标拼写。 | | F06 | 乱序字母与干扰项 | P0 | P0-4、P1-2 / U40、U50 | 保留目标所需字母及重复次数,加入 1–2 个有效干扰后整体洗牌。 | | F07 | 点字母拼写与撤回 | P0 | P0-5、P1-2 / U60、U70 | 点击候选字母依次进入答案槽;已选块不可重复用;支持撤回最后一个;无需键盘。 | | F08 | 判题与温和纠错 | P0 | P0-6 / U70 | 填满目标长度自动判题;正确后继续,错误时保留答案、提示再听/撤回,不扣命、不计时。 | | F09 | 本轮测验结果 | P0 | P0-6 / U70 | 结束页按词区分“自己拼对”“再试后拼对”,并可重练本轮错词。 | | F10 | 内容后端持久化 | P0 | P0-1、P0-3 / U10、U30 | 重点词句是每书内容配置,由后端 JSON 持久化,保证大人配置与孩子读取同一来源。 | | F11 | 原型确认门禁 | P0 | P0-8 / U90 | 原型须覆盖配置、读后入口、作答、纠错、结果与空状态;用户确认前不开发。 | | F12 | 语境关联 | P1 | P0-3、P0-6 / U30、U70 | 每个重点单词可关联一条重点句;题中仅以不泄露拼写的方式提供辅助语境。 | | F13 | 本机学习状态融合 | P1 | P0-6 / U70 | 将首次正确/错误写入该书现有学习状态,标记来源为 spelling,供同设备后续练习使用。 | | F14 | 家长查看近期错词 | P1 | P0-6、P0-7 / U70、U80 | 家长“学习情况”展示本机最近默写错词;不新增复杂统计报表。 | | F15 | 再玩一轮 | P2 | P0-3、P0-6 / U30、U70 | 结果页可重新随机组题,适合主动复练。 | ### 版本边界 - **V1(本轮详细设计)**:F01–F14;其中 F01–F11 是完成定义,F12–F14 为重要增强,可在排期受限时后置,但不得削弱 P0 验收。 - **V2(不在本轮)**:句子逐词默写、自动从句子抽词、跨设备默写历史、趋势报表、每日复习编排、多孩子/教师/班级管理、排行榜、限时和生命值。 ## 信息架构 ### 大人侧 `书架长按小熊 → 校对模式 → 学习情况 / 选书校对 → 当前绘本校对页 → 重点词句` - 入口沿用现有大人通道,不占孩子底栏。 - 在 `/parent/review/:id` 增加同页模块或页内切换“重点词句”,不新建一套孤立的内容后台。 - 当前书标题和封面始终可见,降低把内容录到错误绘本的风险。 - 内容分为“重点单词”和“重点句子”两组;单词可关联一条句子。只有通过校验并启用的单词进入题库。 ### 孩子侧 `书架 → 阅读页 → 读后检测 → 完成卡 → 玩拼字 → 默写游戏 → 本轮结果` - 阅读页继续沉浸且无底栏。 - 孩子底栏仍只有“看书 / 拼读 / 闯关”;默写是当前绘本的读后活动,不设第四项。 - 完成卡以“玩拼字”为主行动,同时保留“去拼读”和“返回书架”为次级选择,具体视觉层级由 UI/UX 解决,但三个动作不能等权堆叠。 - 本轮结果可“再练错的”或“回书架”;没有错词时只突出“完成啦,回书架”。 ## 核心流程 ### 流程 A:大人配置重点内容 1. **进入当前书校对页**:大人在校对模式选中绘本,打开“重点词句”。 2. **添加重点单词**:输入一个单词;系统自动转小写并去除首尾空格,实时校验是否为单个 `a-z` 单词及是否重复。 3. **补充可选语境**:可选择已有重点句或输入一句相关句子;句子仅帮助理解,不自动进入题库。 4. **确认可出题状态**:合法单词默认启用;不支持的形式明确显示原因,不允许静默保存为可出题项。 5. **保存**:整组内容保存到当前书;成功后显示已保存状态,失败则保留未保存编辑内容并可重试。 6. **预览题库**:显示“这本书可出 X 个拼字题”,让大人在离开前发现空题库。 ### 流程 B:孩子完成读后默写 1. **完成阅读与现有读后检测(阅读页)**:系统取得当前书 ID。 2. **进入完成卡(阅读页完成态)**:若题库非空,显示“玩拼字”;为空则不显示,避免进入死路。 3. **开始一轮(默写游戏页)**:系统从当前书随机抽取最多 5 个不重复单词;显示“第 1 / N 个”并自动播放目标音频。 4. **听词(默写游戏页)**:孩子可点大按钮重复听;题面不显示目标词文本。 5. **拼词(默写游戏页)**:点击乱序候选字母,字母按顺序进入固定数量答案槽;点“退一步”撤回末位。 6. **判题(默写游戏页)**:答案槽填满后自动比较标准拼写,并记录首次完成结果。 7. **纠错(默写游戏页)**: - 正确:给简短正反馈后进入下一题。 - 错误:不清空、不扣分;提示“再听听,改一改”,允许撤回继续。后续拼对记为“再试后拼对”。 8. **查看结果(结果页)**:展示完成数量和需再练的词;孩子可只重练首次拼错的词或回书架。 ### 干扰项与组题规则 1. 目标词长度 2–4 个字母时加入 1 个干扰字母;5 个及以上加入 2 个。 2. 优先选择与目标中某字母同类的元音干扰,如 `wanted` 的候选可加入 `o`、`i`;其次使用现有易混辅音规则,如 `b/p/d/q`。 3. 干扰字母不与目标词现有字母相同,因为增加同字母副本没有可见辨析价值。 4. 允许候选字母组成其他真实近形词(例如 `want/wont`),这正是辨析的一部分;目标由音频和当前题答案唯一确定,判题只接受目标词。 5. 若规则无法生成足量的高价值干扰项,则从未出现在目标中的常见字母补足,但不得少于 1 个或多于 2 个。 6. 每个目标字母(含重复字母)对应一个独立可点击字母块;洗牌后若恰好仍为目标顺序,必须重新洗牌,达到重试上限后进行确定性交换。 ## 数据与状态 ### 后端持久化:每书重点内容 建议按现有 JSON 数据模式新增每书重点内容存储,由书籍唯一标识(`stage + folder`)索引,采用线程锁与临时文件替换,避免并发写坏文件。 每书至少包含: - `book_id`:稳定书籍标识。 - `version`:数据结构版本。 - `words[]`: - `id`:条目稳定 ID,避免改词后结果错误关联。 - `text`:原始展示值。 - `normalized`:用于判题的小写 `a-z` 值。 - `enabled`:是否进入题库。 - `sentence_id`:可选语境关联。 - `created_at`、`updated_at`。 - `sentences[]`: - `id`、`text`、`created_at`、`updated_at`。 - `updated_at`。 读取状态:`loading → ready / empty / error`;编辑状态:`clean → dirty → saving → saved / save_error`。切书或离开页面时如为 `dirty`,必须提醒大人保存或放弃。 ### 前端当轮临时状态 - `bookId`、本轮题目快照 `questionWordIds[]`。 - `currentIndex`、当前候选字母块(含唯一 tile ID)、已选 tile ID 顺序。 - 每题 `firstAttemptCorrect`、`mistakeCount`、`completed`。 - 音频状态 `idle / playing / fallback / unavailable`。 题目开始后使用快照,不因大人同时修改题库而在本轮中途换题。刷新或意外退出 V1 不强制恢复到题中,重新进入生成新一轮;已完成题的学习结果应即时落本机,避免整轮退出后全部丢失。 ### 本机学习状态 沿用每书学习状态的现有 localStorage 机制,新增或扩展词级来源: - `source: spelling` - `wordId` 与 `normalizedWord` - `firstAttemptCorrect` - `mistakeCount` - `answeredAt` - `roundId` 首次成词即写入结果;纠错后完成可补记 `completedAfterRetry`,但不得把首次错误改成首次正确。F14 家长近期错词仅代表当前设备数据,界面不得暗示跨设备完整统计。 ### 状态流转 - 配置条目:`草稿/非法 → 可保存 → 已启用 / 已停用 → 已删除`。 - 单题:`待播放 → 作答中 → 首次判题正确 / 首次判题错误 → 纠错中 → 已完成`。 - 一轮:`组题中 → 进行中 → 已完成`;题库为空或加载失败不得进入“进行中”。 ## 异常与边界 ### 大人配置侧 - **当前书无重点内容**:给出“添加第一个重点单词”的明确行动,并说明只有单词会出现在拼字游戏。 - **非法单词**:多词、数字、连字符、撇号或其他字符不能启用,指出具体原因;不自动删字符后保存。 - **重复单词**:按 `normalized` 去重,如 `Want` 与 `want` 视为重复。 - **保存失败**:保留当前编辑内容,展示重试;不得假装已保存。 - **切书/离开时未保存**:要求大人选择继续编辑或放弃更改。 - **删除已有关联句子**:只解除单词的语境关联,不删除单词;删除句子前说明受影响条目数。 ### 孩子游戏侧 - **无可用词**:读后不显示默写入口;若通过旧链接直接进入,显示儿童可理解的“这本书还没有拼字,先回书架吧”,只有返回行动。 - **只有 1–4 个词**:全部出题,不复制题目凑满 5 题。 - **含重复字母**:每个重复字母有独立块,答案所需数量必须完整。 - **题库读取失败**:不进入空白游戏,提供“再试一次”和“回书架”。 - **单词音频主源失败**:按现有本地音频 → TTS → 浏览器语音逐级回退;全部不可用时,该词本轮跳过且不计错。若无题可用,友好结束并回书架。 - **误触**:支持撤回最后一个;选满前不判错。 - **连续答错**:不出现红叉轰炸、倒计时、扣命或强制失败;始终允许再听和撤回。UI/UX 可在多次错误后提供更强听觉或音素提示,但不能直接把完整答案按顺序展示后仍记为独立拼对。 - **退出/刷新**:已经首次判题的题保留记录;未完成题不计对错。 - **配置中途变化**:进行中的一轮使用开始时快照;下一轮才读取新配置。 ## 给 UI/UX 与开发的硬约束 1. 原型至少覆盖:大人空配置、添加并保存、读后完成卡、正常题、含重复字母题、首次错误后的纠错、结果页、孩子无题状态。 2. 面向孩子的可点击区域必须适合 6 岁儿童,核心字母块和“再听一次”须为大热区;页面少文字,不能出现 `Quiz`、`Learn`、`M3`、`spelling` 等黑话。 3. 每题进入自动播音,并保证一步可重复听音;不能显示目标单词或按顺序揭示所有目标字母。 4. 不使用输入框、不唤起软键盘、不增加孩子底栏第四项。 5. 候选字母必须同时包含目标字母完整多重集和额外 1–2 个干扰项;重复字母块必须拥有不同内部 ID。 6. 首次填满答案槽即形成能力测验记录;撤回重试是学习支持,不能篡改首次结果。 7. 大人配置内容以后端为唯一事实来源;本轮作答过程和既有学习状态留在前端本机。界面必须准确表达数据范围。 8. 游戏开始时冻结题目快照,避免配置并发变化导致当前题无解。 9. 正确/错误不能只靠颜色表达;须配合图形、文字或声音。 10. 不复制造轮子:乱序、易混字母、单词发音和现有每书学习状态优先复用现有能力,但实现必须满足本方案新增的字母级、干扰项和首次作答口径。 11. 阶段 4 体验审查完成后必须停止流水线并向用户展示设计与原型;没有用户明确确认,不得开始产品代码开发、测试或验收。 ## 诉求双向核对 ### 防漏:上游诉求到功能 - P0-1 → F01、F02、F10 - P0-2 → F03 - P0-3 → F04、F10 - P0-4 → F06 - P0-5 → F05、F07 - P0-6 → F05、F07、F08、F09 - P0-7 → F01、F03 - P0-8 → F11 - P1-1 → F02、F03 - P1-2 → F04、F06、F07 所有上游条目均有功能落点。 ### 防跑偏:功能到上游 F01–F15 均已在功能清单中标注对应 P0/P1 与 U 编号;F12–F15 属于支撑语境、结果可用性和复练的增强,不引入句子级默写、复杂统计或通用题库。无不可追溯功能。 ## 本轮改动 第 1 轮,无审查或验收返工意见。已将上游 10 个开放问题收敛为可供用户确认的 V1 决策,并明确开发前确认门禁。