Skip to content

About

Vibe coding出的一个多平台小说阅读器,支持txt和PDF,支持Windows和Android平台。可记录阅读进度,自动识别章节生成目录,进行局域网同步。

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

VibeReader

声明:本项目是通过 AI Vibe Coding(TRAE + GLM)开发的。

跨平台本地小说阅读器,支持 Windows 与 Android。无需导入书库、无需账号,直接浏览文件夹打开 TXT/PDF 阅读;阅读进度、书签、标签全部本地持久化,并支持局域网多设备同步。

功能

阅读

  • TXT:直接浏览文件夹打开(不强制入库);中文小说章节自动识别(第X章/序章等常见格式)生成目录;后台 Isolate 分页缓存,左右翻页;进度条拖拽跳转

  • PDF:基于 pdfrx 渲染,翻页/跳页/页码续读

  • 自动翻页:TXT/PDF 均支持,点击按钮开启/停止,长按可选间隔(5–60 秒),读到书末自动停止

  • 阅读设置:字号、行距、页边距、主题(含夜间),即改即生效并持久化

  • 续读:TXT 记录章节+字符偏移,PDF 记录页码,重新打开自动定位

  • 书架:按最近阅读时间排序,最近读过的排在最前

书签与搜索

  • 书签记录精确位置(TXT:字符偏移+章节;PDF:页码)及文字摘录

  • 标签系统:书签可打多标签,书签中心支持跨书按标签筛选

  • 全书架全文搜索:首次打开自动建立 500 字分段索引,后台构建不卡 UI

局域网同步

两台设备(如 Windows + Android)连同一 WiFi 即可互相同步:

  • 同步范围:阅读进度、书签、标签、书文件本体(TXT/PDF)

  • 自动发现:UDP 广播探测 + TCP 子网扫描兜底;也可手动输入 IP 连接

  • 冲突解决:记录级时间戳 LWW(新者胜),删除通过墓碑传播

  • 图书身份:按文件内容 MD5 识别,同一本书在不同设备不同路径/文件名也能正确匹配

  • 传输可靠性:流式上传/下载带进度显示,落盘前 MD5 校验

数据存储

全部本地 SQLite,无任何云端依赖:

平台 数据库位置
Windows %APPDATA%\com.novel\com.novel.reader\novel_reader\db\
Android 应用私有目录

同步下载的书籍存放于「文档/sync_incoming」;自行打开的书保持原位置不动。

技术栈

  • Flutter(Dart 3.13+)

  • SQLite(sqlite3 + sqlite3_flutter_libs,直接 SQL 无 ORM)

  • pdfrx(PDF 渲染)

  • shelf + http(局域网同步的服务端/客户端)

项目结构

novel_reader/
├── lib/src/
│   ├── data/          # 数据层:SQLite 数据库、TXT 章节识别
│   ├── domain/        # 领域模型:Book、Bookmark、Progress、Settings
│   ├── presentation/  # UI:书架/文件/阅读/书签中心/搜索/同步页
│   ├── sync/          # 局域网同步:协议模型、合并器、服务端、客户端、UDP 发现
│   └── utils/         # 编码探测、内容哈希、格式工具
└── test/              # 单元测试(含同步合并收敛性、真实 HTTP 回环测试)

构建与运行

Windows

cd novel_reader
flutter pub get
flutter run -d windows          # 开发调试
flutter build windows --release # 发布构建

产物在 build/windows/x64/runner/Release/,双击 novel_reader.exe 即可运行(需与同目录 DLL 及 data 文件夹一起分发)。

Android

cd novel_reader
flutter run -d <device-id>
flutter build apk --release

需要 Android SDK;存储权限(Android 11+ 为「所有文件访问」)在首次进入文件视图时申请。

测试

cd novel_reader
flutter test

覆盖:章节识别、编码探测(GBK/UTF-16)、分页哈希、数据库迁移与同步方法、合并收敛性、真实 HTTP 回环同步。

说明

  • Android 端接收 UDP 广播需要 MulticastLock(已通过平台通道在开启同步服务时自动获取)

  • 部分路由器开启「AP 隔离」会阻断设备间通信,需在路由器设置中关闭

  • Android Release APK 使用正式签名(v1.1.0 起)。签名密钥与 key.properties 不入库,构建时放好 android/key.properties 即自动启用正式签名,缺失则回退 debug 签名

About

Vibe coding出的一个多平台小说阅读器,支持txt和PDF,支持Windows和Android平台。可记录阅读进度,自动识别章节生成目录,进行局域网同步。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages