Qwerty Learner 自定义词库扩展教程1个JSON文件1行配置装进你的专属单词表【免费下载链接】qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers项目地址: https://gitcode.com/GitHub_Trending/qw/qwerty-learnerQwerty Learner 把背单词和打字训练绑在一起但默认词库覆盖不了你的备考方向和专业术语。这篇教程教你扩展 Qwerty Learner 自定义词库写好一个 JSON 文件、加一条索引记录专属单词表就能出现在词库目录里。 这事适合谁做会写 JSON、能在编辑器里保存文件就够了不需要会前端开发。你手上有一张现成的单词表Excel、TXT、扫描件整理稿都行就具备开工条件如果连仓库怎么跑起来都不熟也可以直接按 docs/toBuildDict.md 的流程把需求提给社区让开发者帮你导入。 动手前30秒速览要碰的东西在哪长什么样词库文件public/dicts/ 目录一个.json文件如my_vocabulary.json词库 JSON 结构同上数组每项含name单词、trans释义数组可选usphone/ukphone音标词库索引src/resources/dictionary.ts在对应分类的数组里加一条记录索引关键字段同上id全局唯一、name、description、category、url、length单词数、language单词数计算scripts/update-dict-size.js跑一次脚本自动按 JSON 实际条数回填length 完成扩展词库文件放在哪把单词表整理成 JSON 数组每项一个单词存到 public/dicts/ 目录下文件名起个有意义的比如my_vocabulary.json。最小可用的结构长这样[ { name: file, trans: [n. 档案, 公文箱; 文件] }, { name: command, trans: [n. 命令; 指令], usphone: kəˈmɑːnd } ]name和trans必填trans是字符串数组一条释义占一个元素usphone、ukphone可选写上之后练习界面才会显示美式/英式音标单词多到不想手敲用在线转换工具把 CSV 转成 JSON或把源文件片段贴给大模型让它生成转换脚本都是现成路子让应用识别词库词库文件放好后应用还看不到它——因为目录页渲染的名单来自src/resources/dictionary.ts。打开这个文件在和你词库对口的分类数组里加一条{ id: my-vocabulary, name: 我的自定义词库, description: 自制的专业词汇表, category: 其他, url: /dicts/my_vocabulary.json, length: 100, language: en, languageCategory: en, }id必须和文件里其他条目不重名重复了以后排查问题会很麻烦category先翻一遍现有分类再填挂错 tab 等于白加length可以先手填占位跑一次node scripts/update-dict-size.js它会扫描 public/dicts/ 下所有 JSON把length改成真实条数 确认生效改完别急着关编辑器yarn dev起本地服务后对着这三条自查词库目录页能看到你加的卡片且挂在正确的分类 tab 下点开词库详情单词和释义正常渲染——JSON 只要漏一个引号这里就会加载失败所以这一步能抓住大部分格式错误卡片上显示的词数和 JSON 实际条数一致对不上就重跑一次scripts/update-dict-size.js⚠️ 常见坑现象词库目录里死活看不到新词库 →原因dictionary.ts里索引没加或category填了不存在的分类名 →处理对照同文件里的其他条目逐字段核对一遍现象点开词库报 404 或页面空白 →原因url和 public/dicts/ 下的文件名对不上大小写也算对不上 →处理确认url写成/dicts/文件名.json并与磁盘上的文件逐字符比对现象卡片词数显示是错的 →原因length手填后没更新 →处理跑node scripts/update-dict-size.js自动回填现象想分享词库但不知从哪入手 →原因社区贡献走的是 Issue/PR 流程不是直接发文件 →处理按 docs/toBuildDict.md 的说明发起 Dictionary Request 或提交 PR先挑 10 个最近总在查的单词建一个my_vocabulary.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），仅供参考