fix: 复习和错题本展示前实时回查词库释义

[SeanXLChen]

问题

编辑 dicts/ 下的词库文件、改掉某个词的释义之后，「今日复习」和「错题本」里显示的还是旧释义。而且不会自己恢复：重启 codep 也没用，只有那个词恰好被重新练到一次，显示才会更新。

原因是 recordResult() 会把练习当时看到的 meaning / phonetic 一起写进 ~/.codep/review.json，而 getDueWords() / getMistakeWords() 直接拿这份快照去展示，从不回查词库文件。本质上是一个没有失效策略的缓存 —— 陈旧不是「持续一小段时间」，而是永久。

为什么一直没人报

内置词库（CET-4、GRE、程序员常见词……）基本不变。词库不变，缓存和源就永远一致，这个 bug 从不触发。

只有自己维护词库的用户会踩到 —— 边学边改释义、调整格式的那种用法。而词库会变，恰恰是「自定义词库」这个功能的设计前提。

改动

展示前实时回查词库，背后是一个按文件指纹失效的缓存：

• storage.js：提取导出 resolveDictPath，loadDict 复用（避免两处重复实现 primary/legacy 双路径逻辑而漂移）。顺带把 path.join 换成 path.resolve —— 对现有 13 个词库条目逐字节相同，但让绝对路径的 dictInfo.file 也能正常工作。
• review.js：新增词库缓存，指纹取 dev:ino:size:mtimeNs。ino+dev 覆盖「写临时文件再 rename」式保存（inode 变而 mtime 未必动），mtimeNs 覆盖同秒内的两次原地写入。缓存能在进程运行中失效，codep 在 tmux 里挂几天也不需要重启。
• getDueCount / getMistakeCount 拆成只数个数，既不排序也不回查词库 —— 菜单里每按一次方向键都会调用它们。

三个不太直观的地方

必须 statSync 而不是 lstatSync。 词库文件可以是软链（自己维护生词本的人常常软链到笔记库）。软链自身的 mtime 是创建那天、之后永不改变，用 lstat 会做出一个看起来在失效、实际永不失效的缓存 —— 悄悄把这个 bug 原样复现一遍。

recordResult 保持 ||，没有跟着改成 ??。 读和写是两条不同的规则：读要说真话（词库为准，释义被清空就显示空），写只维护兜底（只在词库给出非空值时才升级快照）。卡片按 dictId:word 存、词从词库删掉后不会被清理，那份快照是唯一还能说明词义的东西；如果写入也用 ??，词库某条目释义一旦为空，一次练习就会把它冲成空字符串永久丢失。

stat 本身抛错时不缓存也不沿用旧缓存。 throwIfNoEntry: false 只压制 ENOENT，软链循环仍会抛 ELOOP、路径穿过普通文件会抛 ENOTDIR，所以 stat 要自己包一层 try/catch。拿不到有效指纹就无从判断缓存是否还有效，只能退回快照。解析失败则按指纹缓存，因为文件修好后指纹会变，能自愈。

测试

26 个新增用例，沿用仓库现有风格（node --test、零依赖、零 mock、中文用例名）。

纯函数覆盖合并与筛选规则；集成测试用临时词库 + 临时 CODEP_DATA_DIR，覆盖运行中编辑、软链词库改目标文件、stat 抛错后自愈、指纹未变时复用缓存、多词库混排、快照往返、词被删除、未注册词库、词库损坏、文件不存在（coca20000.json 被 gitignore，这就是每个新 clone 的默认状态）等路径。

集成测试开头有一条硬断言，确保 REVIEW_FILE 落在临时目录内 —— 否则将来有人打乱 require 顺序时，测试会照常全绿并静默写坏使用者真实的复习进度。

每条设计决策都用变异测试验证过确实被钉住：

变异	挂掉的用例数
回查退化成只读快照（改动前的行为）	9
statSync → lstatSync	1
stat 失败时沿用旧缓存	1
recordResult 的 meaning 写入改成 ??	1
recordResult 的 phonetic 写入改成 ??	1
条目级覆盖改成字段级	3

本次没有涉及

以下都是同一 bug 类的其他缓存，但都只在内存里、重启即恢复，远没有 review.json 那份跨重启永久陈旧严重，修它们要动 UI 状态管理、会让这个 PR 大很多：

1. 章节练习 —— input.js 在选词库/启动时 words = loadDict(dict) 加载一次。停在同一个词库里不退回菜单时，编辑不生效；退回菜单重进即刷新。
2. 「再来一轮」 —— lastReviewWords 冻结整个进程生命周期。
3. 改词/改大小写会孤立 SM-2 历史 —— 卡片按 dictId:word 存且从不清理。既有问题，但这次修复会让孤立卡片变成「唯一不更新的那一个」，更隐蔽。
4. loadDict 的格式分叉 —— if (item.word && item.meaning) return item; 对 {word:"x", meaning:""} 这种写法会让 word 变成 undefined、索引不到。README 记载的 {name, trans} 格式不受影响。

这些都记在 docs/review-cache.md 里了。

---

第二个 commit 是一篇设计笔记（docs/review-cache.md），记录这个 bug 为什么存在、为什么一直没被发现，以及上面那几个反直觉选择的理由，主要是防止以后被「优化」回去。它新建了一个顶层 docs/ 目录 —— 如果你觉得不合适，单独 drop 掉第二个 commit 即可，第一个 commit 是自洽的（README 里的链接也在第二个 commit 才加上）。