基于 Rust + Tauri 2.0 + Svelte 5 + Vite 的桌面电子书阅读器 拖入即读 · 11 种格式 · 全键盘操作 · 可选中复制 · 整行分页不截断 · 目录 / 页码跳转 · 断点续读 · 翻页零动画、极速响应
「极速看书」是一款专注「快速打开本地电子书、安静读书」的桌面应用。把一本电子书拖进窗口(或点引导页的大号「+」按钮),程序会在 Rust 侧把它解析成统一的段落结构,再交给前端排版引擎按当前字号 / 行距 / 窗口尺寸即时重排分页;左右方向键连按翻页时完全没有加载感,字体缩放与行距调整即时生效且阅读位置不丢。退出时自动记住每本书的阅读位置与全部界面配置,下次启动直接从上次退出的页数继续读;按 X 关闭当前书则一键清除该书的位置记忆,回到引导页。
技术栈:
| 层 | 技术 |
|---|---|
| 后端 | Rust 1.77+,Tauri 2,zip(EPUB 容器),scraper/html5ever(HTML 正文抽取),roxmltree(OPF / FB2 XML),encoding_rs + chardetng(编码检测),tauri-plugin-dialog(系统文件选择) |
| 前端 | Svelte 5(runes),Vite 6,pdf.js 5(懒加载,仅 PDF 书打开时才下载执行) |
| 通信 | Tauri IPC 命令(解析在阻塞线程池执行,不卡 UI) |
本仓库已在 Debian 13 + Rust 1.98 + Node 24 环境完整验证:cargo test -p kanshu-core 45/45 通过(38 项单元测试 + 7 项真实样例集成测试,两个 MOBI 样例另经 python-mobi / KindleUnpack 交叉验证);cargo check 全量类型检查通过;npm run build 前端构建零警告;翻页 / 缩放 / 行距 / 配置面板 / 断点续读 / 鼠标点击翻页 / 拖选文字等核心交互在无头浏览器中逐项实测通过,I / G / L 三个新交互与「首末行永不截断」的分页不变量也有 42 项 Playwright 端到端断言覆盖(scripts/test_browser*.py,截图见 screenshots/)。
- 拖拽即读:把电子书文件拖到窗口任意位置即可打开;点选与拖拽完全等效
- 点选即开:引导页大号「+」按钮弹出系统文件选择对话框(无需鼠标拖拽也能用)
- 一键关书:
X键关闭当前书回到引导页,同时清空该书的位置记忆(下次启动不再自动恢复) - 11 种格式:TXT / EPUB / MOBI / AZW / AZW3 / PRC / PDB / PDF / FB2 / HTML / XHTML,全部在 Rust 侧解析成统一段落结构(PDF 例外,见下文双模式)
- TXT 编码免疫:UTF-8 / UTF-16(BOM)/ GBK / GB18030 / Big5 / Shift_JIS 自动检测,打开老书不乱码
- 智能换行(可选,默认关):双回车分段、段内硬回车忽略(详见下文),窄栏排版的老 TXT 一键变书籍排版
- 整行分页:正文交给 CSS 多列引擎分页(一列一页),行框永不跨页;每页首行之上、末行之下各留一个行间距,第一行与最后一行永远不被垂直截断
- 极速翻页:全书段落一次性交给浏览器排版引擎,翻页只是
scrollLeft跳一格——零动画、零重排、纯瞬时 - 可选中复制:正文就是真实 DOM 文本,按住左键拖动选词选段,
Ctrl+C直接复制(PDF 原版渲染模式经文字层同样可选可复制) - 字号 / 行距即时调:
+-调字号(872px),3.0 行高,步进 0.1),滚轮等效;调整后按「锚点字符」回位,读书位置不丢,.调行距(0 - 信息栏(
I键,默认隐藏):顶部显示书名 · 页码 · 进度 · 格式;显示时正文自动下移,首行与信息栏之间留一个行间距 - 页码跳转(
G键):底部浮层显示当前页,滑杆拖动直达任意页 - 目录面板(
L键):原书能识别出目录时(EPUB NCX / EPUB3 nav / PDF 书签 / FB2 节标题 / HTML 与 MOBI 章节标题),左侧浮层列出目录,点击跳转后自动关闭 - 配置面板:
S键呼出右侧面板,背景色 / 字体 / 字号 / 字色 / 行距 / 智能换行 / 段落排版 / PDF 模式 / 信息栏全部立即生效,一键恢复默认 - PDF 双模式:默认「原版渲染」(pdf.js 按原版面渲染,图表图片全保留,文字层可选中复制),可切换「文字重排」(与其它格式同一引擎,字号 / 行距 / 背景全部生效)
- 断点续读:每本书记住「视口顶部字符偏移 + 页码」,跨字号 / 行距 / 窗口尺寸稳定;下次启动自动打开上次的书并跳到退出位置
- 窗口记忆:位置 / 尺寸 / 最大化状态随状态文件持久化
- 全屏 / 最小化:方向键一键切换
| 类别 | 扩展名 | 处理方式 |
|---|---|---|
| 纯文本 | txt |
编码自动检测(BOM → 严格 UTF-8 → chardetng 统计检测)+ 可选智能换行 |
| EPUB | epub |
zip 容器 → container.xml → OPF(manifest + spine)→ XHTML 正文抽取;标题 / 作者取自 Dublin Core |
| MOBI 系 | mobi azw prc pdb |
PDB 容器 + MOBI 头 + PALMDOC / HUFF-CDIC 解压 + 尾部条目裁剪;书名 / 作者取自 EXTH |
| KF8 | azw3 |
MOBI 8 版头 + 尾部字节标志裁剪 + 拼接为 XHTML;组合文件(MOBI6+KF8 合体)自动跳 KF8 部分 |
pdf |
前端 pdf.js:文字重排(getTextContent + 段落启发式恢复)或原版渲染(canvas + 文字层) | |
| FB2 | fb2 |
XML 文档树遍历(title-info 元数据 + body 段落 / 诗行 / 空行) |
| HTML | html htm xhtml |
html5ever 解析 + 块级元素断段(与 EPUB / MOBI 共用抽取器) |
说明:受 DRM 保护(
encryption != 0)的 MOBI / AZW / AZW3 会直接报错拒绝解析;Kindle 新版 KFX 格式暂不支持。PDF 文字重排的段落结构为启发式恢复(行距 + 句读判定),复杂版面建议切换原版渲染。
| 按键 | 功能 |
|---|---|
→ 右方向键 |
下一页 |
← 左方向键 |
上一页 |
↑ 上方向键 |
全屏显示 / 恢复窗口 |
↓ 下方向键 |
最小化窗口 |
空格 |
下一页 |
回车 |
下一页 |
PageDown |
下一页 |
PageUp |
上一页 |
Home |
第一页 |
End |
最后一页 |
Esc |
退出程序(帮助层 / 配置面板打开时先关闭) |
+ 或 = |
放大字体(PDF 原版模式下为放大页面) |
- 或 _ |
缩小字体(PDF 原版模式下为缩小页面) |
,(含中文逗号 ,) |
行间距 -0.1 行高(最小 0) |
.(含中文句号 。) |
行间距 +0.1 行高(最大 3.0) |
I |
显示 / 隐藏顶部信息栏(默认隐藏) |
G |
底部页码跳转面板(滑杆直达指定页) |
L |
左侧目录面板(原书含目录时可用,点击跳转后自动关闭) |
S |
显示 / 隐藏配置面板 |
X |
关闭当前书,回到引导页(同时清除该书位置记忆) |
F1 |
显示 / 隐藏快捷键帮助 |
| 操作 | 功能 |
|---|---|
| 引导页「+」大按钮 | 点击弹出文件选择对话框(与拖拽等效) |
| 点击页面左半边 | 上一页 |
| 点击页面右半边 | 下一页 |
| 滚轮向上 | 放大字体(PDF 原版模式下为放大页面) |
| 滚轮向下 | 缩小字体 |
| 按住左键拖动 | 选择文字(松开后 Ctrl+C 复制;不触发翻页) |
| 双击 / 三击 | 选词 / 选段(不触发翻页) |
| 拖入电子书文件 | 打开 / 切换电子书 |
| 配置面板内滚轮 | 滚动面板内容(不触发缩放) |
点击翻页延迟 160ms 生效:这是刻意设计——期间出现的双击选词、拖动选区会取消翻页,做到「点击极速翻页」与「拖选不误翻」两全。
大量老式 TXT 小说按窄栏硬回车排版(每行 30~40 字 + 手工换行),直接阅读会在半句话处断行。开启智能换行(默认关闭,配置面板可开)后:
- 双回车(连续 1 个及以上空行)是段落分隔标识;
- 段内的单个硬回车视为排版残留,拼接时忽略:中文两侧直接相连,英文单词边界补一个空格;
- 关闭智能换行则「原样换行」:每一行就是一个段落,空行保留为空段。
原始(硬回车版) 智能换行后
───────────────────── ─────────────────────
山不在高, 山不在高,有仙则名。
有仙则名。 →
(双回车 → 分段)
水不在深, 水不在深,有龙则灵。
有龙则灵。
切换开关会按「当前段落」保位重新解析当前书,阅读位置基本不丢。
右侧深色面板,所有参数修改立即生效并防抖持久化:
| 配置项 | 默认值 | 范围 / 说明 |
|---|---|---|
| 背景颜色 | 亮灰 #DCDCDC |
任意 #RRGGBB,或用拾色器 |
| 字体 | 微软雅黑 | 可自由输入;附 PingFang / Noto / 思源 / 文泉驿等跨平台回退链 |
| 字号 | 20 px | 8 ~ 72 px,步进 1 |
| 字体颜色 | 黑 #000000 |
任意 #RRGGBB |
| 行间距 | 0.4 行高 | 0 ~ 3.0 行高,步进 0.1(, . 键等效);同时决定每页首尾的留白 |
| 智能换行 | 关 | 仅 TXT;改动后自动按段落保位重排当前书 |
| 段落排版 | 首行缩进 | 「首行缩进 2 字」(书籍风)/「段间空行」(网页风) |
| PDF 模式 | 原版渲染 | 「原版渲染」/「文字重排」,改动后自动重开当前 PDF |
| 信息栏 | 隐藏 | 顶部显示书名 · 页码 · 进度 · 格式(快捷键 I 等效) |
「恢复默认」按钮一键回到上表默认值(当前书阅读位置保留)。
| 模式 | 原理 | 适用 |
|---|---|---|
| 原版渲染(默认) | pdf.js 按原版面渲染 canvas + TextLayer 文字层(透明文字可选中复制) | 图表 / 扫描版 / 复杂版面;要求 100% 还原时 |
| 文字重排 | pdf.js getTextContent 抽取文字 → 行距 + 句读启发式恢复段落 → 与 TXT 同一引擎重排 |
纯文字 PDF;想让字号 / 行距 / 背景色全部生效时 |
+ - 与滚轮在两种模式下分别是「调字号」与「页面缩放」;Home / End / 方向键 / 空格 / 回车 / PageUp / PageDown 行为一致(按 PDF 页翻页)。两种模式各自的进度(字符偏移 / 页码)独立记忆;G 跳页面板与 L 书签目录(outline)在两种模式下均可用(文字重排的目录目标会换算为段落位置)。
原书格式里能识别出目录(TOC)时,L 键在窗口左侧浮出目录面板,点击条目跳转后自动关闭;没有目录的书按 L 会提示「没有识别到目录」。各格式的目录来源:
| 格式 | 目录来源 | 说明 |
|---|---|---|
| EPUB 2 | toc.ncx(navMap) |
支持 #fragment 锚点精确定位到段 |
| EPUB 3 | nav 文档(manifest properties 含 nav) |
按 ol 嵌套深度分级 |
| 书签 outline | 两种模式均可用 | |
| FB2 | <section><title> 节标题 |
按 section 嵌套深度分级 |
| MOBI / AZW3 / HTML | 正文 h1~h6 标题 |
标题即正文段落,天然可跳转 |
| TXT / PalmDOC | —(无目录结构) | 按 L 仅提示 |
程序在每次翻页 / 改配置后(防抖 200ms)自动保存状态,窗口关闭时兜底再保存一次。状态文件:
| 系统 | 路径 |
|---|---|
| Windows | %APPDATA%\jisu-kanshu\state.json |
| macOS | ~/Library/Application Support/jisu-kanshu/state.json |
| Linux | ~/.config/jisu-kanshu/state.json |
删除该文件即可「忘记」全部位置与配置。下次启动时若上次的书已不存在,会回到引导页。
按 X 关闭当前书:清除该书的位置记忆并回到引导页(界面配置与其它书的进度保留),与删除该书的进度条目等效。之后拖入或点「+」选择新书即可。
状态内容:当前书路径、每本书的进度(页码 + 视口顶部字符偏移 + PDF 原版页码)、全部配置项(背景 / 字体 / 字号 / 字色 / 行距 / 智能换行 / 排版 / PDF 模式 / 信息栏)、窗口几何(位置 / 尺寸 / 最大化)。旧版本状态文件可无损升级读取,缺失字段自动取默认值。
位置记忆用「视口顶部字符偏移」而不是页码:字号、行距、窗口尺寸怎么变,恢复的永远是退出的那一行字。
| 项 | 要求 |
|---|---|
| Rust | ≥ 1.77.2(安装:https://rustup.rs) |
| Node.js | ≥ 18(推荐 20+) |
| npm | ≥ 9 |
Linux 额外系统依赖(Debian/Ubuntu):
sudo apt-get install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-devWindows:需 WebView2(Win10/11 一般自带)+ MSVC Build Tools(通过 "Desktop development with C++")。
macOS:需 Xcode Command Line Tools(xcode-select --install)。
# 1. 安装依赖
npm install
# 2. 开发模式(热重载)
npm run tauri dev
# 3. 打包发布版(安装包 + 可执行文件)
npm run tauri build打包产物位置:src-tauri/target/release/bundle/(Windows 为 nsis/ 下的安装包与 msi/;macOS 为 dmg/;Linux 为 deb/ rpm/ appimage/)。
浏览器预览模式(可选,无 Rust 环境也能跑前端):npm run dev 后用浏览器打开 http://localhost:5173 —— 桥接层检测到非 Tauri 环境会自动启用 Mock:状态走 localStorage;public/samples/ 里的 TXT / HTML / PDF 走真实文件解析,EPUB / MOBI / AZW3 / FB2 的容器解析在 Rust 侧,预览用内置示例内容代替。适合 UI 调试与自动化测试,正式阅读请用 Tauri 桌面程序。配套的 Playwright 端到端脚本可在预览模式下直接跑:
npm run dev & # 先起 dev server
python scripts/test_browser.py # 分页 / 截断 / I・G・L / 默认值(25 项)
python scripts/test_browser2.py # 字号 / 行距 / 窗口变化稳定性(9 项)
python scripts/test_browser3.py # PDF 目录双模式(8 项)示例电子书:public/samples/ 提供 7 个小体积样例(GBK 编码硬回车 TXT、EPUB、双格式 MOBI、含图形页的 PDF、FB2、HTML),配套 scripts/make_samples.py 可重新生成;src-tauri/core/tests/samples.rs 会直接解析这批真实文件做集成测试。
后端单独验证:
# 核心解析库的 41 项测试(纯逻辑,不需要任何系统 GUI 依赖)
cargo test -p kanshu-core --manifest-path src-tauri/Cargo.toml
# 全量类型检查(需要上面的 Linux 系统依赖)
cargo check --manifest-path src-tauri/Cargo.tomljisu-kanshu/
├── index.html # Vite 入口 HTML(内联黑底防白闪)
├── package.json # 前端依赖与脚本(npm run tauri dev/build)
├── vite.config.js # Vite 配置(pdf.js worker 以 ES 模块单独打包)
├── svelte.config.js
├── public/samples/ # 7 个示例电子书(也可用 scripts/make_samples.py 重新生成)
├── screenshots/ # 运行截图(README 用)
├── scripts/
│ ├── make_icons.py # 应用图标生成(Pillow 绘制 + 手工拼装 ICNS)
│ ├── make_samples.py # 示例电子书生成(txt/epub/pdf/mobi/fb2/html;PDF 含书签目录)
│ ├── test_browser.py # 浏览器端到端验证(分页 / 截断 / I・G・L / 默认值)
│ ├── test_browser2.py # 补充验证(字号 / 行距 / 窗口变化后的稳定性)
│ └── test_browser3.py # PDF 目录验证(原版渲染与文字重排双模式)
├── src/
│ ├── main.js # Svelte 5 mount 入口
│ ├── app.css # 全局样式(黑底、toast、信息栏高度变量)
│ ├── App.svelte # 主组件:读书核心逻辑(打开/翻页/字号行距/面板/持久化/事件/目录接线)
│ ├── lib/
│ │ ├── bridge.js # Tauri API 桥接 + 浏览器预览 Mock(invoke/对话框/拖拽/窗口控制)
│ │ ├── reader.js # 文字阅读引擎:CSS 多列分页 + caretRangeFromPoint 位置记忆 + 重排回锚
│ │ ├── pdfjs.js # pdf.js 懒加载封装 + PDF 文字抽取(段落启发式 + 页码映射)+ outline
│ │ └── format.js # 展示格式化工具(字体回退链 / 颜色校验 / 建议字体表)
│ └── components/
│ ├── HintScreen.svelte # 引导屏(拖拽提示 / 大号+按钮 / 解析中 / 错误)
│ ├── InfoBar.svelte # 顶部信息栏(书名 · 页码 · 进度 · 格式 · 排版参数;I 键开关)
│ ├── SettingsPanel.svelte# S 键配置面板(全部参数立即生效)
│ ├── PdfView.svelte # PDF 原版渲染(canvas + TextLayer 文字层 + outline + 尺寸自适应)
│ ├── PageJumper.svelte # G 键底部页码跳转面板(滑杆直达)
│ ├── TocOverlay.svelte # L 键左侧目录面板(点击跳转后自动关闭)
│ └── HelpOverlay.svelte # F1 帮助层
└── src-tauri/
├── Cargo.toml # 工作区根 = Tauri 应用 crate(tauri 2 / dialog / serde / dirs)
├── build.rs
├── tauri.conf.json # 窗口 / asset 协议 / 打包配置
├── capabilities/default.json # Tauri 2 权限(全屏/最小化/关闭/标题/几何记忆/文件对话框)
├── icons/ # 全套图标(png/ico/icns,scripts/make_icons.py 生成)
├── src/
│ ├── main.rs # 程序入口
│ ├── lib.rs # Tauri Builder 装配(命令注册 / 关闭兜底落盘)
│ ├── state.rs # 状态持久化(配置 + 各书进度 + 窗口几何,含单元测试)
│ └── commands.rs # Tauri IPC 命令定义
└── core/ # 核心解析库(纯逻辑子 crate,无 GUI 依赖,可独立测试)
├── Cargo.toml # zip / scraper / roxmltree / encoding_rs / chardetng
├── src/
│ ├── lib.rs # crate 出口
│ ├── book.rs # 格式识别与统一入口(含单元测试)
│ ├── txt.rs # 编码检测 + 智能换行(含单元测试)
│ ├── html.rs # HTML→段落抽取(EPUB/MOBI/单文件共用,含单元测试)
│ ├── epub.rs # EPUB 解析(含单元测试)
│ ├── mobi.rs # MOBI/AZW/AZW3/PRC 解析(PALMDOC/HUFF 移植,含单元测试)
│ └── fb2.rs # FB2 解析(含单元测试)
└── tests/samples.rs # 真实样例集成测试(public/samples/*.mobi|epub|txt|fb2|html)
- 零动画直翻:翻页只是把
scrollLeft设为视口宽度的整数倍,没有过渡、没有重排——全书段落在打开时已一次性排好 - 浏览器排版引擎即分页引擎:分页交给 CSS 多列(一列一页),由真实渲染高度决定,与显示零偏差;行框永不跨列,配合页首 / 页尾各一个行间距的内边距,首末行永不截断;不维护第二套排版代码,也就没有两套结果不一致的 bug
- 解析放阻塞线程池:读盘与格式解析在 Rust 侧
spawn_blocking执行,UI 全程不卡 - 位置记忆用字符偏移:
caretRangeFromPoint取当前页首行字符存偏移,恢复时用Range.getClientRects行框横坐标换算回所在列(页)——字号 / 行距 / 窗口怎么变,恢复的永远是同一行字 - 锚点回位:字号 / 行距 / 排版变化前记录锚点字符,变化后按锚点回位;连续快速调整(滚轮连滚)防抖合并,一次重排到位
- 列几何精确整像素:列宽 / 列距 / 容器尺寸按视口整数像素设置,页面步长恰等于
clientWidth,小数像素不累积漂移;尾部垫片把滚动区域补齐到「页数 × 视口宽」,末页永不因scrollLeft上限被截断 - pdf.js 懒加载:PDF 库(约 1.2MB worker + 0.4MB 主模块)只在打开 PDF 书时才动态加载,纯文字书全程不碰
- 配置防抖落盘:翻页 / 改配置后 200ms 防抖写状态文件,高频翻页不会打爆磁盘;窗口关闭时兜底再写一次
Q:MOBI / AZW3 支持到什么程度? 自研解析器覆盖:PALMDOC 与 HUFF/CDIC 两种压缩(算法移植自 KindleUnpack)、MOBI6 与 KF8 两代格式、EXTH 元数据、尾部条目裁剪、MOBI6+KF8 组合文件自动跳 KF8 部分。受 DRM 保护的书会明确报错拒绝;KFX(Kindle 新格式)暂不支持。
Q:打开 TXT 是乱码? 极少发生——BOM、严格 UTF-8、chardetng 统计检测三道关。若真遇到,多半是极罕见的编码,用编辑器转存 UTF-8 即可。信息栏会显示实际识别的编码名。
Q:为什么点击翻页有一点点延迟? 160ms,刻意为之:给双击选词 / 拖选留出取消窗口。键盘翻页(方向键 / 空格 / 回车 / PageUp / PageDown)零延迟。
Q:PDF 文字重排后段落断得不对? 段落是按行距 + 句读启发式恢复的,多栏 / 表格 / 扫描件会失真。这类书请切到「原版渲染」模式(S 面板一键切换),版式与图表完整保留,且文字仍可选中复制。
Q:改字号后位置会丢吗? 不会。位置以「视口顶部字符偏移」记忆并按锚点回位,连续缩放也不累计漂移;页码显示可能 ±1,那只是同一行字落在了页面网格的不同位置。
Q:智能换行为什么有的行还是断开? 智能换行只忽略「段内单个硬回车」、按空行分段。如果原书用空行硬分行(一行一段),那是原文结构,属于正常行为。
Q:浏览器预览模式和桌面版有什么差别? UI 与交互完全一致;差别只在解析层——EPUB / MOBI / AZW3 / FB2 的容器解析在 Rust 侧,浏览器预览用内置示例内容代替,TXT / HTML / PDF 则是真实解析。状态存 localStorage 而非系统配置目录。
Q:怎么「忘记」所有进度和配置?
删除状态文件(见「状态记忆」一节的路径表),或在书内按 X 只清当前书。
本项目代码供学习与自由使用。MOBI 解析算法移植自 KindleUnpack(mobiunpack)的公开实现,格式知识参考了 foliate-js 与 python-mobi。