Luma Words

Luma Words 是一个仅供个人在 Windows 电脑本地使用的英语词汇学习软件。外围界面使用中文，进入学习流程后保持纯英文；学习范围以 CET-6 为主，同时优先日常交流中的常用词义与搭配。

功能

• 每日到期复习与默认 20 个新词，支持临时追加学习
• 认识／模糊／不认识三档判断与认识校验
• 纯英文释义、每义至少三条例句、单词和例句朗读
• 六类纯英文复习题，轮换覆盖释义、例句、近义词与搭配
• 间隔复习、原子化答题保存和精确断点续学，重复请求不会重复计数
• 生词搜索、词形归一、短语收录、星标、归档和分页浏览
• 学习趋势、薄弱词、备份恢复和多主题
• Windows 一键启动，数据仅保存在本地 SQLite
• 完整备份学习记录与自定义词条，支持在新数据库中恢复并兼容旧备份

开发启动

当前开发环境可分别启动：

cd backend
python -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app.main:app --reload --port 8000

cd frontend
npm install
npm run dev

Windows 用户首次双击 setup.bat，之后每天双击 start.bat。启动窗口必须保持打开；关闭窗口或按 Ctrl+C 会停止本地服务。

正式界面由 FastAPI 在 http://127.0.0.1:8000 提供，只监听本机回环地址，不会暴露到局域网或公网。

数据与隐私

• 学习记录、设置、搜索记录和错误信息不会发送到分析平台。
• 联网仅用于词典查询、开放例句语料与真人发音资源。
• 首批词条的来源与许可证记录在 backend/data/ATTRIBUTION.md 和数据 manifest 中。
• Tatoeba 补充例句只做启发式词义匹配，不视为人工词义标注；当前 500 词已通过自动内容审计，但仍建议在长期使用中持续人工抽查。

当前内容包

• Seed version: 587a1600789c
• 500 个不重复词条，713 个常用词义，2,139 条例句
• 每个词义至少 3 条例句
• 398 个词条包含确认过的美式真人音频，其余回退到浏览器美式语音合成
• 统一使用美式拼写；内容审计移除了 34 条不适合学习的古旧或过长引文
• 3 个词义因没有更好的开放语料，保留了最短的来源引文并标记为 source-fallback

本项目没有调用强模型、付费模型或付费 API，生成当前内容包的 API 成本为 0 美元。