loongyowl vocab-builder — 词库生成器
功能
从 TXT 文件批量导入英文单词，自动为每个单词生成：
- 中文释义
- 2 个英文短句示例（使用简单英语，包含该单词）
输出为 JSON 文件，可直接导入 Basic English 闪卡 App 使用。
输入格式
TXT 文件，每行一个英文单词：
apple
book
cat
也支持空行和 # 开头的注释行。
输出格式
JSON 数组，每个元素包含 word、meaning、examples：
[
{"word": "apple", "meaning": "苹果", "examples": ["I ate an apple for breakfast.", "The apple is sweet."]},
{"word": "book", "meaning": "书，书籍", "examples": ["She is reading a book.", "This book is very interesting."]}
]
执行流程
步骤 1：读取 TXT 文件
- 使用 Read 工具读取用户提供的 TXT 文件路径
- 提取所有非空、非注释行的单词
- 去重并转为小写统一处理
- 显示提取到的单词数量
步骤 2：分批生成释义和例句
- 每批处理 50 个单词
- 为每个单词生成：
meaning: 中文释义（简洁准确，2-4 个汉字优先）examples: 2 个英文短句- 每句 5-10 个词，使用基础英语
- 必须包含该单词
- 实用日常场景
- 例句风格多样化（陈述句、疑问句、祈使句交替）
- 将生成结果写入临时 JSON 文件（
part_N.json）
步骤 3：合并输出
- 合并所有分批结果为一个大 JSON 数组
- 保存到源 TXT 文件同目录下，文件名与 TXT 相同但扩展名为
.json - 例：
wordlist.txt→wordlist.json - 同时在 Basic English 项目目录
C:\Users\JoeHuang\WorkBuddy\basic-english\basic-english-master\保存一份副本
步骤 4：更新 App 默认数据（可选）
- 如果用户要求，可以更新 app.js 中的
DEFAULT_WORDS_DATA - 使用 Python 脚本替换嵌入数据
步骤 5：报告结果
- 输出生成统计：总单词数、有释义数、有例句数
- 输出 JSON 文件路径
- 提示用户可以在 App 中通过"词库管理"→"导入词库"导入该 JSON
生成模板
每个单词的生成格式：
{"word": "WORD", "meaning": "中文释义", "examples": ["Example sentence 1 with WORD.", "Example sentence 2 with WORD."]}
注意事项
- 例句必须包含目标单词，且单词形式与词库中一致
- 如果单词有多种含义，取最常用的一个
- 介词、连词等功能词的例句要展示其在句中的用法
- 生成过程中如果某个词无法生成例句，跳过并记录
- 输出必须是合法的 JSON（UTF-8 编码）