# 明璨的口语本 · Speak Up 1

用浏览器打开本文件夹的 [index.html](index.html)。这一版只加入第一册，不包含第二、第三册。

## 怎么练

1. 点“开始今日口语”，先听英语问题。
2. 问题完整读完后，默认显示两种中英对照参考回答：“先说一句”和“试着多说一点”。参考回答可分别点读。
3. 鼓励孩子把人名、爱好和生活细节换成自己的，不必逐字照背。
4. 孩子或家长选择“还想再练 / 提示后会说 / 我能自己说”，进入下一题。

如果想先自己回答，到“我的问题库”取消“问题读完，自动展开参考回答”。这样听完后，需要自己点“我说好了，查看参考回答”。“看问题与中文提示”只显示题目，不提前显示参考回答。

可以先保持默认的第 1 单元、每轮 6 题、每天 1 轮。熟悉后在“目前学到”逐步增加单元。每题先能说一句，再尝试多说一个细节。这是网站的入门使用安排，不是能力测评标准。

## 这一版有什么

- 36 道独立问答：第一册 10 个单元的 33 道提炼与改编题，以及年龄、年级、今天感受 3 道补充题。
- 每题两种参考回答、中译、可替换句式和家长提示。
- 保留 Sonia 英式女声、Jenny 美式女声；问题和回答共 216 段 MP3。
- 每轮 3–15 题、每天 1–3 轮；同一轮内题目不重复。
- 问题库支持按单元、练习状态和关键词筛选，任何单元都能单独点题练习。
- 今日练习可以中途退出，或关闭网页后继续。已经评价过的题即时保存。
- 学习记录可以导出、导入 JSON 备份。导入前会提醒替换当前记录。

## 复习怎样安排

“目前学到”限定每日练习和“再练不熟的”的范围；开口准备题始终包含。问题库的单题练习不受此限制。

每日练习依次选择：已到期的问题、还没练过的新题、尚未到期但可以再巩固的旧题。如果当前范围不足设定题数，本轮会少一些，不凑重复题。“每天安排”是计划轮数，单题练习和巩固练习不占每日轮次。

能独立回答的题在首次练习或到期复习后，按 1、2、4、7、15、30 个自然日逐步拉长间隔。未到期提前练习，不会跳过复习阶段。提示后会说、还想再练的题安排第二天再见面。题数有限时，旧题也可能作为补足练习提前出现。

暂停中的每日练习保留原题目和位置，调整题数、学习范围只影响下一轮。单独点题不会覆盖暂停中的每日练习。口音与语速可以随时切换。

“可以独立说”统计最近一次自评为独立回答的题数；不是自动语音评分，也不代表永久掌握。网站不录音、不使用麦克风、不将孩子的声音上传。

## 声音与离线使用

发音仍使用微软神经网络合成语音，不是真人录音；与上一版是相同的 Sonia 和 Jenny 音色。所有 MP3 已生成在本地，播放时不需要联网、登录或付费。

请保持这些文件在一起：

~~~
英语网站/
├─ index.html
├─ assets/                 页面样式、逻辑、第一册题库
├─ audio/
│  └─ speaking/            第一册两种音色的完整 MP3
├─ classroom.html          原来的课堂常用语
└─ 口语本使用说明.md
~~~

复制或移动时，最简单的方式是复制整个“英语网站”文件夹。仅复制 index.html 会丢失样式、题库和声音。原来的课堂常用语还使用 audio 内另外两组音频，请一并保留。

如果浏览器阻止自动播放，点击“再听问题”。音频确实缺失时，页面会提示检查 audio 文件夹，也提供“先看题练习”，不会假装音频已经播放完。

本地文件可离线使用。将来如果上传到网站，首次访问仍需要网络；此版本没有实现网页离线缓存。移动端需能访问完整文件夹，或由后续的网站地址访问。

## 记录和隐私

进度和设置只保存在当前浏览器的本地存储中，没有云同步。不同设备、不同浏览器、本地文件与网站地址可能各有独立记录；移动文件、清除浏览器数据或无痕模式也可能使记录无法保留。更换使用环境前，请在“学习记录”导出备份。

问题中的 Ben、Sam 等是示例名字，不要求填写孩子真实身份。生成音频时只使用题库里的通用英语问句和示例答案，日常练习不发送姓名、进度或录音。

学习记录保留最近 10,000 次问答和最近 3,000 轮汇总；累计练习次数仍由每题统计保留。建议定期导出备份。

## 教材来源

依据用户提供的 SU_SB1_Script_AnswerKey.pdf 提炼。保留第一册问句和表达目标，将依赖课本图片、特定角色的内容改为孩子可以独立回答的生活问题。示例回答为适龄改写，不是教材固定答案。每题在参考区域标明来源单元及 PDF 文件页码。

| 单元 | 主题 | PDF 文件页码 |
| --- | --- | --- |
| 1 | 认识我 | 2 |
| 2 | 我的好朋友 | 2 |
| 3 | 天气与衣物 | 3 |
| 4 | 我的家人 | 3 |
| 5 | 我的兴趣 | 4 |
| 6 | 我的房间 | 4 |
| 7 | 找找东西 | 5 |
| 8 | 日常规则 | 5 |
| 9 | 打电话 | 6 |
| 10 | 学校生活 | 6（另参考第 7 页口语示例） |

第二、第三册留到以后迭代，不混入本次题库。

## 文件维护

- 题库源文件：content/questions.json
- 生成页面题库：node tools/build_speaking_data.cjs
- 生成或补齐口语音频：python tools/generate_speaking_audio.py，需要安装 edge-tts 并联网。已有匹配音频会复用。
- 原课堂常用语音频工具：tools/generate_audio.py，读取 classroom.html。
- 旧入口完整备份：备份/index-before-speaking-20260911.html。也可直接打开 classroom.html 使用原版。
- 本地检查：node tools/test_speaking.cjs；加 --media 可使用 ffmpeg 检查全部 MP3。

新增或修改英语内容后，应同时重新生成题库和对应音频，避免文字与朗读不一致。