# EnglistReadCard

**Repository Path**: lfy86/englist-read-card

## Basic Information

- **Project Name**: EnglistReadCard
- **Description**: 变程度单词学习项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-04
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EnglishReadCard - 英语单词听写网页

一个基于纯前端技术实现的英语单词听写应用，帮助用户通过听写的方式高效记忆单词。

## ✨ 特性

- 🎧 **语音播放**：使用浏览器 Web Speech API 朗读单词
- ⚡ **即时反馈**：实时检测拼写对错
- 📊 **进度追踪**：显示学习进度和正确率
- 🔄 **错词复习**：针对性复习错误单词
- 📱 **响应式设计**：完美适配移动端和桌面端
- 💾 **离线可用**：无需后端，数据本地存储

## 🚀 快速开始

1. 克隆或下载本项目
2. 在浏览器中打开 `index.html`
3. 选择词库或上传 CSV 文件
4. 开始听写！

## 📖 文档

详细的项目文档保存在 `readme/` 目录中：

- [01-项目需求讨论.md](readme/01-项目需求讨论.md) - 完整的需求分析和技术方案

## 📝 支持的数据格式

当前支持 **CSV 格式**词库：

```csv
word,translation
apple,苹果
banana,香蕉
study,学习
```

## 🛠️ 技术栈

- HTML5
- CSS3
- JavaScript (ES6+)
- Web Speech API
- LocalStorage

## 📦 项目结构

```
EnglishReadCard/
├── index.html              # 主页面 ✅
├── css/                    # 样式文件
│   ├── style.css          # 基础样式 ✅
│   ├── desktop.css        # 桌面端样式 ✅
│   └── components.css     # 组件样式 ✅
├── js/                     # JavaScript 模块
│   ├── app.js             # 主应用入口 ✅
│   ├── storage.js         # 本地存储管理 ✅
│   ├── wordbook.js        # 单词本管理 ✅
│   ├── speech.js          # 语音管理 ✅
│   ├── dictation.js       # 听写模式 ✅
│   ├── recitation.js      # 背诵模式 ✅
│   ├── history.js         # 学习历史 ✅
│   ├── wrongbook.js       # 错词本管理 ✅
│   ├── statistics.js      # 统计分析 ✅
│   └── keyboard.js        # 键盘快捷键 ✅
├── data/                   # 词库文件
│   ├── android-dev-common.csv      ✅
│   └── typescript-dev-common.csv   ✅
├── readme/                 # 项目文档
│   ├── 01-项目需求讨论.md
│   ├── 02-编程词汇听写需求.md
│   ├── 03-单词本管理功能.md
│   ├── 04-背诵和听写模式设计.md
│   ├── 05-UI设计规范.md
│   ├── 06-需求确认总结.md
│   └── 07-需求补充和调整.md
└── README.md               # 本文件
```

## 📅 开发状态

- [x] 需求分析
- [x] 框架搭建
  - [x] HTML 结构
  - [x] CSS 样式系统
  - [x] JavaScript 模块架构
  - [x] 内置词库
- [ ] 功能实现（进行中）
  - [ ] 单词本功能完善
  - [ ] 听写模式实现
  - [ ] 背诵模式实现
  - [ ] 学习历史功能
  - [ ] 错词本管理
- [ ] 测试优化

## 📄 开源协议

TBD

---

**项目创建时间**: 2025-11-03