# PTE 单词本

入口为 `../word.html`，首页工具栏有独立入口，不计入 19 种考试题型。

界面为独立词表，默认 A–Z 排序并选中首字母 A，不提供“全部字母”按钮，至少保留一个字母选中；每行集中展示单词、音标、释义、最近分数、练习次数及发音/评分操作。不加载或跳转题型页面，也不展示例句；发布词库不包含原题例句。支持首字母多选（例如 A 和 M）与自定义连续字母范围（例如 C–F），可与搜索、练习状态组合筛选。点击单词可在下方紧凑练习区编辑释义、查看最佳分数和历史；已有存储键保持兼容。

列表不分页：全部筛选结果一次生成，在词表内部连续滚动浏览。切换单词和录音状态不再整表重绘；评分完成更新筛选结果时保留滚动位置。

显示采用高对比度深蓝/白色配色，主要文字和操作按钮的文字对比度超过 4.5:1。PC（宽度超过 1200px）展示表格；平板展示双列词卡；手机（650px 及以下）展示单列词卡。单词字号为 23–25px，主要释义为 17–18px，主要按钮触控高度至少 44px；连续滚动和字母筛选在三种布局共用相同数据与练习记录。

手机端（650px 及以下）采用一屏一张卡与固定底部操作栏：上一词、发音、评分、下一词均放在底部，并适配手机安全区域。卡片显示单词、音标、可竖向滚动的释义、最近分数与练习次数。左右滑动切词，短距离拖动回弹；竖向拖动阅读释义。屏幕左右各 24px 不启动切词，减少与系统返回手势冲突。录音和评分时锁定切词；评分按钮在录音时变为结束，在加载或等待时变为取消。首尾不循环，空结果不允许录音。PC 与平板仍保留全部词汇连续滚动。

手机顶部字母按钮打开底部 A–Z 抽屉，单选后自动收起；也可开启多选或设置连续字母范围。搜索和练习状态筛选也在该抽屉内。更多抽屉包含统计、语音设置、导出、随机练习、历史、录音回听及词典来源。切换到 PC 或平板时将原控件恢复原位，共用同一份状态和存储。

手机端通过箭头、滑动、字母筛选或随机练习切换当前词时自动朗读，沿用所选音色和缓存；页面初始化及评分完成后的后台筛选不触发自动朗读。长按选中页面中的单个英文词也可朗读：选区稳定 300ms 后触发，重复选区事件不重复播放，排除输入框、下拉框及按钮。选词优先于滑动切词，录音或评分期间不触发。PC/平板仍保持手动发音。执行 `node tests/word-autoread.cjs` 检查这些行为。

## 词库

`bank.js` 索引当前 RA、RS、RTS、ASQ、WE、SWT、WFD 的 537 条题目，以及 227 个 RS 字幕文件。提取英文题干、参考答案、范文、词组及范文结构片段；排除 source_text 原始 PDF/OCR 文本和 notes 整理注释中的粘连词及错误拼写。旧版 `rs.html` 的自定义句子输入框没有内置文本库；`.bak` 和 `wfd_files` 历史网页不作为现行题库。浏览器中 RA/WFD 单词本的已有收藏在打开应用时合并显示，不改动原单词本。

按小写和标准英文撇号去重；根据 ECDICT 的名词复数关系，将规则 -s、-es、-ies 复数合并到单数；不规则复数、时态、连字符词及独立词义例外保留。不直接按词尾删除，避免误删 news、business、analysis、does 等单词。同一模块内相同整段文本只计一次；出现次数用于题库学习排序，不代表考试频率。合并常规复数和普通过去式后词库为 3466 词：616 个规则复数归入单数，95 个规则过去式归入动词原形。

词典来自 [ECDICT](https://github.com/skywind3000/ECDICT)，保留 MIT 许可于 `ECDICT-LICENSE.txt`。本地预填中文释义 3425 词、音标 3399 词，英式音标居多；缺失读音使用 CMUdict 的美式音素映射为宽式 IPA，未标注重音，详情处明确标记来源并保留 CMUDICT-LICENSE.txt。词形关联释义会标注原词，不将原词音标误用为变形词音标。未命中的专名、缩略词和词形明确标记待补全，不伪造音标。可按缺失状态筛选，点击联网补全或手动编辑；补全结果保存于当前站点浏览器。联网音标使用 Free Dictionary API，缺失中文使用 MyMemory 机器翻译并标记需核对。

重新索引：下载 `https://raw.githubusercontent.com/skywind3000/ECDICT/master/ecdict.csv` 至 `tools/data/ecdict.csv`，执行 `node tools/build-word-bank.cjs`。还需下载 https://raw.githubusercontent.com/cmusphinx/cmudict/master/cmudict.dict 至 tools/data/cmudict.dict。原始词典文件不需要发布，部署只需 `word.html` 和 `words/` 目录。下载来自公开词典，无需访问用户密钥。

## 练习

语音设置支持 Azure 神经音色（美式 Aria、Guy、Jenny；英式 Sonia；澳式 Natasha）及当前设备的系统英语声音，默认 Aria。选择随语速和后端设置一同保存在 `pte_word_settings_v1`，刷新后恢复；Azure 音色通过现有 `/get-token` 授权合成，失败时明确提示，不擅自改用系统声音。只有选择系统声音时才调用浏览器朗读。音色仅控制示范朗读，Azure 评分仍使用 en-US。

`tts.js` 管理朗读会话：按单词、音色、语速和输出格式缓存音频，优先命中内存和 CacheStorage，未命中才加载 SDK 并调用 Azure。浏览器不支持持久缓存时回退到内存。相同请求合并；切词、换音色或开始录音时取消当前播放，迟到的合成结果可缓存但不能播放。播放被浏览器阻止时再次点击发音可恢复已有音频。使用 `node tests/word-tts.cjs` 检查 Azure 配置、缓存、请求键、取消隔离、播放恢复及令牌重试。

示范发音使用浏览器英语语音。评分使用现有 `/get-token` 获取临时令牌，再通过 Azure Speech 评估单词发音准确度（0–100）。SDK 和令牌在录音前准备；录音时将重采样后的 16 kHz、16 bit、单声道 PCM 流同步发送到 Azure，结束时立即关闭输入流发送 EOF，不再等待录完整个 WAV 才创建连接。录音仍在本地生成可回听和下载的 WAV。

检测到有效语音后停顿约 0.75 秒会自动结束；开始后约 4 秒没有检测到有效声音会结束，最长保留 6 秒，也可手动结束。音量门限及停顿判断为本地辅助检测，不保证与云端识别完全一致。评分返回即可展示并停止本地采集；结束后的等待上限为 12 秒，期间显示已等待秒数，可随时取消。网络和云端处理仍会影响实际延迟。若网页通过独立预览端口访问，在语音设置填写实际 Flask 后端地址；正式同源部署可留空。

仅当 Azure 返回有限且在 0–100 范围内的有效分数才累计一次，零分同样计次。取消、未识别到声音、网络失败、没有有效分数不计次数。显示最近分数、最佳分数、有效评估次数及最近 20 条记录；评分不是 PTE 官方成绩。评分语言为 en-US，单词练习不启用句级韵律评分。

`pte_word_stats_v1` 保存评估记录，`pte_word_dictionary_v1` 保存音标/释义修改，`pte_word_settings_v1` 保存后端和朗读语速。保存失败会显示提示，可以 CSV 导出全部词汇及练习统计。录音仅保存在当前页面，可回听及下载；刷新后不恢复。清理站点存储、更换浏览器或访问不同端口不会自动同步记录。

## 验证

RA 与 WFD 的侧栏单词本也使用 `speech.js`，通过 `wordbook-score.js` / `wordbook-score.css` 显示每词的麦克风评分按钮和最近分数。首次评分需授权麦克风；说完停顿自动提交，也可点方形结束图标或“结束并评分”。加载或等待评分时可点取消。评分存入各自原单词本记录的 `pronunciationScore`、`pronunciationAttempts`、`pronunciationLastAt`，不修改独立单词本的统计。RA 使用该页的后端设置；WFD 使用同源 `/get-token`。播放其他声音、开始主练习或移除正在评分的词时取消单词录音，防止相互干扰。执行 `node tests/wordbook-score.cjs` 检查控件、零分、恢复、重复回调、取消、RA 忙碌状态及资源路径。

执行 `node tests/words.cjs` 检查词库唯一性、来源覆盖、分数范围、零分计次、历史上限、筛选、CSV、跨块重采样和停顿检测。执行 `node tests/word-streaming.cjs` 检查录音中发送 PCM、自动/手动结束后立即 EOF、录音 WAV、回调只计次一次以及取消后的迟到结果隔离。真实 Azure 评分需要有效后端、联网及麦克风权限。

常规复数合并映射保存在 bank.js 的 pluralAliases。已有复数词条的练习次数、累计分数和历史记录一次性合并到单数词条，历史标注原练习词；原始复数记录保留，迁移标记与合并结果同次写入，避免刷新后重复累加。RA/WFD 收藏中的已合并复数不会重新作为独立词条加入。

普通过去式使用 ECDICT 的 p（过去式）关系验证，支持 -ed、-d、辅音+y→ied、双写辅音+ed；保留不规则过去式和词典中有独立名词、形容词等含义的词条。映射位于 bank.js 的 pastAliases。已有记录用 __regularPastMerged_v1 标记一次性迁移到原形，原始记录仍保留，历史中显示原练习词。
