← Back to AI Insights
Gemini Executive Synthesis

Word Atlas (词光) — an illustrated IELTS vocabulary learning application.

Technical Positioning
Delivering a robust, reliable, and fair vocabulary learning experience by ensuring data persistence, accurate state management, and correct user interaction.
SaaS Insight & Market Implications
This comprehensive bug report for `Word Atlas` reveals critical vulnerabilities in data integrity and core application functionality. P1 issues, such as `pack:public` potentially deleting project files, represent catastrophic data loss risks. P2 issues highlight systemic flaws in state management, including unsupported backup versions clearing progress, corrupted learning sessions causing crashes, and cross-tab state overwrites leading to lost user data. Furthermore, a fundamental flaw in the random number generation for multiple-choice questions directly compromises the `FSRS` learning algorithm's integrity, artificially inflating scores. These issues collectively indicate a lack of robust error handling, data validation, and concurrency management. For a learning application, data loss and compromised progress tracking are existential threats, directly eroding user trust and product utility. Addressing these requires a significant refactor of data persistence and state logic.
Proprietary Technical Taxonomy
pack:public scripts/package_public.py PUBLIC_MANIFEST.json src/store/store.ts version progress.version newIds reviewIds

Raw Developer Origin & Technical Request

Source Icon GitHub Issue Oct 26, 2026
Repo: designfuchen/word-atlas
31 个可复现的问题(含位置与修复建议)/ 31 reproducible bugs with locations and suggested fixes

## 中文

你好!我们在把词光翻译成俄语(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.

Frequently Asked Questions

Market intelligence mapped to Word Atlas (词光) — an illustrated IELTS vocabulary learning application..

What problem does Word Atlas (词光) — an illustrated IELTS vocabulary learning application. solve?
Based on our AI analysis of the original developer request, its primary technical positioning is: Delivering a robust, reliable, and fair vocabulary learning experience by ensuring data persistence, accurate state management, and correct user interaction.
What is the general sentiment around Word Atlas (词光) — an illustrated IELTS vocabulary learning application.?
Yes, we have tracked 1 direct responses and active debates regarding this specific topic originating from GitHub Issue.
What are the foundational technologies related to Word Atlas (词光) — an illustrated IELTS vocabulary learning application.?
Our proprietary extraction maps Word Atlas (词光) — an illustrated IELTS vocabulary learning application. to adjacent architectural concepts including pack:public, scripts/package_public.py, PUBLIC_MANIFEST.json, src/store/store.ts.

Engagement Signals

1
Replies
open
Issue Status

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