把私有词表接入打字练习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 的词典全部是 public/dicts/ 目录下的 JSON 文件把词表转成约定格式、在索引里登记一条你的词表就会出现在词典列表里。照着屏幕上的单词逐字输入。导入自定义词典前需要准备什么词表来源Excel、TXT 或其他词书导出的内容本地 Node.js 环境项目用 yarn Vite 启动已克隆的仓库能修改 public/ 与 src/ 两个目录三步完成词表导入1. 把词表写成 JSON放进 public/dicts/一个文件对应一个词库顶层是数组每个单词一条记录字段类型说明name字符串单词本身练习时逐字输入的就是它trans字符串数组释义可按词性写多条usphone字符串美音音标ukphone字符串英音音标[ { name: cancel, trans: [取消撤销删去], usphone: kænsl, ukphone: kænsl } ]文件保存为 public/dicts/my_words.jsonUTF-8 编码。2. 在 dictionary.ts 里登记一条索引页面列表由 src/resources/dictionary.ts 的 dictionaryResources 数组渲染需要按已有条目格式补一条{ id: my_words, name: 我的词表, description: 自定义练习词表, category: 英语学习, tags: [自定义], url: /dicts/my_words.json, length: 120, language: en, languageCategory: en, }字段要求id全局唯一与已有词典重复会被覆盖url指向 JSON 的路径以 /dicts/ 开头length单词数下一步由脚本自动回填language / languageCategory词库语言英文库填 en3. 启动开发服务器看结果yarn install yarn dev访问 http://localhost:5173词典列表里出现我的词表进入章节点 Start 即可打字练习。新词库与内置词库并列展示。验证导入成功排查三类高频问题成功的标志列表显示词典名与词量章节内能看到单词和释义练习时发音可正常播放。列表里没有新词典 → 只加了 JSON没登记索引 → 在 src/resources/dictionary.ts 补一条记录后重启 dev server。进入章节后单词空白或报错 → JSON 不是合法数组或 trans 写成了字符串 → 用 JSON 校验工具检查trans 必须是数组。词量显示不对 → length 是手填的旧值 → 运行 node scripts/update-dict-size.js它会遍历 public/dicts/ 并自动更新 dictionary.ts 中的数字。自定义词库让练习内容跟着自己的进度走社区词典的贡献流程参考 docs/toBuildDict.md。git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考