电子书阅读器

一个支持 EPUB 和 MOBI 格式的本地电子书阅读器，基于 Python + PyQt6 开发。

项目状态

🚧 当前阶段：里程碑 0 - 准备期（已完成）

已完成的工作：

• ✅ 技术选型（Python + PyQt6）
• ✅ 项目目录结构搭建
• ✅ 数据模型与数据库设计
• ✅ 基础 GUI 框架
• ✅ 配置管理系统

下一步：里程碑 1 - MVP 开发

功能特性

计划功能

• 📚 文件导入：支持单本/批量导入，扫描指定文件夹
• 🗂️ 书库管理：书籍列表展示、搜索、排序、过滤
• 📖 阅读器：分页/滚动模式、字号/行距/边距/字体可调、夜间/护眼主题
• 📄 格式支持：EPUB 和 MOBI 格式解析
• 🔖 书签与笔记：添加书签、高亮文本、笔记管理
• ⚙️ 设置管理：阅读偏好设置、窗口状态保存
• 🔒 隐私安全：所有数据仅本地存储，不联网

技术栈

• 编程语言: Python 3.8+
• GUI 框架: PyQt6
• EPUB 解析: ebooklib
• MOBI 解析: mobi
• 数据库: SQLite3
• 图像处理: Pillow

项目结构

ebook-reader/
├── src/                    # 源代码目录
│   ├── main.py            # 主入口
│   ├── ui/                # UI 相关
│   │   ├── main_window.py # 主窗口
│   │   ├── library.py     # 书库界面
│   │   └── reader.py      # 阅读器界面
│   ├── models/            # 数据模型
│   │   ├── book.py        # 书籍模型
│   │   └── database.py    # 数据库操作
│   ├── parsers/           # 格式解析器
│   │   ├── epub_parser.py # EPUB 解析器
│   │   └── mobi_parser.py # MOBI 解析器
│   ├── utils/             # 工具函数
│   │   └── config.py      # 配置管理
│   └── resources/         # 资源文件
├── data/                  # 数据目录（本地存储）
├── cache/                 # 缓存目录
├── requirements.txt       # Python 依赖
├── requirements.md        # 需求文档
└── development-plan.md    # 开发计划

安装与运行

环境要求

• Python 3.8 或更高版本
• pip 包管理器

安装步骤

1. 克隆或下载项目

2. 安装依赖：

pip install -r requirements.txt

3. 运行程序：

cd src
python main.py

开发计划

里程碑 0：准备期 ✅

• 技术选型与工程骨架
• 数据结构设计
• 基础 GUI 框架

里程碑 1：MVP（第 3-6 周）

• 文件导入功能
• 书库管理完善
• EPUB 格式解析
• 阅读器核心功能
• 进度保存

里程碑 2：Beta（第 7-10 周）

• MOBI 格式解析
• 书签与笔记功能
• 主题支持
• 元数据编辑
• 性能优化

里程碑 3：v1.0（第 11-12 周）

• 稳定性增强
• 国际化支持
• 设置导入/导出
• 日志与错误反馈
• 跨平台打包

贡献指南

当前处于早期开发阶段，欢迎提出建议和反馈。

许可证

待定

联系方式

待定