WordPecker

WordPecker是什么？

WordPecker是一款开源免费的个性化外语学习软件，结合Duolingo风格的互动课程与用户自定义词汇表，可以方便从书籍、文章或者视频当中任意添加新单词，并利用闯关和AI课程复习它们。它应用中的视觉花园可以帮你自然而然地“发现”新单词，并且学习语音对话、单词详情页和多语言。它是提高词汇的效率，练习说外语的好工具。

WordPecker的主要功能

• 个性化词汇学习：可从阅读或视频中添加生词，自动生成拼写及例句。
• 闯关题型：提供选择题、填空题、匹配题、判断题、填空句型句等多个形式。
• 视觉花园（Vision Garden） ：通过对图片进行“描述”来发现新词汇，视觉花园还会给你推荐相关用法单词，起到趣味性作用。
• 语音对话练习：内置 AI 语音导师，可以跟其进行语音对话，练习自己的发音，并得到实时反馈。
• 词汇详情页：每个单词都有专属页面，展示上下文用法、例句、同义词及视觉化学习内容。
• 多语言支持：支持任意语言之间的学习，例如用中文学习英语，或用西班牙语学习日语。
• 模板词库：提供分类（如按主题、按难易）的词汇模板库，能够直接取用模板。

适用人群

• 想要自定义学习内容的外语学习者。
• 缺乏语言环境，但希望通过 AI 模拟对话练习口语的人。
• 需要 高效扩展词汇量 的学生、自学者或语言爱好者。 

WordPecker的部署使用教程

1. 环境准备

支持 Windows、macOS 和 Linux，需安装 Node.js ≥ 16、npm 或 yarn、MongoDB，以及 OpenAI API Key（可选接入 Pexels 和 ElevenLabs）。

2. 安装步骤

1. 克隆项目：

git clone https://github.com/baturyilmaz/wordpecker-app.git
cd wordpecker-app

2. 安装依赖：

# 后端
cd backend
npm install
# 前端
cd ../frontend
npm install

3. 配置数据库：本地安装 MongoDB，或使用 MongoDB Atlas。启动数据库服务。

4. 配置环境变量：在 backend/.env 中添加VITE_API_URL=http://localhost:3000

PORT=3000
OPENAI_API_KEY=你的OpenAI密钥
MONGODB_URL=mongodb://localhost:27017/wordpecker
PEXELS_API_KEY=可选
ELEVENLABS_API_KEY=可选

3. 启动应用

启动后端：

cd backend
npm run dev

启动前端：

cd frontend
npm run dev

浏览器访问 http://localhost:5173 即可使用。

4. Docker 快速部署

如果你不想手动配置，可以直接用 Docker：

git clone https://github.com/baturyilmaz/wordpecker-app.git
cd wordpecker-app
cp .env.docker .env # 填写 API Key
docker-compose up –build

• 前端访问：http://localhost:5173
• 后端 API：http://localhost:3000
• MongoDB：localhost:27017（默认账号：admin / password）