# 前端开发记录 - 日期 / 轮次:2026-09-06 / 第 2 轮 - 输入:prototype/、30-uiux.md@第 2 轮、50-backend.md、60-test.md@第 1 轮、OpenSpec `book-word-spelling-game` - 应用的历史教训:无 - 结论:可进测试 ## 上游核对 - 已逐条核对 00-request、10-analysis、20-product、30-uiux、50-backend、两份 OpenSpec spec 与 60-test 第 1 轮全文。 - Bug #1 按主 agent 22:25 裁决接通两条大人路径:校对模式阅读器顶栏与家长「学习情况」按书卡片均进入 `/parent/review/:id?tab=key-words`;没有把成人入口或文案放进孩子阅读流程。 - GET/PUT 重点词句契约未变,本轮无 mock、无后端改动。未保存离开保护继续以 OpenSpec `bookshelf-book-key-words` 为准;音频迟到失败隔离继续满足 `bookshelf-spelling-game`「音频全失败」场景。 ## 页面与组件清单(对照原型) | 原型页面 | 实现文件 | 覆盖交互 | 状态 | | --- | --- | --- | --- | | 大人入口与重点词句 | `BookReader.tsx`、`Dashboard.tsx`、`BookTextReview.tsx`、`KeyWordsPanel.tsx` | 两条产品内入口、页签深链、脏状态返回保护、删除后清错 | 完成 | | 拼字游戏 | `SpellingGame.tsx`、`SpellingGame.css` | 自动听音、慢失败按题隔离、过期加载丢弃、横屏内部滚动 | 完成 | | 空状态与本轮结果 | `SpellingGame.tsx` | 唯一返回动作使用主按钮;全对时突出完成按钮 | 完成 | | 家长学习情况 | `Dashboard.tsx` | 按书进入重点词句、拼错词级别中文化 | 完成 | ## 接口对接清单 | 交互 | 接口 | 状态(真实 / mock+原因) | | --- | --- | --- | | 家长读取重点词句 | `GET /api/books/{stage}/{book_folder}/key-words` | 真实 | | 家长整体保存重点词句 | `PUT /api/books/{stage}/{book_folder}/key-words` | 真实 | | 孩子开局读取并冻结题目 | 同一 GET + 前端纯函数 | 真实 | | 单词试听/题目听音 | 现有 `playWordAudio` 回退链 | 真实;浏览器竞态复验使用受控慢失败桩 | | 拼字结果与家长错词 | 当前浏览器 localStorage | 真实,符合 V1 本机口径 | ## 与原型差异 | 差异 | 理由 | | --- | --- | | 在现有校对阅读器与家长按书卡片补「重点词句」入口 | 原型从重点词句页开始演示;真实产品必须落实 20-product 信息架构的两条到达路径 | | 横屏时拼字页可在沉浸容器内纵向滚动 | 390px 高视口无法同时容纳题面与字母区;滚动保证所有核心操作可达,不改变交互顺序 | ## 自测记录 - `npx tsc --noEmit -p tsconfig.app.json`:通过。 - `npm run build`:通过(TypeScript + Vite)。 - IDE lint:本轮改动文件无诊断。 - 浏览器统一入口 `http://127.0.0.1/` 复验: - `/book/stage-03__AtTheSeaside` 顶栏「重点词句」进入正确深链;`/parent` 的最近阅读/学习进度按书卡片均有同一入口。 - 重点词句页不显示文本页翻页器;重复 `Wanted` 提示后删除 `wanted`,提示立即恢复为「输入后会自动转为小写」。 - 删除词形成脏状态后点 ParentLayout「← 回书架」,停留原页并显示「继续编辑 / 放弃更改」;放弃后恢复最近保存内容并回书架。 - 844×390 下 `.spelling-page` `clientHeight=384`、`scrollHeight=666`、可滚动 282px;字母块从视口外滚入后 `bottom=256.75 < 390`。 - StrictMode 两次 GET 下,2.5 秒前后候选字母序列一致,过期请求不再替换回合。 - 受控慢失败复现:首题 `shell` 拼对后进入「第 2 / 3 个」,等待上一题失败迟到后仍停在「第 2 / 3 个」,无「听不到」提示,下一题未被跳过。 - 无题库页「回书架」为橙色主按钮;三题全对结果页「完成,回书架」为橙色主按钮且无复练按钮。 - 最近拼错词卡显示「第3级」,该卡片内不再出现 `stage-03`。 ## 本轮改动(返工轮必填:对应 60-test.md 哪条 bug) - Bug #1(P0):`BookReader` 校对顶栏新增家长语义「重点词句」;`Dashboard` 最近阅读和学习进度的每本书新增同名深链。浏览器验证两类入口均指向 `/parent/review/:id?tab=key-words`。 - Bug #2(P1):`ParentLayout` 回书架改为可被当前校对页拦截的导航事件;`BookTextReview` 在有草稿时复用既有 `runWithDirtyGuard`。浏览器验证顶栏返回出现双分支确认。 - Bug #3(P1):每次播放绑定 `audioAttempt + wordId`;切题或答对即作废旧播放,迟到 reject 只可跳过发起播放的当前题。浏览器以慢失败桩验证 Q1 迟到失败不会跳过 Q2。 - Bug #4(P2):拼字页改为沉浸容器内 `flex:1; min-height:0; overflow-y:auto`。浏览器 844×390 验证字母块与退一步可滚动到视口。 - Bug #5(P2):题库加载增加请求代次;StrictMode 清理时作废旧请求,仅最后一次响应可组题。浏览器验证候选字母 2.5 秒前后不变。 - Bug #6(P2):无题库页唯一「回书架」及全对结果页唯一「完成,回书架」改为主按钮;有错词时仍保持复练为主、回书架为次。浏览器验证主按钮样式。 - Bug #7(P2):家长最近拼错词级别用 `第N级` 中文格式。浏览器验证卡片为「第3级」且无原始 `stage-03`。 - Bug #8(P2):内容页翻页器只在「文本校对」页签渲染。浏览器验证「重点词句」页签无无关翻页控件。 - Bug #9(P2):删除单词时同步清空添加框旧错误。浏览器按“重复 Want → 删除 want”步骤验证提示已清除。