T-Reader 是一个面向 Windows 桌面端的轻量阅读器项目。项目以轻小说阅读体验为核心，提供书架管理、独立阅读窗口、书签与笔记、WebDAV 云同步、自动更新能力。
- 支持
EPUB/TXT导入、书架展示与打开阅读 - 书架支持列表 / 网格双视图，并展示封面、格式、最近阅读与进度
- 独立阅读器窗口支持目录、翻页、滚动、快捷键与沉浸式阅读
- 支持 EPUB 书签、高亮和个人笔记，笔记页可统一浏览与跳转
- 阅读界面清爽简洁，书籍字体可选择Windows系统内置字体
- 阅读样式支持字号、字重、行距、段距、页边距、栏数、翻页模式调节
- 支持 WebDAV 云同步，目前已适配第三方开源移动端阅读器Legado
- 支持应用内检查更新、下载更新
- 前端：
Vue 3+TypeScript+Vite 5 - 桌面容器：
Tauri 2 - 后端：
Rust - 状态管理：
Pinia - UI：
Element Plus - 阅读引擎：二次开发的
libs/epub.js
T-Reader/
├─ src/ # Vue 前端
│ ├─ views/ # App 主窗口路由视图组件
│ ├─ components/ # 可复用组件、阅读器组件与弹窗
│ ├─ types/ # 共享类型定义
│ ├─ utils/ # 通用工具
│ ├─ services/ # book / reader / fileSystem / notification
│ ├─ store/ # Pinia 状态
│ └─ router/ # 主窗口路由
├─ src-tauri/ # Rust 后端与 Tauri 配置
├─ docs/ # 项目概览与规范文档
├─ libs/epub.js/ # epub.js 子模块
└─ scripts/ # 版本与发布脚本
本地根目录位于 Document/T-Reader/：
T-Reader/
├─ books/ # 原始书籍文件（epub / txt）
├─ bookProgress/ # 书籍进度配置
├─ cached/ # 封面、locations、段落统计缓存，以及生产日志 t-reader.log
└─ system/ # setting.json / ReaderConfig.json / BookMarks.json
云端 WebDAV 目录：
T-Reader/
├─ books/
└─ bookProgress/
说明：
- 开发态日志仅打印到
npm run tauri dev的终端，不写入 DevTools 或本地日志文件 - 打包后的日志写入
Document/T-Reader/cached/t-reader.log cached/与system/BookMarks.json当前不参与 WebDAV 同步- 云端与本地进度冲突时，优先使用
durChapterTime更新较新的配置
Rust 1.89.0- 主项目建议使用最新稳定版
Node.js v24 libs/epub.js建议使用Node.js v16.20.2
开始前请先确认本机已满足 Tauri 官方前置环境要求：
- 克隆仓库并初始化子模块：
git clone <repo-url>
cd T-Reader
git submodule update --init --recursive- 安装
libs/epub.js依赖：
cd libs/epub.js
npm install
cd ../..- 安装主项目依赖：
npm install- 启动桌面开发环境：
npm run tauri devnpm run dev
npm run build
npm run preview
npm run tauri dev
npm run tauri build
node scripts/bump-version.js --tag v1.7.0
node scripts/bump-version.js --tag v1.7.0 --branch develop