Skip to content
leoon-huPublic

About

功能完整、免费开源的背单词网站:FSRS 间隔重复,21 本内置词库,AI 填充的词条资料,真人级发音,跑步模式熄屏循环听。面向海外中文用户 · Next.js 15 + Prisma + PostgreSQL

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

AI加词

功能完整、数据完善、操作易用、免费开源、干净安全的背单词网站:内置 / 导入词库 → 每日按计划学习 → 认识 / 模糊打分 → FSRS 间隔重复安排复习;戴上耳机开跑步模式,手机熄屏放口袋也能循环听今天的词。词条的核心义、义项、例句、搭配、句型、辨析、词族、助记、词源由 AI 离线填充、全局共用(还没有资料的词可以当场点「生成 AI 资料」,生成后大家共用),同类词(家庭成员、水果、学科……)来自手工整理的分类词表;用户可以写备注和反馈问题,不修改词条本身。仅中文界面,面向海外英语学习者;一套代码同时照顾手机与桌面,手机上可加到主屏幕当应用用。

Next.js 15(App Router)+ TypeScript + Prisma + PostgreSQL 16,前后端同仓,应用就是仓库根目录。

在线使用:jiaci.app(邮箱验证码登录,免费;词条与内置词库在 jiaci.app/dict 公开可查,不用登录)

代码与数据结构全部开源(MIT)。 不只是应用源码:数据库表结构与迁移(prisma/)、词条 AI 字段的定义与校验契约(src/lib/ai/schema.ts)、内置词库的词表与选词规则(lists/、src/lib/wordbook-rules.ts),以及词典导入 / 词库构建 / AI 填充 / 发音生成的离线脚本(scripts/)都在这个仓库里。可以照此自行部署一套,也可以只拿数据模型与词表去做自己的东西。免费、无广告、不卖数据,学习记录随时导出、账号随时注销;站内页脚与设置「关于」都写着这一句并链到仓库。「分享给朋友」一键调系统分享面板(微信里教用右上角菜单,电脑上复制一段话 + 链接),学完当天任务的页面还能分享今天的成绩。

今日学习 学习卡片 单词详情 单词列表

English · Jiaci (AI加词) is a full-featured, free and open-source vocabulary trainer for Chinese speakers learning English: pick one of 21 built-in word lists or import your own → study a daily queue of cards → rate each one know / fuzzy → FSRS schedules the reviews. Word entries (core meaning, senses, examples, collocations, word family, mnemonics, etymology) are pre-generated offline by an LLM and shared by all users (a word that has no entry yet can be generated on demand with one tap, rate-limited per user); pronunciation is server-side neural TTS for words, sentences and translations. Run mode stitches today's words, meanings and example sentences into one looping audio track so you can keep listening with the phone locked in your pocket, with lock-screen and headset controls. No ads, no data selling, export or delete your account any time. Chinese UI only. Next.js 15 · TypeScript · Prisma · PostgreSQL. Open source under MIT — the code and the data model (database schema, word-entry field contracts, word lists, offline scripts) all live in this repo. Live at jiaci.app.

特点

  • 功能完整:FSRS 间隔重复、21 本内置词库与导入 / 自建、学习卡与单词详情(释义 / 关联词 / 记忆 / 词频)、列表拖拽 / 多选 / 书签 / 两种自测、按词库独立进度、跑步模式、番茄钟、单词搜索、公开词典、装成应用、深色模式、桌面快捷键、数据导出。
  • 数据完善:2.8 万个单词与短语,每个词有词典字段(ECDICT)与 AI 填充的十几个学习维度(核心义、义项、例句、搭配、句型、辨析、词族、助记、词源、语域、常见错误),5600 多个常用词还按语义类别互相关联(约 230 个类别的手工分类词表:mother ↔ father / brother / sister,apple ↔ banana / orange);单词、例句、中文释义与例句译文全部有真人级发音;21 本词库按公开考试大纲与 NGSL / NAWL / AWL 整理。
  • 操作易用:邮箱验证码登录,无需密码;每次只答「认识 / 模糊」,长按上滑 已掌握 / 重新记;列表横向拖动一行直接操作;手机与桌面一套代码,手机上加到主屏当应用用。
  • 免费开源:MIT 许可,代码、数据库结构、词条字段契约、词表与离线脚本全部公开,谁都能查、也能自己部署;免费、无广告。
  • 干净安全:不卖数据,没有社交与打卡,只收邮箱一项个人信息;学习记录随时导出,账号随时注销(30 天彻底删除);浏览、学习时不调用任何 AI 接口,只有对没有资料的词主动点「生成 AI 资料」才调一次模型,发出去的只有这个词与词典释义。

跑步模式

跑步模式播放页

戴上耳机跑步、走路、通勤时打开跑步模式:把今天要学和已学的词(每轮 30 / 50 / 100 / 150 个可选)连同中文释义(带词性)、1–3 条例句拼成一整段音频循环播放。开跑前一次下载好,之后不再碰网络;手机熄屏、切到别的应用都不停。

  • 例句中英对照、句中本词高亮;可只读英文,或英文后接中文译文。
  • 锁屏与通知栏的媒体控件、耳机线控都能暂停、切上一个 / 下一个;来电、耳机断开一律停在暂停态,不会自动外放。
  • 单词、释义、例句撑满一屏,字大,跑步时看一眼就清楚;「播放时保持亮屏」默认开,走路、健身房里可以一直看着。
  • 一个圆形大按钮悬浮在屏幕底部(也可以放到顶部),点开是一列大按钮:上一个 / 暂停 / 停止 / 下一个,以及对当前词的「加进度」(记一次认识,这次不再播它)、「已掌握」(以后不再学)、「重放」(这遍读完后再读两遍);播放一直连续,不会因此停顿。电脑上有快捷键:空格 暂停 / 继续,← → 切词,S 停止,1 加进度,3 已掌握,R 重放。
  • 例句里的每个词都能点:弹出点词小框看释义、听发音,点小框进单词详情,播放不停。
  • 每个词读几遍、词间间隔、语速、例句读法与条数随时改,改完接着播;离开页面也不停,底部小条可随时回来。

设计初衷

做一个边上班边学英语背单词的好工具。 尝试过众多背单词应用,也开通过会员,不过或多或少都不太满意,所以手搓了一个,力求功能完整、数据完善、用起来顺手,满足个人学习需求。 后期可能会尝试收取一些费用或加少量广告,作为服务器和 AI 费用的补贴。

功能概览

模块 内容
登录 邮箱验证码,首次登录自动注册;长期登录,活跃自动续期
学习 首页显示当前词库与今日任务(待学新词 / 待复习 / 今日已完成)→ 学习卡片:正面只给拼写、音标、发音、学习记录与例句英文,点击屏幕显示答案 → 打分:认识 / 模糊,长按上滑 已掌握 / 重新记 → 今日完成、再学一组(额外新词);桌面端有快捷键。跑步模式:把今天的词(待学 + 已完成,每轮 30–150 个可选)连同释义、例句(1–3 条,中英对照、本词高亮,可只读英文或英文接中文)拼成一整段音频循环播放,手机熄屏放口袋也不停,锁屏与耳机可暂停、切词;想看着屏幕时可让它保持常亮(默认开);播放页大字,一个圆形大按钮(可放底部或顶部)点开菜单:上一个 / 暂停 / 停止 / 下一个、给当前词加进度或标已掌握(这次不再播它)、重放两遍,电脑上有快捷键;例句里的词可点,弹出点词小框、可进详情
单词详情 站内点词是从右侧滑入的全屏浮层,原页面的筛选与滚动位置不丢;刷新或直接打开链接是独立整页。顶部固定单词 / 音标 / 发音,其下四个 Tab(释义 / 关联词 / 记忆 / 词频)可点击或左右滑动切换;关联词 Tab 末尾有默认折叠的「同类词」(按类别列出同类的词,每个词带释义);正文里的英文都能点,弹出小框看发音与释义(点到变形按词典找原形,本身是别的词的变形时会注明「也是 find 的过去式」),小框里也能直接加进自己的词库;备注、反馈、加入我的词库(列出自建词库、标出已经有这个词的那几本,也能当场新建一本)、学习记录时间线、例句朗读、进入自动朗读、切换词条资料来源
词库 三个 Tab(正在学习 / 我的词库 / 内置词库),内置 / 导入 / 自建三类,21 本内置词库(高频三级、八套考试、学术词汇、常用短语与词组、海外生活六本);导入 txt(每行一词)或手动添加;自己的词库(导入 + 自建)每人最多 3 本
单词列表 每行进度饼图 + 小喇叭 + 单词 + 主释义;按状态筛选、中英搜索、五种排序、滚到底自动加载。「隐藏释义 / 隐藏英文」两种自测模式;横向拖动一行露出「取消 / 书签 / 重新记 / 加进度 / 已掌握 / 移出」(自建词库多一个「删除」,从这本里删掉),长按进入多选,同一排操作(书签除外)对选中的词批量执行(任何词库都能把选中的词批量加进自建词库,已经在里面的自动跳过),操作可在几秒内撤销;书签记住停在哪个词和当时的筛选条件,下次一键跳回
番茄钟 顶栏右侧一个按钮:选专注 25 / 45 / 60 分钟、休息 5 / 10 / 15 分钟,开始后顶栏显示倒计时(学习卡片页顶行也有),到点响一声自动转休息;可暂停、放弃;只存本设备
单词搜索 顶栏一个搜索按钮,登录与未登录都能用:边输边出结果,英文按前缀(输变形先给原形:went → go,拼错了给「你要找的是不是」),中文按释义;点一条打开单词详情(未登录是公开词条页)。搜索记录只存在本设备的浏览器里,不上传
公开词典 /dict/<单词> 与 /dict/book/<词库> 不用登录即可查看:词条资料(去掉个人部分;助记、词源与构词、易混词、常见错误四块登录后可看;同类词全部展开、互相链接)与内置词库词表,供搜索引擎收录;分享出去的 /word/… 链接未登录时也会落到这里
设置 每日新词量、复习上限、学习顺序、新词顺序、口音、声音、例句小喇叭位置、自动发音、自动朗读、主题、词条资料来源、导出数据、注销,以及隐私政策与服务条款;「关于」里显示当前版本(构建时刻),「检查更新」和服务端正在跑的版本比对,有新版本就刷新到新版,还不行可以清除缓存重新加载;跑步模式的词数 / 遍数 / 释义 / 例句读法与条数 / 间隔 / 语速 / 播放时保持亮屏 / 操作按钮位置在跑步页里改,随账号保存

学习算法用 FSRS(ts-fsrs):按目标记忆保持率安排复习,难词密、简单词疏,间隔达到阈值自动转为已掌握。单词状态只用四色表示(已掌握绿 / 学习中黄 / 未开始红 / 未加入灰),正文里的单词不按状态着色。

目录结构

prisma/          数据模型、迁移与种子(系统配置初始值)
src/lib/         领域逻辑:scheduler.ts 调度、status.ts 四色状态、study.ts 队列与打分、
                 dict.ts 词典、wordbook-rules.ts 内置词库选词、word-view.ts 词条视图、
                 ai/ 字段契约与填充、tts/ 发音合成、auth.ts 登录、config.ts 系统配置、
                 client/ 浏览器端的请求、朗读与页面间通知
src/app/         api/ 为 Route Handlers,(app)/ 为登录后页面(@detail 是单词详情浮层的平行路由),
                 page.tsx 是未登录看到的落地页,login/ 登录,legal/ 隐私政策与服务条款,
                 robots.ts 只禁接口与 SEO 工具的爬虫、sitemap 只列公开页,not-found.tsx 是全站 404,globals.css 是整套样式的源头
src/components/  共用组件(单词详情、打分栏、滑动 Tab、饼图、弹层、导航壳)
scripts/         离线脚本:词典导入、内置词库构建、同类词构建、AI 字段填充、发音音频生成、内容数据同步、定期清理
lists/           内置词库的词表文件(考试大纲、学术与通用核心词表、场景词表、排除表、补充词典)与同类词的分类词表
public/          图标与 PWA 清单、Service Worker、落地页截图(shots/)与分享卡片图(og.png)
tests/ e2e/      单元测试、端到端与截图脚本

本地开发

需要 Node.js 20+、Docker(或任意 PostgreSQL 16)。

# 1. 数据库
docker run -d --name aiword-pg \
  -e POSTGRES_PASSWORD=aiword -e POSTGRES_USER=aiword -e POSTGRES_DB=aiword \
  -p 127.0.0.1:5432:5432 postgres:16-alpine

# 2. 应用(在项目根目录)
cp .env.example .env        # 按需填写各项
npm install
npx prisma migrate deploy   # 建表
npm run db:seed             # 系统配置初始值
npm run dev                 # http://localhost:3000

没有配置邮件服务的 Key 时,开发环境的验证码直接显示在登录页上。线上要在 .env 里写 SITE_URL(对外地址),分享卡片、robots 与 sitemap 里的绝对地址都按它拼;登录页与 robots / sitemap 是构建时预渲染的,在别的机器上构建时那台机器的 .env 也要有。

访问统计(可选):构建机的 .env 里同时写 NEXT_PUBLIC_UMAMI_SCRIPT=https://你的统计站/script.js 与 NEXT_PUBLIC_UMAMI_WEBSITE_ID=<站点 id>,每页会多一行 Umami(开源、无 cookie)的上报脚本,只记页面、来源、设备与地区,账号与学习记录不上报、查询串也不带;data-domains 取 SITE_URL 的主机名。两项都不配就什么都不加(逻辑在 src/lib/analytics.ts + components/Analytics.tsx)。

命令 说明
npm run dev / build / start 开发 / 构建 / 生产启动
npm test 单元测试(调度算法、词典与选词规则、词条视图、AI 填充校验、生成 AI 资料的限次与封禁规则、发音文本、跑步模式拼接计划、导入解析、限速、日期)
npm run typecheck / npm run lint 类型与代码检查
npm run e2e 端到端 UI 测试(需先 npm run dev,使用本机 Chrome)
npm run e2e:shots [-- 1280 900] 全页面截图回归,默认手机视口
npm run readme:shots 重新生成 README 与落地页用的截图(public/shots/,需本机有内置词库、AI 资料与发音音频;ONLY=run 只截跑步模式一张)

内容数据

建完表的数据库里没有词条和词库,按下面的顺序生成(都不调用付费接口):

# 词典:下载 ECDICT 的 ecdict.csv 到 data/ecdict/,全量写入 dict_entry,再按规则筛入 word 表
npm run dict:load
npm run dict:sync

# 内置词库:按 scripts/wordbooks.ts 的定义 + lists/ 下的词表生成,可重复执行
npm run wordbooks:build -- --dry-run     # 先看每本的词数与缺词
npm run wordbooks:build

# 同类词:按 lists/同类词.tsv(一行一个类别:类别名 <TAB> 词, 词=释义, 词;多义词用「词=释义」指定这个类别里显示的义项)写入,只收 word 表里有的词,可重复执行
npm run categories:build -- --dry-run    # 先看每个类别的词数与找不到的词
npm run categories:build

词条的 AI 资料用 npm run ai:fill 填充(需要在 .env 里配模型厂商的 Key,付费;配了 DEEPSEEK_API_KEY 的话,用户也能在详情页对没有资料的词点「生成 AI 资料」现场生成一份,每人每天有次数上限),发音音频用 npm run audio:generate 生成(Edge-TTS,免费,也可换成自托管的 Kokoro);没有这两样应用照常可用——详情用词典释义兜底,发音缺文件时按需合成、再不行退到浏览器语音。各脚本的参数见文件头部注释。

设计要点

  • 浏览时不调用 AI:词条的 AI 资料由离线脚本按学习维度拆成字段、经 zod 契约校验后写库,按模型厂商分表、全局共用;用户可在设置里选资料来源(自动 / DeepSeek / OpenAI),没有 AI 资料的词用词典字段兜底显示。唯一会在线上调模型的地方是详情页的「生成 AI 资料」:只对一家资料都没有的词开放,服务端后台生成(同一套提示词与校验)、页面轮询,每人 24 小时 / 每分钟与每个 IP 都有次数上限,被拒太多次自动封一段时间。
  • 发音:单词、例句与中文释义都播放服务端 MP3(预生成,缺失时按需合成),播放失败兜底浏览器 Web Speech;口音 × 声音四种组合。跑步模式在开跑前把当天所有片段下载好、按字节拼成一整段(片段格式统一,词间间隔是拼进去的静音帧)交给一个循环播放的 <audio>——熄屏后浏览器只保留正在播放的媒体元素,播放中不换源、不用定时器、不碰网络;锁屏控件走 MediaSession。
  • 可运营调整的参数集中在数据库配置表,改库即生效,无需发版;密钥只放环境变量。
  • 算法与状态是纯函数:FSRS 调度、四色状态判定、选词规则都在 src/lib/ 里,有单测覆盖;列表的筛选 / 搜索 / 排序 / 分页 / 计数全部下推到 SQL。
  • 列表操作先本地生效、延迟提交,几秒内可撤销;打分请求幂等,离线时暂存、恢复后重试。
  • 样式是一套 CSS 变量体系(未用 Tailwind),支持浅色 / 深色主题、手机底部 Tab 与桌面顶部导航;基础 PWA,只缓存静态资源;没装成应用时学习首页顶部有一条「安装 AI加词」引导(Android / 电脑 Chrome、Edge 直接调起安装框,iPhone / iPad 给出 Safari 分享 → 添加到主屏幕的步骤,微信里教先在浏览器打开;关掉 3 天后再出现)。

数据来源与致谢

  • 词典数据来自 ECDICT(MIT)。
  • 通用核心词表 NGSL 与学术词表 NAWL 来自 newgeneralservicelist.org(Browne / Culligan / Phillips,CC BY-SA 4.0);学术词表 AWL 来自 Coxhead (2000)。
  • 考试词表参照公开大纲整理;各词表的出处写在 lists/ 对应文件的头部。
  • 间隔重复算法为 FSRS(ts-fsrs,MIT)。

同一作者的其它学习应用

  • 同步练-对战版:把人教版课本的知识点测验变成游戏积分,谁先答对 8 题谁赢——打机器人、两人一台或多设备扫码组队;也能一个人安静地练,汉字注音、题目朗读。
  • 拼音学习机:给学拼音的孩子的点读 / 拼读 / 跟读 / 测验键盘,真人录音。
  • 识字卡片:2–4 岁看图听音认知卡片,中英文。

联系作者

有问题、建议或想要的功能,欢迎加作者微信直接说(站内页脚与设置「关于」里的「联系站长」是同一张二维码):

作者微信二维码

支持赞助作者,继续优化本应用体验(站内「联系站长」里是同一张赞助码):

微信支付赞助码

许可

代码与数据结构均以 MIT 许可开源:应用源码、prisma/ 下的数据库表结构与迁移、src/lib/ai/schema.ts 的词条字段契约、scripts/ 下的离线脚本都可以自由使用、修改与再分发。lists/ 下词表文件与词典数据的出处及各自的许可见上一节。

About

功能完整、免费开源的背单词网站:FSRS 间隔重复,21 本内置词库,AI 填充的词条资料,真人级发音,跑步模式熄屏循环听。面向海外中文用户 · Next.js 15 + Prisma + PostgreSQL

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages