Word Atlas (词光) — an illustrated IELTS vocabulary learning application.
Raw Developer Origin & Technical Request
GitHub Issue
Oct 26, 2026
## 中文
你好!我们在把词光翻译成俄语(fork:[ivkiwi/word-atlas](github.com/ivkiwi/word-atlas... `russian-edition`)的过程中,对代码做了一次系统排查,下面这些问题在原版 `9eff300e` 上同样可以复现。每一条都写明了具体位置、复现方式和最小修复建议。我们的分支里已经有修复,但和俄语文案混在一起;很乐意按照 CONTRIBUTING 为任意条目提交干净的 PR(先从两个一行修复开始:答案位置偏差和听写重播按钮)。
严重程度:P1 数据丢失,P2 功能异常,P3 次要问题。
## 数据丢失与存储
1. **[P1] `pack:public` 可能删除整个项目及同级文件** — `scripts/package_public.py:92` 只拒绝项目目录本身及其子目录。若 `--out` 指向上级目录,检查会通过,随后的清理循环会删除其中所有内容,包括项目本身。修复:同时拒绝项目的上级目录,以及不是旧导出(没有 `PUBLIC_MANIFEST.json`)的非空目录。
2. **[P2] 内部版本不受支持的备份会清空学习进度** — `src/store/store.ts:305` 只检查外层 `version: 2`。`progress.version: 1` 的文件会被清洗成空进度,提示"已恢复",并覆盖现有卡片。修复:在修改状态之前校验 `progress.version`;替换进度前请用户确认。
3. **[P2] 损坏的学习会话导致应用崩溃** — `src/store/store.ts:155` 接受缺少 `newIds`/`reviewIds`/`started` 的会话;"今日"页随后调用 `newIds.slice()`,页面空白。修复:校验会话结构,只丢弃会话本身。
4. **[P2] 另一个标签页会覆盖未保存的修改** — `src/store/store.ts:225`:即使本标签页在 250 ms 防抖期内有未保存的修改,`storage` 监听器也会直接替换状态,收藏和复习记录随之丢失。
5. **[P2] 写入失败后清除了"待保存"标记** — `src/store/store.ts:212` 在写入之前就设置 `dirty = false`;发生一次 `QuotaExceededError` 后,后续保存不会重试。
## 学习与练习
6. **[P2] 所有选择题的正确答案位置有偏差** — `src/lib/text.ts:48` 的 `x % (i + 1)` 使用了 LCG 的低位,而最低位只是交替变化。四个选项时,正确答案出现在按键 1 的概率为 33.3%,按键 2 为 16.7%,按键 3、4 各 25%(20 万个随机种子)。盲选"1"高于随机水平,FSRS 评分被抬高。修复:`Math.floor((x / 2 ** 32) * (i + 1))`。
7. **[P2] 听写中的"再听一遍"无法点击**(已有 issue #2 和 #6)— `src/styles/app.css:2983` 的 `.typing-input { position: absolute; inset: 0; opacity: 0 }` 覆盖了整个 `.typing-stage`,包括重播按钮;在按钮位置 `elementFromPoint` 返回的是输入框。修复:给按钮加 `position: relative...
Developer Debate & Comments
No active discussions extracted for this entry yet.
Adjacent Repository Pain Points
Other highly discussed features and pain points extracted from designfuchen/word-atlas.
功能bug
Frequently Asked Questions
Market intelligence mapped to Word Atlas (词光) — an illustrated IELTS vocabulary learning application..
What is the technical positioning of Word Atlas (词光) — an illustrated IELTS vocabulary learning application.?
Are engineers actively discussing Word Atlas (词光) — an illustrated IELTS vocabulary learning application.?
What architecture is tied to Word Atlas (词光) — an illustrated IELTS vocabulary learning application.?
Engagement Signals
Cross-Market Term Frequency
Counts stored text matches for foundational terms like version and started in analysed public discussions. These counts do not measure adoption.
Stored text matches, not adoption or market-share measurements.
- version: 104 records
- started: 3 records
- pack:public: 1 records
- scripts/package_public.py: 1 records
- PUBLIC_MANIFEST.json: 1 records
- src/store/store.ts: 1 records
- progress.version: 1 records
- newIds: 1 records
- reviewIds: 1 records
- newIds.slice(): 1 records
- storage listener: 1 records
- 250 ms防抖期: 1 records
- dirty = false: 1 records
- QuotaExceededError: 1 records
- src/lib/text.ts: 1 records
- x % (i + 1): 1 records
- LCG: 1 records
- Math.floor((x / 2 ** 32) * (i + 1)): 1 records
- FSRS 评分: 1 records
- src/styles/app.css: 1 records
- .typing-input: 1 records
- .typing-stage: 1 records
- elementFromPoint: 1 records
SaaS Metrics