Qwerty Learner 完整指南：英语单词背诵与打字肌肉记忆如何合二为一
【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner
Qwerty Learner 是一款开源的英语肌肉记忆训练工具：让你背单词的同时用键盘实际敲出来，把"提笔忘字"的英文输入练成和母语一样流畅。读懂这篇指南，你会知道它的数据从一次按键到本地数据库的完整流向、三个关键设计取舍，以及三步本地跑起来的办法。
快速上手：这款单词打字练习工具适合谁
项目定位一句话：给英语为主要工作语言的键盘工作者，把"背单词"和"练打字"合并成同一件事。目标人群大致有三类：工作中中英混输、英文打起来明显慢的程序员和文职人员；准备机考（GRE、雅思、托福等）需要键盘熟练度的考生；想给小学生找打字练习的家长。内置词库覆盖了从 RAZ 分级读物、小学人教版、CET-4/6、考研、GRE3000 到 Java、Python、Go、Rust 等 API 词库，共 200 多个 JSON 词库文件。
从一次按键到浏览器数据库：数据流完整路径
整条主线可以概括为：你按键 → 前端逐字比对 → 出错清空重打 → 章节完成后落盘到 IndexedDB → 分析页和错题本回查。
第一步，按键被捕获。练习开始后，KeyEventHandler 组件在 window 上挂 keydown 监听，逐键取e.key并与目标单词比对；检测到中文输入法符号会弹窗提示关闭，防止污染统计。
第二步，出错即清空。这是刻意为之：单词输错一个字母就要整词重打，牺牲一点练习速度，换取不把错误键位刻进肌肉记忆。
第三步，落盘。章节结束时，两个记录类写入 IndexedDB——底层是浏览器自带的本地数据库，可理解为装在浏览器里、无需服务器的小型数据库；项目用 Dexie 库做了一层封装。每条 WordRecord 存单词、时间戳、每个字母的输入时间差、错误次数、以及"第几个字母被错打成了哪个键"；ChapterRecord 存整章耗时、正确/错误按键数，并内置 WPM（每分钟单词数）、按键正确率、单词正确率三个计算属性。
// src/utils/db/index.ts 中 Dexie 的表与索引定义（节选） wordRecords: '++id,word,timeStamp,dict,chapter,wrongCount,[dict+chapter]', chapterRecords: '++id,timeStamp,dict,chapter,time,[dict+chapter]',关键在于[dict+chapter]这个复合索引：错题本按"词库+章节"取数据、分析页按时间戳画趋势，走的都是索引查询而不是全表扫描。
三个设计取舍：为什么全本地、为什么用 JSON、为什么错就重打
IndexedDB 而非服务端或 localStorage。学习记录（每次按键的时间差、错误键位）数据量大，localStorage 的 5MB 上限和同步 API 都不合适；IndexedDB 异步且容量大，代价是数据留在本地、换浏览器即丢失，项目因此提供了导出功能兜底。
词库是 public/dicts 下的静态 JSON，而非进数据库。每个词库就是name / trans / 美英音标的数组，发布在静态资源目录里随站点分发。好处是增补词库零门槛——放一个新 JSON 文件即自动出现在选择界面；代价是大词库首载偏慢，所以按章节切片、只取当前章节。
错键重打而非跳过。常见打字练习允许继续，这里选择清空整词。对"练出正确肌肉记忆"的目标这是更严格的路线，代价是单次练习节奏更慢、错误多的章节会明显费时间。
你能感知到的体验细节
- 量化反馈：每章结束给出 WPM、按键正确率、单词正确率，进度页用折线图展示速度趋势、用热力图展示按键频率分布。
- 错键画像：每个位置"被错打成什么键"都被记录，能定位到具体是哪两个键容易混。
- 章节默写：一章练完可弹出默写模式，先听发音再默写，巩固记忆。
- 离线可用：词库与练习数据均在本地，断网不影响练习。
三步跑起来：安装与自定义词库
- 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner - 安装依赖：在目录内执行
yarn install - 启动开发服务：执行
yarn start，浏览器访问本地地址即可练习
想自己加工词库，只需按现有格式往 public/dicts/ 放一个 JSON 文件；想看懂记录与索引怎么实现，入口在 src/utils/db/ 目录。
适合谁，不适合谁
它适合以英文输入为工作场景、希望把打字和背单词一次练完的人，也适合想研究"纯前端 + 本地数据库"做个人工具链的开发者。不适合两类人：想要多设备同步云端进度的人，数据只落在本地浏览器，迁移要靠手动导出；以及追求短时高频刷题的人，错词重打机制在错误率高的前期阶段体感偏慢。
【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
