kuaibuflutter开源跨平台小说阅读器
# kuaibuflutter 用户手册## 一、软件简介
kuaibuflutter是一款flutter开发的开源跨平台小说阅读器，已支持 Windows 和 Android 系统。提供以下核心功能：
- 📚 **书架管理** - 管理您收藏的书籍
- 🔍 **多源搜索** - 同时搜索多个书源
- 📖 **在线阅读** - 流畅的阅读体验
- 💾 **离线下载** - 下载章节离线阅读
- 🔊 **朗读功能** - 语音朗读小说内容
- 📑 **阅读进度** - 自动保存阅读位置
- 🎨 **个性设置** - 自定义阅读界面
## 二、快速开始
### 2.1 安装
**Windows**:
- 双击 `kuaibuflutter.exe` 运行
**Android**:
- 安装 APK 文件即可
### 2.2 添加书籍
1. 点击「网上搜书」选项卡
2. 在搜索框输入书名或作者
3. 点击搜索按钮
4. 在结果中选择想要的书籍
5. 双击弹出目录信息后「加入书架」
### 2.3 开始阅读
1. 点击「我的书架」选项卡
2. 点击想要阅读的书籍
3. 自动打开阅读界面
## 三、功能详解
### 3.1 我的书架
书架页面展示您收藏的所有书籍：
**功能按钮**:
- 🔍 **搜索** - 在书架中搜索书籍
- 📊 **排序** - 按添加时间/最近阅读排序
- 🗑️ **删除** - 长按书籍可删除
**书籍信息**:
- 封面图片
- 书名和作者
- 最新章节
- 阅读进度
### 3.2 网上搜书
搜索和发现新书的页面：
**搜索功能**:
- 输入书名或作者搜索
- 支持多书源同时搜索
- 显示搜索来源
**分类浏览**:
- 左侧显示书源分类
- 点击分类查看推荐书籍
**搜索结果**:
- 显示书名、作者
- 显示最新章节
- 双击加入书架
### 3.3 阅读界面
#### 基本操作
| 操作 | 说明 |
|------|------|
| 点击屏幕左侧 | 上一页 |
| 点击屏幕右侧 | 下一页 |
| 点击屏幕中间 | 显示/隐藏菜单 |
| 滑动屏幕 | 上下滚动 |
#### 菜单功能
**顶部菜单**:
- 返回按钮
- 章节标题
- 书签按钮
**底部菜单**:
- 📋 **目录** - 查看章节列表
- ⏮️ **上一章** - 跳转到上一章
- ⏭️ **下一章** - 跳转到下一章
- 🔊 **朗读** - 开始/停止朗读
- ⚙️ **设置** - 阅读设置
#### 阅读设置
点击设置按钮可调整：
| 设置项 | 说明 |
|--------|------|
| 字体大小 | 调整正文字号 |
| 行间距 | 调整行与行的距离 |
| 滚屏速度 | 自动滚屏速度 |
| 翻页速度 | 自动翻页速度 |
| 背景颜色 | 选择阅读背景色 |
| 背景图片 | 设置背景图片 |
#### 朗读功能
点击朗读按钮开始语音朗读：
- 🔊 **开始朗读** - 开始朗读当前章节
- ⏸️ **暂停** - 暂停朗读
- ▶️ **继续** - 继续朗读
- ⏹️ **停止** - 停止朗读
- ⏮️ **上一句** - 朗读上一句
- ⏭️ **下一句** - 朗读下一句
朗读时会高亮显示当前句子。
#### 书签功能
- 点击书签图标添加书签
- 长按书签图标查看所有书签
- 点击书签可跳转到对应位置
### 3.4 书源编辑
管理书源配置：
**书源列表**:
- 显示所有已导入的书源
- 显示搜索和发现状态
**操作**:
- 📝 **编辑** - 修改书源配置
- 🗑️ **删除** - 删除书源
- ➕ **添加** - 新建书源
**导入书源**:
1. 将书源TXT文件放入 `booksource` 目录
2. 重启应用自动加载
### 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 搜索无结果
**可能原因**:
1. 书源未启用 - 在书源编辑中启用
2. 书源失效 - 更换其他书源
3. 网络问题 - 检查网络连接
### 6.2 章节内容无法加载
**解决方法**:
1. 检查书源配置是否正确
2. 尝试更换书源
3. 检查网络连接
### 6.3 朗读功能异常
**Windows**:
- 确保系统已安装语音包
- 在系统设置中检查TTS功能
**Android**:
- 确保系统TTS引擎正常
- 安装Google文字转语音引擎
### 6.4 阅读进度丢失
**解决方法**:
1. 检查 `reading_progress.json` 是否存在
2. 确保应用有存储权限
3. 不要强制关闭应用
### 6.5 封面无法显示
**解决方法**:
1. 检查网络连接
2. 封面会自动下载，稍等片刻
3. 手动刷新书架
PS.之前发过Python版的，借助AI改用flutter实现跨平台。
因为这个写书源比较方便，甚至一些简单网站可以实现输入首页网址自动写出书源功能。
简单提供一下思路，反正开源了，可以自行研究实现。
用户输入网站URL
↓
分析首页搜索功能
↓
执行搜索获取详情页
↓
获取目录页（判断详情页是否就是目录页）
↓
获取正文页（第一章）
↓
提取URL规则模式
↓
生成书源
开源地址：
https://github.com/xy9144/kuaibuflutter-main
下载地址：https://wwaxs.lanzoub.com/b01x1bflsh
密码:awx4 没有书源呀，提供一下书源就更完美了 兼容开源阅读的书源不？ 看看 谢谢分享 谢谢分享 谢谢分享 谢谢分享{:1_893:} 手机端没图？都支持什么格式的？ 这个必须试试，谢谢 不会也是浏览器页面那种吧，看看。 感谢分享，有书源嘛