qwerty-learner 自定义词库导入从一份 JSON 文件到完整个人词库10 分钟走通【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner手里有一份自己的词表想丢进 qwerty-learner 里做打字练习自定义词库导入只需要两件事放一份 JSON 文件加一条注册信息。整个过程十来分钟。词库只有两层数据与注册项目里的词库分两层数据层是public/dicts/目录下的一份份 JSON内容就是一个词条数组注册层在src/resources/dictionary.ts记录每个词库的名字、分类和词量。两层都在词库才会出现在界面上。主流程从 JSON 文件到词库列表词库 JSON 怎么写、放哪里先把仓库克隆到自己机器上后面所有操作都发生在这份本地副本里不碰线上仓库git clone https://gitcode.com/GitHub_Trending/qw/qwerty-learner把词表整理成目标结构。每个词条只要name和trans两个字段[ { name: file, trans: [n. 档案, 文件] }, { name: command, trans: [n. 命令, 指挥] } ]以 UTF-8 编码存成 JSON放进public/dicts/目录即可。源文件如果是 Excel 或文本表格挑几行喂给 AI、说清楚目标结构让它批量转换事后抽查几个词条就行。词库注册文件怎么改打开src/resources/dictionary.ts找到目标分类的数组照着现有条目的样子补一项。以放到中国考试分类为例{ id: mydict, name: 我的词库, description: 日常工作高频词汇, category: 中国考试, tags: [日常], url: /dicts/mydict.json, length: 1200, language: en, languageCategory: en }唯一的硬性约束是id不能和项目里已有的任何词库重名。length先填个占位值下一节会自动修正。词量自动更新脚本用法词数不用手动数。这个脚本会遍历public/dicts/下的全部 JSON统计词条数并回填到注册文件里node scripts/update-dict-size.js然后装依赖、起 dev 服务yarn install yarn dev打开 http://localhost:5173 词库列表里能看到自己的条目、词量显示正确导入就算跑通了 注册字段逐项说明字段作用id词库唯一标识不能与项目内现有条目重复name列表里展示的显示名description一句话简介展示在词库卡片上category词库归属的分类标签页取中国考试国际考试代码练习等已有值tags标签数组方便后续按标签筛选url数据文件路径格式固定为/dicts/文件名.jsonlength词条数占位值由更新脚本自动修正language词库语言取值en、de、ja、code、id等完整清单见src/typings/index.tslanguageCategory语言标签页分组决定它挂在哪个顶层标签下usphone/ukphone词条内的音标字段可选有则练习界面直接显示音标三种常见变体程序员 API 词库language和languageCategory都设为code放进代码练习分类name里放方法名、关键字trans里放参数说明适合速记日常用到的 API。非英语词库language换成对应枚举值de、ja、id等取值清单在src/typings/index.ts发音方式会自动跟着语言切换。备考词库就近归入中国考试分类tags里补一个识别度高的标签之后按标签筛选更方便。问题速查词库没出现先看这里列表里找不到词库 → 只放了数据层、漏了注册 → 到src/resources/dictionary.ts补条目重启 dev 服务词量显示不对 →length还是手写占位值 → 再跑一次scripts/update-dict-size.js页面报 JSON 解析错误 → 文件不是 UTF-8 或文本里多了逗号 → 用 UTF-8 重新保存丢进校验工具定位练习界面没有音标 → 词条缺usphone/ukphone→ 在 JSON 里补上这两个字段把自己的词表整理成 JSON照着上面的流程完整走一遍。细节可对照 docs/toBuildDict.md。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考