Word Snap
A bilingual vocabulary matching app with immediate feedback, custom word lists, a personal review engine, on-device sentence checking, and PWA installation. Free, no account, works offline.
This repository holds the app's full source. The main branch is deployed with GitHub Pages to the official site. Feature details, review logic, import format and data notes: GUIDE.md.
Official website
https://guojiz.github.io/word-snap/
Use the site to:
- start a matching round without installing anything;
- add or edit a personal word list;
- get immediate right/wrong feedback;
- review misses with an adaptive queue;
- install it as a PWA on desktop or phone when you want it on the home screen.
Author site ·
X ·
Bilibili ·
YouTube ·
Sponsor
What it is for
Word Snap is a short practice loop, not a course platform.
- Bilingual matching — pair a word with its meaning, then keep going.
- Immediate feedback — see the miss as soon as it happens.
- Your list — practice the vocabulary you actually need.
- Endless practice — the board keeps refilling; timed levels are optional.
- Personal review engine — an FSRS-family memory model fitted to you on your device, graded automatically from your answers and speed.
- Spelling and sentence cards — grammar checked on your device; any correct word order passes.
- Optional on-device AI — a small browser model suggests ideas and example sentences; nothing leaves the device.
- PWA — optional install; the website remains the source of truth.
Start
- Open the official website.
- Start a round.
- If the browser offers it, install the PWA for one-tap practice.
Contributions should make that first practice action faster, clearer, and easier on both desktop and mobile. See CONTRIBUTING.md. Maintainers: MAINTAINING.md.
Other projects with official sites
- GitLearnOS — learner-owned Git memory for AI-assisted study
- Guojiz — builder site and AI-safety manuscript
License
MIT. See LICENSE.
Word Snap（中文）
支持即时反馈、自定义词表、个人复习引擎、本机造句检查和 PWA 安装的双语单词匹配应用。免费、不用账号、可离线。
本仓库是应用的完整源码，main 分支通过 GitHub Pages 部署到官网。功能细节、复习逻辑、导入格式和数据说明见 GUIDE.md。
官网
https://guojiz.github.io/word-snap/
在官网可以：
- 无需安装，直接开始一轮配对；
- 添加或编辑自己的词表；
- 对错立刻可见；
- 用自适应队列复习错过的词；
- 需要时安装为 PWA，放到桌面或主屏幕。
作者站点 ·
X ·
哔哩哔哩 ·
YouTube ·
赞助
它解决什么
Word Snap 是短练习闭环，不是课程平台。
- 双语配对 — 把词和释义对上，然后继续。
- 即时反馈 — 错了立刻看见。
- 自己的词表 — 练真正需要的词。
- 无限练习 — 棋盘一直补词，限时关卡可选。
- 个人复习引擎 — FSRS 一族的记忆模型，在你的设备上按你拟合，根据对错和速度自动评级。
- 内置词书 — 中考、高考、四六级、考研、托福、雅思、GRE（ECDICT 开源词表，按词频排序）。
- 音游判定 — 每次配对按反应速度判 PERFECT / GREAT / GOOD / MISS，进度轨道按判定上色，一组结束 CLEAR 结算；练习页全屏，只有进度和棋盘。
- 每日目标和连续天数 — 今天还剩几个词到期、约几分钟，完成就打勾；每周一次免断签。
- 拼写卡和造句卡 — 语法在本机检查，任何正确的语序都算对。
- 可选的端侧 AI — 安卓 App 在 12GB 内存以上的手机上跑 Qwen3.5 4B（MNN），批改、辨析、例句、词表全离线；网页版用浏览器小模型给思路、补例句。
- 可选的 API Key — 填自己的 Key（DeepSeek、通义、Kimi、Claude 等），造句卡按「错在哪 / 为什么 / 怎么改」批改，混淆词给出辨析，一句话生成词表；任何语言对都能用。
- PWA — 可选用；官网始终是正式入口。
开始
- 打开 官网。
- 开始一轮练习。
- 浏览器提供安装时，可把 PWA 放到主屏幕。
贡献应让第一次练习更快、更清楚，并同时照顾桌面和手机。见 CONTRIBUTING.md。维护清单：MAINTAINING.md。
其它已上线官网的项目
许可证
MIT，见 LICENSE。
