Vocab Pocket

Vocab Pocket 是一款为 ESP-Mosaico 打造的便携英语查词与间隔复习应用，将离线词典、联网查词、生词本和 FSRS 记忆调度整合到 480×480 触摸屏中。

核心功能

• 1.5 万词离线词典：断网也能查询常用英文单词、音标和中文释义。
• 联网补充查词：本地未命中时查询在线词典，并尝试补充中文释义；结果会校验词条一致性，避免把相近词误当成输入词。
• 生词本：收藏查询结果，查看全部已收藏单词，点击进入详情并查看复习状态。
• 今日复习：采用 FSRS-5 默认参数，根据每个单词的记忆状态安排下一次复习。
• 四级反馈：支持“忘记 / 困难 / 认识 / 简单”，区分无法回忆、费力回忆、正常回忆和轻松回忆。
• 进度保存：已提交的生词和学习记录保存在 NVS，重新进入或重启后保留。
• 单词发音：联网时通过设备扬声器播放英语发音。
• 触屏操作：屏幕软键盘实时显示输入内容，长释义支持下滑查看。

今日复习：算法思想

1. 不按固定天数重复，而是估计每个词的记忆状态

本应用使用 FSRS-5（Free Spaced Repetition Scheduler，自由间隔重复调度算法），围绕三个量建立记忆模型：

• 难度 D：这个词对你而言有多难记。
• 稳定性 S：记忆可以保持多久的时间尺度。
• 可提取性 R：根据距上次复习的时间和稳定性，估计现在能回忆起来的概率。

每次反馈会结合已有记忆状态和复习间隔，更新难度与稳定性，再安排下次日期。默认目标记忆保持率为 90%，这是调度目标，并不是对实际学习效果的保证。

2. 先巩固未完成的词，再处理到期词和新词

重新进入今日复习时，优先继续当天已经开始但尚未通过的词。其他到期词按预计遗忘风险排序，越容易忘记的越先出现；剩余额度再加入新词。默认每天最多开始 20 个不同单词，其中新词最多 5 个。到期词较多时，新词数量会减少。

当天已经占用的额度会保存，退出页面或重启不会重置；重复练习同一个词也不会被当成新增单词。

3. 四个按钮分别代表什么

• 忘记（Again）：看答案前无法回忆。不增加完成进度，保留待复习，并在本轮稍后再次练习。
• 困难（Hard）：能够正确回忆，但明显费力或犹豫。不增加完成进度，仍保留待复习，并在本轮再次巩固。完全想不起来时应选“忘记”。
• 认识（Good）：正常、正确地回忆。计入本轮完成进度，并按更新后的记忆状态安排下次日期。
• 简单（Easy）：几乎立即、毫不费力地回忆。计入完成进度，通常比“认识”安排更长的复习间隔。

这里要区分两层逻辑：FSRS 负责更新记忆模型与跨天复习日期；本应用额外安排本轮重复巩固。“困难也暂不计完成”是本软件的巩固策略，不是 FSRS 强制规定的行为。

4. 为什么多次点“忘记 / 困难”后会结束本轮

这两类词会先跳过，在本轮最多间隔两个词后再次出现；剩余词不足时会更早出现。每个词最多追加 4 次练习，避免无限循环。

进度表示“本轮已通过的不同单词数 / 本轮初始单词数”。重复练习不增加总数；只有“认识 / 简单”增加完成数。队列用尽时的 DONE 只代表本轮结束，不一定代表全部掌握：未通过的词仍保留待复习，返回首页后可继续。

已通过且未再次到期的词不会继续出现在今日待复习列表中，但仍可在生词本查看。

使用方法

1. 首页点击输入框，输入英文单词并点击“查询”。
2. 查看音标、中文释义和例句，长内容下滑查看；需要学习的词可加入生词本。
3. 进入“今日复习”，先主动回忆，再查看答案，根据真实回忆情况选择四级反馈。
4. 在生词本查看全部收藏词及复习状态，点击词条进入详情。
5. 配置 Wi-Fi 后使用联网查词和发音；设备会复用已保存的网络。联网后通过 SNTP 校时，默认时区为 UTC+8。

硬件与已知限制

• 适配 ESP-Mosaico（ESP32-S31），使用板载屏幕、触摸及扬声器，无需额外扩展子板。
• 离线查询和复习无需网络；在线词典、翻译和发音依赖第三方服务，可能延迟或不可用。联网失败不影响已收录的离线词条，但无法保证缺失词的释义或声音可用。
• 当前使用固定 FSRS-5 默认参数、按天调度，尚未训练个人参数，也未实现分钟级学习步骤。
• 生词本最多 128 词；在线自定义词条缓存最多 8 条，已收藏的在线词条不会被自动淘汰。扩容及记录迁移计划后续完善。
• 保存采用约 1.5 秒静默窗口合并写入，最后一次操作后立即断电可能丢失尚未提交的变化。
• 首次可靠校时前，无法准确推断断电期间经过了多少天。任意动态中文字符覆盖和跨日长期真机稳定性仍待进一步验证。
• 本次固件已通过回归测试、内存检查及构建，并在实体开发板完成安装、启动与系统健康校验；不等同于全部物理触摸和可听发音场景均已验收。

固件版本：1.1.0