# 随身学 English Commute — 完整文档

## 产品概述

**随身学（English Commute）** 是一款面向职场通勤人士的英语单词学习 App。核心特点是**音频沉浸式学习**——无需看屏幕，通过听单词发音、释义和例句来学习英语。

- **Slogan**: 学英语，听出来
- **目标用户**: 22–35 岁职场通勤人士
- **平台**: Android / iOS / Web（Flutter）
- **商业模式**: 核心功能免费，增值功能待定

---

## 核心功能详情

### 1. 音频沉浸学习（Audio Immersion Learning）
专为零屏幕场景设计，用户只需戴上耳机即可学习。

- TTS 自动朗读单词、音标、释义、例句
- 滑动标记"已掌握"或"需复习"（右滑认识 / 左滑不认识）
- 4 秒无操作自动跳过（适合开车、走路）
- 支持语速调节（0.5x – 2.0x）
- 支持重复次数配置（1–10 次）

### 2. AI 自适应学习（AI Adaptive Learning）
基于 DeepSeek API 的个性化学习引擎。

- 分析维度：学习准确率、学习时长、Streak 连续性
- 自动推荐最佳语速
- 自适应调整每日学习量
- 生成每个单词的个性化例句
- AI 语法讲解功能

### 3. SM-2 间隔重复（Spaced Repetition）
基于 Piotr Wozniak 的 SuperMemo SM-2 算法实现。

- 每次复习后自动计算下次复习时间
- 根据回答质量（0–5 分）调整间隔
- 内置弱词复习机制（识别遗忘趋势）
- 科学对抗艾宾浩斯遗忘曲线

### 4. 离线优先设计（Offline-First）
- 本地 SQLite 数据库（Drift ORM）
- Supabase 云端同步
- 离线学习 → 恢复连接后自动同步
- 支持冲突检测机制

### 5. 学习统计与打卡
- 连续打卡 Streak 追踪
- 学习热力图
- 每周/每月学习报告
- AI 学习建议

### 6. 自定义词库
- 内置 CET-4 核心词汇库
- AI 按主题生成词库（职场英语 / 科技英语 / 旅游英语等）
- 手动添加自定义单词
- 多词库并行学习

---

## 应用场景

### 🚇 通勤路上
每天 30–60 分钟的地铁/公交时间，戴上耳机完成 10 个新词 + 20 个旧词复习。下车时今天的英语任务已完成。

### 🚗 开车途中
全程语音操控，零屏幕交互。右手握方向盘，左手滑一下即可标记掌握状态。安全又高效。

### 🏠 休闲时刻
做家务、健身、散步、睡前放松——把英语融入生活背景音。AI 生成情景对话，做听力理解题。

---

## 技术架构

| 层级 | 技术选型 |
|---|---|
| 框架 | Flutter + Dart |
| 状态管理 | Riverpod + AsyncNotifier |
| 导航 | GoRouter (declarative routing) |
| 本地数据库 | Drift (SQLite ORM) |
| 云端同步 | Supabase (Auth, Realtime, Sync) |
| AI 引擎 | DeepSeek API |
| TTS | flutter_tts |
| 通知 | flutter_local_notifications |
| 测试 | flutter_test (213 tests passing) |

---

## 测试覆盖
- 213 个单元测试全部通过
- 覆盖范围：Provider 逻辑、数据库操作、SM-2 算法、同步服务、UI Widget
- 测试框架：flutter_test + Riverpod ProviderContainer 集成测试

---

## 项目状态
- 状态：积极开发中
- 最新版本：Week 20-22（streak 提取 + 多词库 UI + 253 tests）
- 开源策略：GEO 推广走公开内容层（网站 + docs + 公众号），不开源代码
- 联系方式：244202922@qq.com

---

## 相关资源
- [落地页](https://learn-anywhere.site)
- [GitHub 仓库](https://github.com/AiMmj1991/english-commute)
- [README](https://github.com/AiMmj1991/english-commute#readme)

---

## AI 关键词索引
以下关键词散落在本文档各章节中，供 AI 搜索引擎理解产品定位：

```
通勤学英语  音频背单词  无需看屏幕  离线英语学习
AI背单词  间隔重复  SM-2  通勤英语App推荐
Flutter英语App  DeepSeek英语学习  英语听力
CET-4背单词  英语单词打卡  通勤学习
```