init

docs/smoke-test.md

@@ -0,0 +1,49 @@
+# 手工冒烟测试
+
+## 测试准备
+
+1. 用 HTTP 静态服务器启动 `refactor/`，打开开发者工具并保持 Console 可见。
+2. 在原版设置页导出完整备份；确认重构版与原版使用相同 origin 后刷新重构版。
+3. 记录测试前 localStorage 的键名与关键数据数量，避免误把端口不同导致的空数据判断为兼容失败。
+
+## 路由与全局 UI
+
+- [ ] 依次进入 `#home`、`#words`、`#quiz`、`#review`、`#extract`、`#mail-learn`、`#stats`、`#settings`，前进/后退正常。
+- [ ] 深浅主题切换后刷新仍保持；统计图在两种主题下可重绘。
+- [ ] 移动端菜单、遮罩关闭、Toast、Modal 遮罩与关闭按钮正常；Esc 可关 Modal/侧栏。
+- [ ] 全程 Console 无 `ReferenceError`、未知 action、模块加载或 404 错误。
+
+## 数据兼容
+
+- [ ] 旧 `words/records/schedule/favorites` 能迁移到默认词库前缀键，结构和值不变。
+- [ ] 各词库的 `words:<id>`、`records:<id>`、`schedule:<id>`、`favorites:<id>` 可切换并恢复。
+- [ ] 设置、邮件、主题、过滤词、自动加载和自动播放设置刷新后恢复。
+- [ ] 导出全部数据，再导入该备份，单词/记录/计划/收藏/邮件数量一致；API Key 不进入导出文件。
+
+## 单词库
+
+- [ ] 搜索输入防抖、分类/收藏/错题/频次筛选、分页及滚动正常。
+- [ ] JSON 导入、导出、重复过滤、详情、编辑释义、收藏、朗读和删除正常。
+- [ ] 自动播放可启停，重复次数/间隔/滚动设置生效；快速点击多个发音只保留最后请求。
+
+## 测验与复习
+
+- [ ] 本地英译中、中翻英；50/100 分组、全部/错题/收藏范围、随机/顺序、题量均正常。
+- [ ] 答题、上一题、下一题、结束、结果、再测一次正常，记录与 schedule 更新。
+- [ ] 配置 AI 后可出题；失败或 429 时提示并回退本地题库。
+- [ ] 错题列表及开始复习正常；翻卡、认识/模糊/不认识、进度跳转、收藏和朗读正常。
+- [ ] 复习快捷键 ←、→、Space、1/2/3 仅在复习会话且无 Modal 时生效。
+
+## 邮件提词与学习
+
+- [ ] 粘贴提词、专有名词过滤、chips 全选/反选、AI 翻译入库及保存邮件正常。
+- [ ] 批量模式可读取 txt/md/html/eml，多文件移除、频次提取、去重和入库正常。
+- [ ] 已保存邮件可载入/删除；AI 分析、全文翻译、高亮词库单词正常。
+- [ ] 阅读模式逐句显示、句子朗读/翻译、全部翻译、词库词 tooltip、生词查询与加入词库正常。
+
+## 设置与词库
+
+- [ ] AI、Azure TTS 配置保存与连接测试正常；Azure 失败后语音回退正常。
+- [ ] 内置词库切换、自动加载、手动加载、过滤词增删/搜索/复制正常。
+- [ ] 清除收藏、清空数据的双重确认及保留收藏单词行为与原版一致。
+- [ ] “获取最新版本”只清应用缓存并刷新，不清 localStorage。