epub-read/README.md

# ePub Reader

基于 Rust + egui 的 Windows ePub 阅读器，单 exe 文件，无需额外依赖。

## 截图

![主界面](main.png)

启动页 → 选择 ePub 文件 → Kindle 风格阅读界面。

## 功能

- 📂 打开 .epub 文件（原生文件对话框）
- 📖 Kindle 风格阅读界面（顶部工具栏 + 中央正文 + 底部进度条）
- 🖱️ 点击左右区域翻页（左 30% 上一页、右 30% 下一页）
- ⌨️ 键盘 ← → 翻页
- 📋 目录侧栏（可展开/收起）
- 🔖 书签功能
- 🔍 字体大小调节（A⁺ / A⁻）
- 🌓 日间/夜间/棕褐色模式切换
- 🎨 多种背景纹理（牛皮纸/稿纸/作文纸/自定义图片）
- 📏 响应式分页引擎（基于 egui Galley 精确测量）
- 🔤 字体切换（内置三款中文字体：思源黑体 / 霞鹜文楷 / 思源宋体）
- 🔗 内容锚点定位（字体/窗口大小变化后自动恢复阅读位置）
- 📊 底部进度条可拖动跳转
- 💾 自动保存阅读位置
- 📅 最近文件列表
- ⚙️ 设置持久化（settings.json）

## 项目结构

```
epub-read/
├── src/
│   ├── main.rs          # 程序入口
│   ├── app.rs           # App 状态管理 + 事件循环
│   ├── book.rs          # ePub 解析 + 章节数据结构
│   ├── reader.rs        # 响应式分页引擎 + 阅读视图渲染
│   ├── theme.rs         # 主题/配色/设置/书签/阅读位置
│   ├── style.rs         # 排版样式配置（对齐/行高/缩进）
│   ├── texture.rs       # 背景纹理生成
│   ├── font.rs          # 字体注册/加载/切换
│   └── persistence.rs   # 配置文件读写
├── fonts/
│   ├── NotoSansSC-Regular.ttf         # 思源黑体（内嵌）
│   ├── LXGWWenKai-Regular.ttf         # 霞鹜文楷（运行时加载）
│   └── SourceHanSerifSC-Regular.otf   # 思源宋体（运行时加载）
├── Cargo.toml
└── .cargo/config.toml   # 静态链接配置
```

## 系统要求

- Windows 7+
- 无需安装任何运行时

## 下载

从 [Releases](https://github.com/xiaji/epub-read/releases) 下载最新版本 `epub-read.exe`，直接运行。

## 构建

### 环境要求

- MSYS2 + MinGW64
- Rust 工具链 `x86_64-pc-windows-gnu`

```bash
# 在 MINGW64 终端中
cargo build --release
# 输出: target/release/epub-read.exe
```

### 静态链接说明

已配置 `.cargo/config.toml` 启用 `+crt-static`，编译出的 exe 不依赖 MinGW 运行时 DLL。
内嵌 Noto Sans SC 中文字体（思源黑体），额外两款字体（霞鹜文楷、思源宋体）放在 exe 同级 `fonts/` 目录运行时加载。

## 技术栈

| 层 | 选型 |
|---|---|
| GUI | [egui](https://github.com/emilk/egui) / [eframe](https://crates.io/crates/eframe) |
| ePub 解析 | [epub](https://crates.io/crates/epub) |
| 文件对话框 | [rfd](https://crates.io/crates/rfd) |
| 序列化 | [serde](https://crates.io/crates/serde) / [serde_json](https://crates.io/crates/serde_json) |
| 中文字体 | 思源黑体 / [霞鹜文楷](https://github.com/lxgw/LxgwWenkai-Lite) / [思源宋体](https://github.com/adobe-fonts/source-han-serif) |

## 开发

```bash
cargo test    # 运行测试（33 个）
cargo check   # 编译检查
cargo run     # 调试运行
```

## 许可

MIT