Qwerty Learner 词库不够用？从看懂结构到定制专属词库，一次讲清

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 词库文件的人大多会先被劝退——好像不读懂一堆源码就没人敢碰它。真没那么复杂。Qwerty Learner 是个把背单词和练打字揉在一块儿的工具它甩给你一串单词你边打字边记练的正是英语的肌肉记忆。软件自带 RAZ 分级阅读、考研、雅思、托福甚至日语、编程关键词的数百个词库但总有覆盖不到的地方——你的专业术语、某场小众考试的词表或者你自己攒的复习清单。这篇文章不让你啃源码只带你做两件事看懂一个词库文件是怎么工作的再搞清楚怎么把专属词库加进去。一个词库其实就是数据 登记两样东西很多人把扩词库想成了改核心逻辑、写插件所以才迟迟不敢动手。拆开看它其实就是个 数据文件加一条元数据登记数据文件一份 JSON一种很轻的数据格式本质就是结构化的文本里面装着你所有的单词。项目里这类文件统一放在 public/dicts/ 下CET4_T.json、KaoYan_2024.json都是它。元数据登记一条告诉程序这个词库叫什么、在哪个文件、有多少词的记录。每条词库都在 src/resources/dictionary.ts 里登记了一行。没了。没有算法也不碰业务逻辑。理解到这一层剩下的全是填字。词库文件长什么样name、trans 字段怎么填打开任意一个词库文件比如 public/dicts/CET4_T.json结构长这样[ { name: cancel, trans: [取消撤销删去], usphone: kænsl } ]逐个说清楚name是单词本身。trans是释义注意它是数组一个词有多个义项就放多个。usphone/ukphone是美式、英式音标可选填上发音体验会好很多。这里藏着一个大坑有些老教程给的字段是word、translation、phonetic。那套字段在本项目里根本读不出来真实字段就是name/trans/usphone/ukphone。照着错的填词库加了也白加。元数据登记在哪、要填哪些字段光有数据文件还不够程序得知道它的存在。这条登记统一写在 src/resources/dictionary.ts{ id: cet4, // 全局唯一 name: CET-4, url: /dicts/CET4_T.json, length: 2607, }几个关键字段id唯一标识不能和已有词库重重了会冲突。url指向 public/dicts/ 下那个 JSON 的实际路径。length单词总数。填错不影响能不能用但列表上显示的数量会不准。另外还有description描述、category分类、tags标签、language语言决定它归到目录的哪个分组、显示成什么样。顺带纠个偏有些教程让你去改src/constants/index.ts那里面其实没有词库登记真实位置是src/resources/dictionary.ts。怎么确认词库加对了跑起来看一眼准备提交新词库时先在本地验一遍。用 yarn 装好依赖再起服务——yarn 负责安装项目用到的第三方库跟着提示走就行yarn yarn dev然后访问http://localhost:5173打开词库列表。如果你的词库出现在对应分类里就成了 ✅。顺手说个小工具scripts/update-dict-size.js 能自动扫描 public/dicts/ 下所有 JSON重新算出每个文件的单词数再把length刷对。批量整理词库时比一个个手数靠谱得多。避坑提醒这些字段填错词库就不出现把常踩的坑列在这儿 ⚠️对号入座字段名用错最常见。name写成word、trans写成translation程序直接读不到列表里就少一条。id撞车和现有词库id相同新词库会被覆盖或冲突。url对不上路径里的文件名和实际文件名差一个字母加载就 404。length没填或填错能用但列表数量显示不准用上面的脚本一键刷新。不写代码也能把词库提上去不想碰代码也完全没问题。项目官方文档 docs/toBuildDict.md 给不会编程的人留了两条不用写代码的路把词典源文件准备好直接找社区帮忙导入开发者会替你完成格式转换。提一个以Dictionary Request开头的 Issue写清楚你要哪个词库、来源在哪社区来认领。会写代码的话就按前面两节的格式把 JSON 准备好、登记填齐再走社区提交流程即可。核心就一句格式对了剩下的交给社区流程。写在最后下一步可以做什么先翻一遍现成词库目录确认你要的那份是不是已经有了省得重复造轮子。想加新词库先按name/trans把单词整理成 JSON这是唯一绕不开的一步。卡在格式转换上就把源文件丢给社区或让 AI 帮你生成一段转换脚本。词库这东西够用就好。先让学习跑起来再慢慢把它变成真正属于你的那份。【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考