epub-read/README.md

ePub Reader

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

截图

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

功能

• 打开 .epub 文件（原生文件对话框）
• Kindle 风格阅读界面（顶部工具栏 + 中央正文 + 底部进度条）
• 点击左右区域翻页（左 30% 上一页、右 30% 下一页）
• 键盘 ← → 翻页
• 目录侧栏（可展开/收起）
• 字体大小调节（A⁺ / A⁻）
• 日间/夜间模式切换
• 底部进度条可拖动跳转
• 自动保存阅读位置
• 最近文件列表
• 设置持久化（settings.json）

系统要求

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

下载

从 Releases 下载最新版本 epub-read.exe，直接运行。

构建

环境要求

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

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

静态链接说明

已配置 .cargo/config.toml 启用 +crt-static，编译出的 exe 不依赖 MinGW 运行时 DLL。 内嵌 Noto Sans SC 中文字体（约 17MB），确保中文正常显示。

技术栈

层	选型
GUI	egui / eframe
ePub 解析	epub
文件对话框	rfd
序列化	serde / serde_json
中文字体	Noto Sans SC

开发

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

许可

MIT