Skip to content

About

「极速看书」是一款专注「快速打开本地电子书、安静读书」的桌面应用。把一本电子书拖进窗口(或点引导页的大号「+」按钮),程序会在 Rust 侧把它解析成统一的段落结构,再交给前端排版引擎按当前字号 / 行距 / 窗口尺寸即时重排分页;左右方向键连按翻页时完全没有加载感,字体缩放与行距调整即时生效且阅读位置不丢。退出时自动记住每本书的阅读位置与全部界面配置,下次启动直接从上次退出的页数继续读;按 `X` 关闭当前书则一键清除该书的位置记忆,回到引导页。

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

极速看书(JisuKanshu)

基于 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),, . 调行距(03.0 行高,步进 0.1),滚轮等效;调整后按「锚点字符」回位,读书位置不丢
  • 信息栏(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 前端 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)

大量老式 TXT 小说按窄栏硬回车排版(每行 30~40 字 + 手工换行),直接阅读会在半句话处断行。开启智能换行(默认关闭,配置面板可开)后:

  • 双回车(连续 1 个及以上空行)是段落分隔标识;
  • 段内的单个硬回车视为排版残留,拼接时忽略:中文两侧直接相连,英文单词边界补一个空格;
  • 关闭智能换行则「原样换行」:每一行就是一个段落,空行保留为空段。
原始(硬回车版)            智能换行后
─────────────────────      ─────────────────────
山不在高,                  山不在高,有仙则名。
有仙则名。        →
                            (双回车 → 分段)
水不在深,                  水不在深,有龙则灵。
有龙则灵。

切换开关会按「当前段落」保位重新解析当前书,阅读位置基本不丢。


配置面板(S 键)

右侧深色面板,所有参数修改立即生效并防抖持久化:

配置项 默认值 范围 / 说明
背景颜色 亮灰 #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 双模式

模式 原理 适用
原版渲染(默认) pdf.js 按原版面渲染 canvas + TextLayer 文字层(透明文字可选中复制) 图表 / 扫描版 / 复杂版面;要求 100% 还原时
文字重排 pdf.js getTextContent 抽取文字 → 行距 + 句读启发式恢复段落 → 与 TXT 同一引擎重排 纯文字 PDF;想让字号 / 行距 / 背景色全部生效时

+ - 与滚轮在两种模式下分别是「调字号」与「页面缩放」;Home / End / 方向键 / 空格 / 回车 / PageUp / PageDown 行为一致(按 PDF 页翻页)。两种模式各自的进度(字符偏移 / 页码)独立记忆;G 跳页面板与 L 书签目录(outline)在两种模式下均可用(文字重排的目录目标会换算为段落位置)。


目录(L 键)

原书格式里能识别出目录(TOC)时,L 键在窗口左侧浮出目录面板,点击条目跳转后自动关闭;没有目录的书按 L 会提示「没有识别到目录」。各格式的目录来源:

格式 目录来源 说明
EPUB 2 toc.ncx(navMap) 支持 #fragment 锚点精确定位到段
EPUB 3 nav 文档(manifest properties 含 nav) 按 ol 嵌套深度分级
PDF 书签 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-dev

Windows:需 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.toml

项目结构

jisu-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)

性能设计要点(为什么快)

  1. 零动画直翻:翻页只是把 scrollLeft 设为视口宽度的整数倍,没有过渡、没有重排——全书段落在打开时已一次性排好
  2. 浏览器排版引擎即分页引擎:分页交给 CSS 多列(一列一页),由真实渲染高度决定,与显示零偏差;行框永不跨列,配合页首 / 页尾各一个行间距的内边距,首末行永不截断;不维护第二套排版代码,也就没有两套结果不一致的 bug
  3. 解析放阻塞线程池:读盘与格式解析在 Rust 侧 spawn_blocking 执行,UI 全程不卡
  4. 位置记忆用字符偏移:caretRangeFromPoint 取当前页首行字符存偏移,恢复时用 Range.getClientRects 行框横坐标换算回所在列(页)——字号 / 行距 / 窗口怎么变,恢复的永远是同一行字
  5. 锚点回位:字号 / 行距 / 排版变化前记录锚点字符,变化后按锚点回位;连续快速调整(滚轮连滚)防抖合并,一次重排到位
  6. 列几何精确整像素:列宽 / 列距 / 容器尺寸按视口整数像素设置,页面步长恰等于 clientWidth,小数像素不累积漂移;尾部垫片把滚动区域补齐到「页数 × 视口宽」,末页永不因 scrollLeft 上限被截断
  7. pdf.js 懒加载:PDF 库(约 1.2MB worker + 0.4MB 主模块)只在打开 PDF 书时才动态加载,纯文字书全程不碰
  8. 配置防抖落盘:翻页 / 改配置后 200ms 防抖写状态文件,高频翻页不会打爆磁盘;窗口关闭时兜底再写一次

常见问题(FAQ)

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。

About

「极速看书」是一款专注「快速打开本地电子书、安静读书」的桌面应用。把一本电子书拖进窗口(或点引导页的大号「+」按钮),程序会在 Rust 侧把它解析成统一的段落结构,再交给前端排版引擎按当前字号 / 行距 / 窗口尺寸即时重排分页;左右方向键连按翻页时完全没有加载感,字体缩放与行距调整即时生效且阅读位置不丢。退出时自动记住每本书的阅读位置与全部界面配置,下次启动直接从上次退出的页数继续读;按 `X` 关闭当前书则一键清除该书的位置记忆,回到引导页。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages