# Reader

**Repository Path**: lcqbug1/reader

## Basic Information

- **Project Name**: Reader
- **Description**: 阅读者
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-01
- **Last Updated**: 2025-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📚 电子书阅读器

一个功能完整的Android电子书阅读器应用，支持多种格式的电子书阅读。

## ✨ 主要功能

- 📖 **多格式支持**: EPUB、PDF、TXT等主流电子书格式
- 📚 **书架管理**: 本地书籍导入、分类管理
- 🔖 **书签功能**: 添加、删除、跳转书签
- 📑 **目录导航**: 自动解析和显示书籍目录
- 📊 **阅读进度**: 自动保存和恢复阅读位置
- 🌙 **夜间模式**: 护眼阅读模式
- ⚙️ **阅读设置**: 自定义字体、字号、行距、背景色

## 🏗️ 技术架构

### 架构模式
- **MVVM + Repository**: 清晰的分层架构
- **Clean Architecture**: 业务逻辑与UI分离

### 核心技术栈
- **Kotlin**: 主要开发语言
- **Jetpack Compose**: 现代UI开发
- **Room**: 本地数据库存储
- **Hilt**: 依赖注入
- **Navigation**: 页面导航
- **ViewModel & LiveData**: 数据管理
- **Coroutines**: 异步处理

### 项目结构
```
app/src/main/java/com/lc/reader/
├── ui/                    # 界面层
│   ├── activity/         # Activity
│   ├── fragment/         # Fragment
│   ├── adapter/          # 适配器
│   └── viewmodel/        # ViewModel
├── data/                 # 数据层
│   ├── model/           # 数据模型
│   ├── repository/      # 数据仓库
│   └── database/        # 数据库
├── domain/              # 业务逻辑层
│   └── service/         # 服务
└── utils/               # 工具类
```

## 🚀 快速开始

### 环境要求
- Android Studio Hedgehog | 2023.1.1 或更高版本
- Android SDK 24+
- Kotlin 2.0.21+

### 安装步骤
1. 克隆项目到本地
2. 在Android Studio中打开项目
3. 同步Gradle依赖
4. 运行应用到设备或模拟器

### 使用说明
1. **导入书籍**: 点击右下角的"+"按钮选择电子书文件
2. **开始阅读**: 点击书架中的书籍进入阅读界面
3. **翻页操作**: 使用底部的"上一页"/"下一页"按钮
4. **书签管理**: 长按文本添加书签
5. **设置调整**: 在设置中自定义阅读偏好

## 📱 界面预览

### 书架界面
- 网格布局显示所有书籍
- 显示书籍封面、标题、作者、格式、阅读进度
- 支持收藏和删除操作

### 阅读界面
- 简洁的阅读体验
- 顶部显示书籍标题和阅读进度
- 底部提供翻页控制
- 支持文本选择和书签添加

## 🔧 开发计划

### 已完成功能
- [x] 基础项目架构搭建
- [x] 数据库设计和实现
- [x] 书架界面开发
- [x] 基础阅读功能
- [x] 书籍导入功能

### 待开发功能
- [ ] EPUB格式解析器
- [ ] PDF格式支持
- [ ] 书签管理界面
- [ ] 目录导航功能
- [ ] 阅读设置界面
- [ ] 夜间模式
- [ ] 字体和样式自定义
- [ ] 搜索功能
- [ ] 笔记功能
- [ ] 云同步

## 🤝 贡献指南

欢迎提交Issue和Pull Request来改进这个项目！

### 开发规范
- 遵循Kotlin编码规范
- 使用有意义的变量和函数名
- 添加必要的注释
- 编写单元测试

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 📞 联系方式

如有问题或建议，请通过以下方式联系：
- 提交Issue
- 发送邮件

---

**享受阅读的乐趣！** 📚✨