kuaibuflutter 用户手册
一、软件简介
kuaibuflutter是一款flutter开发的开源跨平台小说阅读器，已支持 Windows 和 Android 系统。提供以下核心功能：
- 📚 书架管理 - 管理您收藏的书籍
- 🔍 多源搜索 - 同时搜索多个书源
- 📖 在线阅读 - 流畅的阅读体验
- 💾 离线下载 - 下载章节离线阅读
- 🔊 朗读功能 - 语音朗读小说内容
- 📑 阅读进度 - 自动保存阅读位置
- 🎨 个性设置 - 自定义阅读界面
二、快速开始
2.1 安装
Windows:
Android:
2.2 添加书籍
-
点击「网上搜书」选项卡
-
在搜索框输入书名或作者
-
点击搜索按钮
-
在结果中选择想要的书籍
-
双击弹出目录信息后「加入书架」
2.3 开始阅读
-
点击「我的书架」选项卡
-
点击想要阅读的书籍
-
自动打开阅读界面
三、功能详解
3.1 我的书架
书架页面展示您收藏的所有书籍：
功能按钮:
- 🔍 搜索 - 在书架中搜索书籍
- 📊 排序 - 按添加时间/最近阅读排序
- 🗑️ 删除 - 长按书籍可删除
书籍信息:
3.2 网上搜书
搜索和发现新书的页面：
搜索功能:
- 输入书名或作者搜索
- 支持多书源同时搜索
- 显示搜索来源
分类浏览:
搜索结果:
3.3 阅读界面
基本操作
| 操作 |
说明 |
| 点击屏幕左侧 |
上一页 |
| 点击屏幕右侧 |
下一页 |
| 点击屏幕中间 |
显示/隐藏菜单 |
| 滑动屏幕 |
上下滚动 |
菜单功能
顶部菜单:
底部菜单:
- 📋 目录 - 查看章节列表
- ⏮️ 上一章 - 跳转到上一章
- ⏭️ 下一章 - 跳转到下一章
- 🔊 朗读 - 开始/停止朗读
- ⚙️ 设置 - 阅读设置
阅读设置
点击设置按钮可调整：
| 设置项 |
说明 |
| 字体大小 |
调整正文字号 |
| 行间距 |
调整行与行的距离 |
| 滚屏速度 |
自动滚屏速度 |
| 翻页速度 |
自动翻页速度 |
| 背景颜色 |
选择阅读背景色 |
| 背景图片 |
设置背景图片 |
朗读功能
点击朗读按钮开始语音朗读：
- 🔊 开始朗读 - 开始朗读当前章节
- ⏸️ 暂停 - 暂停朗读
- ▶️ 继续 - 继续朗读
- ⏹️ 停止 - 停止朗读
- ⏮️ 上一句 - 朗读上一句
- ⏭️ 下一句 - 朗读下一句
朗读时会高亮显示当前句子。
书签功能
- 点击书签图标添加书签
- 长按书签图标查看所有书签
- 点击书签可跳转到对应位置
3.4 书源编辑
管理书源配置：
书源列表:
操作:
- 📝 编辑 - 修改书源配置
- 🗑️ 删除 - 删除书源
- ➕ 添加 - 新建书源
导入书源:
- 将书源TXT文件放入
booksource 目录
- 重启应用自动加载
3.5 正文处理
管理内容替换规则：
规则类型:
- 普通替换 - 精确匹配替换
- 正则替换 - 使用正则表达式匹配
作用范围:
- 全站生效 - 所有网站都应用
- 指定站点 - 只在特定网站生效
- 指定书籍 - 只在特定书籍生效
使用示例:
查找内容: 请记住本站域名
替换为: (留空删除)
四、数据存储
4.1 存储位置
Android: /storage/emulated/0/kuaibu/
Windows: 程序运行目录
4.2 目录结构
kuaibu/
├── books/ # 书籍数据
├── download/ # 下载内容
│ └── 书名/
│ ├── 1.txt # 第一章
│ └── ...
├── cover/ # 封面图片
├── booksource/ # 书源文件
│ └── *.txt # 书源配置
└── reading_progress.json # 阅读进度
4.3 数据备份
备份以下内容即可保存所有数据：
download/ 文件夹cover/ 文件夹booksource/ 文件夹reading_progress.json 文件
五、书源格式
5.1 书源文件格式
书源使用TXT格式，每行一个配置项：
网站名称=书源名称
网站网址=https://example.com/
网站编码=UTF-8
简介页网址规则=https://example.com/(书类)/(书号)/
目录页网址规则=https://example.com/(书类)/(书号)/all.html
章节页网址规则=https://example.com/(书类)/(书号)/(章号).html
目录章节排序方式=按HTML先后排列
搜索网址=https://example.com/search?key={key}
搜索类型=GET
分类排行=分类名::URL模板&&分类名2::URL模板2
搜索状态=1
分类状态=1
POST类型搜索网址规则写法 ,{searchkey={key}}
5.2 占位符说明
| 占位符 |
说明 |
{key} |
搜索关键词 |
{page} |
页码 |
(书类) |
书籍分类标识 |
(书号) |
书籍ID |
(章号) |
章节ID |
六、常见问题
6.1 搜索无结果
可能原因:
- 书源未启用 - 在书源编辑中启用
- 书源失效 - 更换其他书源
- 网络问题 - 检查网络连接
6.2 章节内容无法加载
解决方法:
- 检查书源配置是否正确
- 尝试更换书源
- 检查网络连接
6.3 朗读功能异常
Windows:
Android:
- 确保系统TTS引擎正常
- 安装Google文字转语音引擎
6.4 阅读进度丢失
解决方法:
- 检查
reading_progress.json 是否存在
- 确保应用有存储权限
- 不要强制关闭应用
6.5 封面无法显示
解决方法:
- 检查网络连接
- 封面会自动下载，稍等片刻
- 手动刷新书架
PS.之前发过Python版的，借助AI改用flutter实现跨平台。
因为这个写书源比较方便，甚至一些简单网站可以实现输入首页网址自动写出书源功能。
简单提供一下思路，反正开源了，可以自行研究实现。
用户输入网站URL
↓
分析首页搜索功能
↓
执行搜索获取详情页
↓
获取目录页（判断详情页是否就是目录页）
↓
获取正文页（第一章）
↓
提取URL规则模式
↓
生成书源
开源地址：
https://github.com/xy9144/kuaibuflutter-main
下载地址：https://wwaxs.lanzoub.com/b01x1bflsh
密码:awx4 | 
[复制链接]
发表于 2026-4-6 22:15
