# 练习页(/app/game)布局与功能 - 页面:`https://www.tanqudao.com/app/game`(无 query;课节上下文在内存 / 本地状态) - 捕获:2026-10-10 23:37–23:42(UTC+8),视口约 1356×799 - 入口:课程详情 `c-mn15edqe-qirc12` → Lesson 1 → 弹层选「拼图模式」→ 本页 - 课节:Lesson 1 Morning Wake-Up(`l-mn15jfdn-ikcigx`) ## 顶栏 | 控件 | 作用 | |---|---| | 返回 | 回到课程详情 | | 标题 | `Lesson 1: …(当前题/总题数)`,拆句约 62 题,整句打字约 17 题 | | 设置 | 打开 `app-settings-popup`(发音 / 音效 / 答题 / 快捷键) | | 切换模式 | 下拉:中译英、听写、打字练习、拼图模式 | | 学习内容 | 打开整句列表弹层(详见 `-app-game-顶栏功能.md` §2) | | 重置进度 | 确认弹层「确定要重置吗?」(详见 §4) | | 个性化 | 独立弹层:颜色/特效/字号(详见 §3) | | 报错 | 错误上报弹层(英文/中文、多选原因、补充说明) | | 沉浸模式 | 隐藏侧栏类 UI | | 全屏 | 浏览器全屏 | | 计时 | 右上角练习时长(如 `01:48`),后台周期性 `POST /api/practice/add-time` | ## 练习变体(拆句 / 整句) 顶栏下方胶囊: - **拆句练习** / **整句练习**(互斥,`pressed` 表示当前) - 与 `GET /api/practice/full-source` 的 `mode: split` 及 `GET /api/lesson-sheet?…&practice=split` 对应 - 课程详情弹层另有「整句练习 / 拆句练习」文案(与四种模式正交) ## 显示图片 - 类型:`switch`,默认 **开**(`checked`) - 作用:答题区是否展示课节配图(OSS `course-images`) ## 四种游戏模式(UI 名称 → progress.mode) | UI | progress.mode | 题目数据 | 核心交互 | |---|---|---|---| | 拼图模式 | `listening` | `lesson-sheet` + `practice=split` | 词块按钮(如 Wake / up / morning / It's),点选拼句;底部无 Enter 提交条 | | 听写模式 | `dictation` | 同上 | 中文/音频提示;多格 `第 N 个单词` 输入框 | | 中译英模式 | `c2e` | 同上 | 中文提示(如「起床啦!」);分词输入 + IPA/词性/句法 | | 打字练习 | `typing` | 整句级(本题 1/17) | 单行「打字练习输入框」+ 屏幕键盘 + 手型图 | 切换模式会 `POST /api/practice/progress` 写入 `mode`;偏好里「切换模式重头开始」默认 **开**(`restartOnModeSwitch: true`)。 ## 底栏快捷键提示(页面按钮文案) ### 拼图 / 听写 / 中译英(共用为主) | 键 | 功能 | |---|---| | Ctrl+A | 朗读 | | Ctrl+Q | 标记不熟悉 | | ↓ / ↑ | 显示 / 隐藏答案 | | Shift+← / Shift+→ | 上一题 / 下一题 | | Ctrl+; | 再来一次(重开本题) | | `< 上一题` / `下一题 >` | 切题按钮 | 听写 / 中译英额外: | 键 | 功能 | |---|---| | 空格 / ←→ | 跳格(单词输入框间) | | Enter / 空格 | 提交当前答案 | ### 打字练习 | 键 | 功能 | |---|---| | Ctrl+A | 朗读 | | 空格 | 隐藏答案 | | Shift+← / Shift+→ | 切题 | | Ctrl+; | 再来一次 | ## 设置面板(右上角「设置」) 默认打开 **音效** tab;`GET /api/settings/display` 控制 tab 可见性(`pronunciation/sound/quiz/hotkeys` 均为 true)。 ### 发音 | 项 | 类型 | 当前值 | 作用 | |---|---|---|---| | 切题后自动朗读 | switch | 开 | 切题后 TTS | | 答题正确后朗读 | switch | 开 | 答对后 TTS | | 朗读次数 | − / + | 1 次 | | | 朗读间隔 | − / + | 1 秒 | | | 发音人语速 | − / + | 1.0x | | | 发音人音量 | − / + | 100 | | ### 音效(每项:开关 + 音效「默认」+ 音量滑条 0–100) - 打字音效、手动切题音效、答题正确、答题错误、课程完成 - 清单与 URL:`GET /api/sound-effects` - 用户偏好键:`__APP_SOUND_EFFECT_PREFS__`(见 `-api-auth-settings.md`) ### 答题 | 项 | 类型 | 当前值 | 作用 | |---|---|---|---| | 答题正确后自动下一题 | switch | 关 | `autoAdvanceOnCorrect: false` | | 正确自动跳格 | switch | 关 | | | 切换模式重头开始 | switch | **开** | `restartOnModeSwitch: true` | | 答案弹窗自动显示 | switch | 开 | | | 错误几次时显示答案 | 下拉 | 错误 3 次后 | 可选:从不 / 1–5 次 | ### 快捷键(可自定义,默认如下) | 功能 | 默认绑定 | 说明 | |---|---|---| | 播放朗读 | Ctrl+A | 每项旁有「编辑」 | | 标记不熟悉 | Ctrl+Q | | | 显示答案 | ↓ / ↑ | | | 再来一次 | Ctrl+; | | 限制文案:**不能**用单个字母;**不能**用 Shift+字母/字符等系统组合。 页脚另有 **恢复默认**(当前 tab)。 ## 侧栏 / 其他弹层(DOM 存在) - `mode-popup`:与详情页相同的四模式 + 「整句练习 / 拆句练习」 - `report-popup`:报错 - `reset-popup`:重置进度确认 ## 本页主要接口 见 `00-调用顺序.md` 序号 98 起;单接口文件: - `-api-practice-enter.md` - `-api-practice-progress.md` - `-api-practice-add-time.md` - `-api-lesson-sheet.md` - `-api-practice-full-source.md` - `-api-settings-display.md` - `-api-sound-effects.md` - `-api-storage-settings.md` - `-api-course-always-text.md` - `-api-course-images-settings.md` - `-api-stats-study-time.md` 打字键盘细节:`-typing-practice.md`;资源:`assets/typing-hands-*.svg`。