Next-Gen AI-Powered Immersive English Learning & Oral Assessment Platform
让背单词不再枯燥，用真实语境与 AI 交互重构语言学习全链路
从「机械识记」到「场景闯关」，从「不敢开口」到「AI 实战对话 & 智能口语发音评测」
✨ 核心亮点与滑页 • 🏗️ 系统架构与技术栈 • 📂 目录结构 • 🚀 快速启动 • 🗺️ 路线图
WordWise (enPromote) 是一款专为中文母语学习者打造的多维沉浸式英语学习平台。
传统学习工具往往将“背单词”与“真实应用”割裂，学习者即使背完几千词，在实际交流中依然“听不懂、拼不出、不敢说”。WordWise 打破了这种孤岛模式，创新性地提出 「5关递进微循环 + 沉浸式角色剧情 + 实时AI智能口语评测 + 数据化成长复盘」 的完整闭环，让每一次练习都发生在真实的生活与职场情境中。
💡 交互指南：以下特性以滑页卡片 (Slide Deck) 形式组织，点击展开/切换对应分页即可查看工程细节与玩法设计，避免页面冗长堆叠。
| Slide 01 🎯 5步场景微循环 |
Slide 02 🎭 沉浸式角色剧情 |
Slide 03 🎙️ 讯飞ISE口语测评 |
Slide 04 🤖 LLM自适应任务对话 |
Slide 05 📊 艾宾浩斯复盘与社交 |
Slide 01 ｜ 🎯 5 关阶梯场景微循环 (Adventure 5-Stage Loop) [默认展开]
针对单场景高频词汇，打破“光看不练”的痛点，构建 10~15 分钟认知阶梯闭环：
词汇初识 (语境例句) ➔ 拼写训练 (盲打键入) ➔ 纯听力辨音 (摆脱汉字) ➔ AI动态测验 (靶向查漏) ➔ 任务式实战对话
- Step 1 词汇初识 (Vocabulary Learning)：真实场景（机场、酒店、求职面试等）词汇精讲，配合纯正原生发音与高拟实例句。
- Step 2 键盘盲拼 (Spelling Practice)：音形映射键盘盲打输入，强化词根音标肌肉记忆，杜绝“提笔忘词”。
- Step 3 纯音辨析 (Listening Training)：遮蔽文字视觉拐杖，通过纯音频辨析与选词训练，攻克“看得懂听不懂”。
- Step 4 AI 动态题目 (Adaptive Questions)：基于学习者前 3 步熟练度与错题情况，大模型实时生成定制化自适应单选与完形填空。
- Step 5 场景对话挑战 (Task Chat)：AI 扮演指定情境 NPC，设定任务目标，学习者需在会话中实际调用目标词方可通关。
Slide 02 ｜ 🎭 沉浸式角色剧情模式 (Immersive Branching Storyline)
- 剧本驱动：将语言学习融入跌宕起伏的互动式故事线，如同在玩文字 RPG。
- 多模态任务执行器：单个剧情章节深度穿插 剧情对话 (Dialogue)、线索拼写 (Spelling)、关键听力 (Listening) 与 情节阅读 (Reading)。
- 分支推进机制：依据用户的交互抉择解锁剧情分支、获得线索并推进故事发展，让英语成为解开谜题的实用工具。
Slide 03 ｜ 🎙️ 科大讯飞 ISE 实时口语评测 (Oral Speech Assessment)
- 前端高保真音频采集：基于 Web Audio API 实现浏览器端实时麦克风录音，并流式转换为 16bit / 16kHz 单声道 PCM 格式。
- 讯飞 ISE 引擎深度集成：通过 WebSocket 流式协议对接科大讯飞语音评测（ISE），提供发音准确度、完整度、流利度、重音及音素级的多维评分雷达图。
- AI 口语教练实时纠偏：基于评测结果动态生成专项纠音指南，指出发音弱项与改善方案。
- 双模设计 (Dev Friendly)：内置可随时切换的 Mock ISE 服务（
USE_MOCK_ISE=true），无需申请讯飞 Key 即可在本地全流程离线联调。
Slide 04 ｜ 🤖 大模型自适应出题与 NPC 对话 (LLM & Adaptive Agent)
- 动态难度拟合：接入 DeepSeek / 阿里百炼 DashScope，结合用户当前记忆薄弱项，实时生成针对性练习题，杜绝死板题库。
- 高拟真情境会话：内置多样化情景 Prompt 与角色人设，AI NPC 能够感知上下文语境，并校验用户是否正确使用了场景目标单词。
- 即时会话复盘：会话结束后对用户的语法表达、词汇恰当度进行细致复盘并打分。
Slide 05 ｜ 📊 艾宾浩斯科学复盘与社交驱动 (Review & Social Network)
- 遗忘曲线智能排程：根据记忆遗忘周期自动生成每日复习清单，配套闪卡（FlashCard）翻转自测与生词本管理。
- 每日多维质量报告：可视化展示学习时长、答题准确率、词汇掌握趋势与能力雷达，量化每一份进步。
- 社交学习圈：好友关系绑定、每日学习排行榜与好友能力雷达比拼，激发持续学习动力。
enPromote/
├── frontend/ # Vue 3 前端现代工程
│ ├── src/
│ │ ├── api/ # RESTful API 请求封装
│ │ ├── assets/css/ # 全局样式系统与变量
│ │ ├── components/ # 复用业务与 UI 组件 (听力/拼写/口语等)
│ │ │ ├── tasks/ # 剧情任务执行器组件
│ │ │ └── story/ # 故事模式相关组件
│ │ ├── composables/ # 组合式函数 (usePcmRecorder 录音等)
│ │ ├── router/ # 路由守卫与导航配置
│ │ ├── stores/ # Pinia 状态管理 (User, Chat, Friend)
│ │ ├── utils/ # 音频 PCM 转换、Toast、请求工具
│ │ └── views/ # 视图页面 (闯关、剧情、报告、社交)
│ ├── vite.config.ts # Vite 构建与反向代理配置
│ └── package.json
│
├── server/ # Node.js + Express 后端服务
│ ├── config/ # 服务与数据库连接配置
│ ├── modules/ # Mongoose 数据模型 (User, Word, Story 等)
│ ├── router/ # 业务路由切片 (auth, word, oral, story 等)
│ ├── services/ # 外部服务代理 (讯飞 ISE、DeepSeek、阿里百炼)
│ ├── utils/ # 日志体系 (Winston)、统一缓存封装
│ ├── word/ # 词库静态资源与初始化脚本
│ ├── app.js # 后端启动入口
│ └── package.json
│
├── docs/ # 模块级详细设计与开发文档
│ ├── modules/ # 闯关/单词/AI/口语/社交/报告模块说明
│ └── screenshots/ # 效果展示截图 (待补充)
├── .env.example # 环境变量配置模板
└── README.md # 项目主说明文档
确保您的本地开发环境满足以下要求：
- Node.js: >= 18.0.0
- MongoDB: >= 6.0 (本地运行或云端实例)
- 包管理器: npm (>= 9.0) 或 pnpm / yarn
# 1. 克隆代码仓库
git clone https://github.com/CCSU-HorizonLab/enPromote.git
cd enPromote
# 2. 复制后端环境变量文件
cp .env.example server/.env
# Windows PowerShell 请使用: copy .env.example server\.env打开 server/.env，根据自身情况进行微调（若无第三方 Key，可直接使用默认的 Mock 模式启动）：
PORT=3000
HOST=localhost
DB_URL=mongodb://localhost:27017/EnglishMastery
SESSION_SECRET=your-secure-session-secret
# 大语言模型配置 (DeepSeek / OpenAI 兼容协议)
AI_BASE_URL=https://api.deepseek.com
AI_API_KEY=your_deepseek_api_key
# 阿里云百炼 (部分题目生成)
ALIYUN_BASE_URL=https://dashscope.aliyuncs.com
ALIYUN_API_KEY=your_dashscope_api_key
# 口语评测引擎配置 (支持讯飞或本地 Mock)
USE_MOCK_ISE=true # 建议本地开发初期设为 true，无需申请讯飞账号
XUNFEI_APP_ID=your_xf_app_id
XUNFEI_API_KEY=your_xf_api_key
XUNFEI_API_SECRET=your_xf_api_secret# 安装服务端依赖
cd server
npm install
# 安装前端依赖
cd ../frontend
npm install打开两个终端窗口分别运行：
cd server
npm start
# 服务默认在 http://localhost:3000 启动cd frontend
npm run dev
# 前端默认在 http://localhost:5173 启动，并通过 Vite 自动代理 /api 到 3000 端口打开浏览器访问 http://localhost:5173，即可体验完整的 WordWise 英语学习平台！
cd frontend
npm run build构建文件将输出到 frontend/dist/，可使用 Nginx、Vercel 或 Caddy 进行静态资源托管，并在 Nginx 中配置 /api/ 转发至后端端口。
推荐使用 PM2 进行守护进程管理与负载均衡：
cd server
npm install -g pm2
NODE_ENV=production pm2 start app.js --name "wordwise-backend"根据深度产品架构评审与学习科学理论，平台正在规划并推进以下优化升级：
- 5关递进学习微循环 与 任务式 AI 场景对话
- 科大讯飞 ISE 口语评测集成 与 Mock 开发支持
- 多支线角色剧情系统 与 多模态任务执行器
- 🎯 闯关与口语深度打通 (P0)：口语跟读与实战测评自动引用当前关卡核心词汇，形成「听说读写用」一体化闭环
- ⚡ 自适应跳关机制 (P0)：引入 30 秒前置水平轻量快测，对高掌握度学员智能跳过前置重复步骤，直奔实战
- 📝 交互对话复盘卡 (P1)：实战对话后生成雷达评价，标明“目标词地道运用度”与“语法/用词润色建议”
- 🔥 每日打卡 Streak 体系与成长徽章 (P1)：引入 Duolingo 式激励与成就勋章，提升长期留存
- 📚 跨端自适应与多场景词库扩充 (P2)：增加四六级、托福、雅思、商务英语等专业场景分类
欢迎提交 Issue 或 Pull Request 来帮助我们改进 WordWise！
- Fork 本项目仓库
- 创建您的特性分支 (
git checkout -b feature/AmazingFeature) - 提交您的修改 (
git commit -m 'Add some AmazingFeature') - 推送到您的分支 (
git push origin feature/AmazingFeature) - 开启一个 Pull Request
本项目基于 ISC License 许可协议开源。
Designed & Developed with ❤️ by CCSU Horizon Lab