# vocabulary

**Repository Path**: qdd888/vocabulary

## Basic Information

- **Project Name**: vocabulary
- **Description**: 英语学习-听写功能APP
- **Primary Language**: Android
- **License**: MIT-0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vocabulary - 英语听写助手-学习应用

[![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white)](https://developer.android.com/)
[![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?style=for-the-badge&logo=kotlin&logoColor=white)](https://kotlinlang.org/)
[![Jetpack Compose](https://img.shields.io/badge/Jetpack%20Compose-4285F4?style=for-the-badge&logo=jetpackcompose&logoColor=white)](https://developer.android.com/jetpack/compose)

一个基于 Android Jetpack Compose 开发的英语词汇学习应用-听写助手，支持词库管理、听写练习、错题复习等功能。

## 📱 功能特性

### 📚 词库管理
- 支持多个词库、单元的层级管理
- 单词包含英文、音标、词性、中文释义、例句
- 支持单词导入导出（CSV格式）
- 单词掌握程度追踪（未听写、未通过、已通过）

### ✍️ 听写练习
- **全部听写**：听写整个单元的所有单词
- **部分听写**：选择单元中的部分单词进行听写
- 自定义英文键盘
- 实时拼写检查和结果反馈
- 听写结果统计和错题记录

### 🎯 消灭错题（复习计划）
- 自动收集听写错误的单词
- 设置每次消灭的错题数量
- 随机抽取错题进行复习
- 支持卡片模式和拼写模式
- 复习结果统计和状态更新

### ⚙️ 设置功能
- 自动播放发音设置
- 其他个性化配置

## 🏗️ 技术架构

### 项目结构
```
vocabulary/
├── app/                    # 主应用模块
├── core/                   # 核心模块
│   ├── core-common/       # 通用工具类
│   ├── core-database/     # 数据库（Room）
│   ├── core-model/        # 数据模型
│   ├── core-network/      # 网络请求
│   └── core-tts/          # 文字转语音
├── feature/               # 功能模块
│   ├── feature-dictation/ # 听写练习
│   ├── feature-review/    # 错题复习
│   ├── feature-settings/  # 设置
│   └── feature-vocabulary/# 词库管理
└── gradle/                # Gradle配置
```

### 技术栈
- **UI框架**：Jetpack Compose + Material 3
- **架构模式**：MVVM + Clean Architecture
- **依赖注入**：Hilt
- **数据库**：Room
- **异步处理**：Kotlin Coroutines + Flow
- **导航**：Navigation Compose
- **文字转语音**：Android TTS API

## 🚀 快速开始

### 📥 直接下载

**Android APK 下载：**
👉 [点击下载](https://gitee.com/qdd888/vocabulary/tags)

**安装说明：**
1. 点击上方链接下载文件
2. 在 Android 手机上打开下载的 .apk 文件
3. 按照提示完成安装（需要开启"允许安装未知来源应用"）

**版本信息：**
- 版本号：1.0.1
- 最低支持：Android 8.0 (API 26)
- 目标版本：Android 14 (API 34)

### 开发环境要求
- Android Studio Hedgehog | 2023.1.1 或更高版本
- JDK 17
- Android SDK 34
- 最低支持 Android 8.0 (API 26)

### 构建步骤
1. 克隆项目
```bash
git clone https://gitee.com/qdd888/vocabulary.git
```

2. 使用 Android Studio 打开项目

3. 同步 Gradle 依赖

4. 运行应用到模拟器或真机

### 配置说明
- `local.properties`：包含本地配置（已加入.gitignore）
- 应用需要录音和网络权限用于TTS功能

## 📖 使用指南

### 添加词库
考虑到目前不同省份的学生，使用的英文教材版本各不相同，没有设置固定的词库，需要用户自己去处理题库
1. 打开英文课本最后的单词表，按照每页顺序进行拍照
2. 打开豆包、deepseek等AI软件
3. 将照片都发给它们，同时用以下模版：
```
这些都是英语书本里的单词表，需要你按照单元顺序组装单词，形成csv题库。题库表头为“Unit,Word,Phonetic,Part of Speech,Chinese”
内容例如：Unit 1,musician,/mjuˈzɪʃn/,n.,音乐家；作曲家”
```
4. 下载到CSV文件后，按照英语课本改名称，例如：“六年级上.csv”
5. 打开APP 》单词库 》导入CSV题库，选择刚下载的CSV文件，即可完成题库的导入。

PS: 如果实在不会做题库，可以将所有图片按照顺序发送邮件给我，我来给你做题库。

### 开始听写
1. 选择词库和单元
2. 点击"全部听写"或"部分听写"
3. 听取发音并输入英文单词
4. 查看听写结果和统计

### 消灭错题
1. 进入"错题库"页面
2. 查看错题总数
3. 设置本次消灭数量
4. 开始听写错题

## 🛠️ 开发指南

### 代码规范
- 遵循 Kotlin 编码规范
- 使用 Compose 最佳实践
- 模块化架构，职责分离

### 构建变体
- `debug`：调试版本，包含日志
- `release`：发布版本，代码混淆

### 测试
- 单元测试：使用 JUnit + Mockito
- UI测试：使用 Compose Testing

## 📄 许可证

本项目仅供学习和个人使用。

## 👨‍💻 作者

**齐大春**
- Email: qichun888@aliyun.com

---

**注意**：本应用的词库数据存储在本地数据库中，请定期备份重要数据。