最新修改 2025年 12月 31日 by amiao
作者前言
以前背单词很痛苦，自从发现自然拼读这个方法以后，很多单词都是顺口就能拼，很是受用，但是无奈课程上的单词太少了，就想着有没有根据这个规律来背单词的工具，找了很多，大多数都是什么46级词数，雅思核心，诸如此类的背单词软件，还有那个什么记忆曲线什么的，看了就头疼。就没有一个简简单单的，打开就能根据发音练习一下的app吗？答案是没有的。
所以，既然现在都是有想法就能靠ai来帮助实现的时代，为什么我自己不搓一个呢？搓一个完美符合自己练习需求的工具。于是就诞生了这个：
项目截图
功能介绍
- 系统化学习：26个字母、短元音、长元音、辅音组合等完整拼读体系
- 真人发音：支持真人录制的发音音频，没有音频时使用微软 Edge TTS
- AI 扩词：用 GPT-4o-mini 智能扩展词汇，需要配置自己的 API Key
- 词典验证：CMUdict + ECDICT 双词典验证，确保单词真实存在
- 词库共享：AI 生成的词汇自动保存到服务器，所有用户共享
快速开始
本地运行
npm install npm start # 访问 http://localhost:3000
Docker 部署
# 开发环境 docker-compose up -d # 生产环境（带 Nginx） docker-compose -f docker-compose.prod.yml up -d
服务器部署
- 安装 Docker
curl -fsSL https://get.docker.com | sh
- 克隆代码并启动
git clone <repo-url> phonics-app cd phonics-app docker-compose up -d
- 配置反向代理（可选）
编辑 nginx.conf 修改域名，然后：
docker-compose -f docker-compose.prod.yml up -d
配置 AI 扩词
点击页面右上角的齿轮按钮，输入你的 OpenAI API Key。
Key 只保存在你的浏览器本地，不会上传到服务器。AI 生成的单词会保存到服务器词库，供所有人学习。
添加真人发音
把音频文件放到 data/phonics-audio/ 目录：
- 字母发音：
a.mp3、b.mp3 - 组合发音：
sh.mp3、th.mp3 - Magic E：
a_e.mp3
支持 MP3、WAV、OGG 格式。
项目地址
GitHub地址：https://github.com/cocojojo5213/phonics-app
作者自己部署了一套服务，带有真人发音音频。欢迎大家使用自己的 API Key 来扩展词库，你贡献的单词会保存到服务器，其他学习者也能看到。一起学习，共同进步。
在线体验: phonics.thetruetao.com