WordTree：基于词族树的本地英语词汇学习应用

A local-first English vocabulary learning app with flashcards, timed spelling and word-family trees.

WordTree 是一款本地优先、无需注册的英语词汇学习应用。它围绕 认词卡片、限时拼写、词族树谱和本地练习记录 构建，适合希望用结构化方式长期积累词汇的学习者。

• 本地优先 / Local-first
• 无需注册 / No account required
• 学习记录保存在本机 / Practice records stay on your device
• 支持认词、拼写、词族树和学习记录
• 支持 Web、Electron 桌面端和 Capacitor Android 端

入口	链接
在线体验 / Web App	https://plumagef.github.io/WordTree/
Windows 下载	Releases
macOS 下载	Releases
Android 版本	Android docs
使用说明	Quick Start
Release 页面	GitHub Releases

Why WordTree / 为什么使用 WordTree

普通背单词工具往往只把单词当作孤立词条。WordTree 更强调词汇之间的结构关系：通过词族、派生形式和多模块练习，把单词从“背过一次”变成“能识别、能拼写、能关联”。

WordTree 的目标不是替代所有英语学习工具，而是提供一个专注、离线友好、数据留在本机的 vocabulary-learning 工作台。

Screenshots / 界面展示

当前仓库已包含真实首页截图和社交预览图：

更多功能页截图待补充，计划文件名已经预留在 docs/images：

• wordtree-flashcards.png
• wordtree-spelling.png
• wordtree-family-tree.png
• wordtree-records.png
• wordtree-social-preview.png

详见 docs/images/README.md。

Features / 功能

• 认词卡片 / Flashcards：看英语或汉语，翻面后标记背过或没背过。
• 限时拼写 / Timed spelling practice：看中文释义拼写英文，按单词长度动态限时。
• 词族树谱 / Word-family trees：查阅词族结构，并支持词族补全练习。
• 练习记录 / Private practice records：记录练习数量、正确、错误和待复习词。
• 词书选择 / Wordbook selection：支持按词书、记忆状态、自选词和智能策略选词。
• 本地优先 / Local-first：核心学习流程可在本地静态网页、桌面端和移动端壳中运行。
• 离线友好 / Offline-first：运行数据文件随应用打包，不依赖运行时网络请求。

关键词：vocabulary-learning, english-learning, flashcards, word-family, spelling-practice, local-first, offline-first, education, electron, capacitor, android, javascript.

Quick Start / 快速开始

在线体验

打开：

https://plumagef.github.io/WordTree/

如果 GitHub Pages 尚未在仓库设置中启用，请见下方 GitHub Pages。

本地网页运行

直接打开 index.html 可以运行。更推荐使用本地静态服务：

python3 -m http.server 8766 --bind 127.0.0.1

然后访问：

http://127.0.0.1:8766/

开发者校验

npm ci
npm run validate

Desktop and Mobile / 桌面端与移动端

平台	状态	下载方式
Web	可用 / Available	GitHub Pages
Windows x64	In development / 开发中	Releases；安装包待上传
macOS Apple Silicon	可用 / Available	Releases
macOS Intel	In development / 开发中	Releases；安装包待上传
Android	In development / 开发中	APK / Release 待上传，见 Android docs

当前公开 v1.0.0 Release 已包含 macOS Apple Silicon 安装包。Windows 和 Android 构建结构已存在，但公开安装包仍需要单独上传到 Release。

开发者构建入口：

npm run desktop:start
npm run desktop:dist:mac
npm run desktop:dist:win
npm run android:sync

更多说明：

• Desktop release docs
• Windows release docs
• Android release docs

Data Privacy / 数据隐私

WordTree 不要求注册账号。练习记录、词书学习状态和挑战记录保存在用户本机的浏览器或 WebView 存储中。

请不要在公开 Issue、截图或 PR 中提交个人学习记录、localStorage 导出或包含隐私内容的练习数据。

Vocabulary Data / 词库数据来源

WordTree 的词库数据来自本地导入和处理后的词书文件，主要来源为：

• KyleBing/english-vocabulary

WordTree 程序代码和词库数据是两部分。项目代码采用 MIT License；词库数据授权需要单独看待。当前上游仓库没有在文件列表中明确展示许可证文件，因此再分发和商业使用权限需要进一步确认。

详见：

• DATA_LICENSE.md
• THIRD_PARTY_NOTICES.md

GitHub Pages

本仓库包含 GitHub Pages 自动部署工作流：

.github/workflows/pages.yml

Pages 发布内容仅包含静态运行所需文件：index.html、styles.css、app.js、assets/、data/ 和 docs/images/。不会发布 Electron、Android、node_modules 或 dist。

如果首次部署没有生效，需要仓库所有者在 GitHub 网页中启用：

Settings -> Pages -> Build and deployment -> Source: GitHub Actions

Roadmap / 开发计划

• 补齐功能页真实截图。
• 上传 Windows x64 安装包到 GitHub Release。
• 生成并上传 Android debug/release APK。
• 完善 Android 横竖屏和小屏交互细节。
• 增加更稳定的词族数据维护流程。
• 后续考虑签名 macOS、Windows 和 Android 正式发布包。

Contributing / 参与贡献

欢迎提交 issue 和 pull request。请先阅读 CONTRIBUTING.md。

基本要求：

• 保持核心学习流程稳定。
• 不改变现有 localStorage 数据键和学习记录数据结构，除非提供迁移方案。
• 不提交 node_modules、安装包、签名文件或私密数据。
• 提交前运行 npm run validate。

License / 许可证

• WordTree source code: MIT License，见 LICENSE。
• Vocabulary datasets: derived from third-party sources, mainly KyleBing/english-vocabulary. See DATA_LICENSE.md.
• Third-party dependencies: each dependency retains its own license. See package.json, package-lock.json and THIRD_PARTY_NOTICES.md.