项目第一天（2025.2.15）

跨平台智能小说阅读器（支持Linux/Windows联动）项目文档

一、项目概述

1. 商业价值

随着互联网和移动设备的普及，人们对于小说阅读的需求日益多样化，且常常在不同设备上进行阅读。本跨平台智能小说阅读器旨在整合多平台阅读需求，满足用户在 Linux 和 Windows 系统下的无缝阅读体验。其商业价值体现在以下几个方面：

多平台支持：支持 Linux 和 Windows 系统，覆盖更广泛的用户群体。

书签/笔记同步：方便用户在不同设备间随时随地继续阅读，并保留重要的笔记和标记。

智能排版：提供舒适的阅读体验，优化文本显示格式。

OCR 扫描版小说解析：支持将扫描版小说转化为可编辑文本，拓展阅读资源。

2. 核心技术

C++/QT（GUI）：在 Windows 系统上使用 QT 框架进行客户端界面开发，C++ 作为编程语言，为用户提供友好、直观的图形用户界面。

C 语言（Linux 服务端）：在 Linux 系统上使用 C 语言编写服务器程序，充分发挥 Linux 系统的稳定性和高效性。

TCP 套接字通信：实现 Windows 客户端与 Linux 服务器之间的数据传输，确保信息的可靠交换。

SQLite3（本地书库）：在客户端和服务器端都使用 SQLite3 数据库进行书籍元数据的存储和管理，便于数据的查询和维护。

OpenCV（扫描版解析）：利用 OpenCV 库对扫描版小说进行图像识别和文字提取，将图像中的文字转化为可编辑的文本。

二、开发说明文档

1. 架构设计

 A[Windows QT客户端] -->|TCP| B(Linux服务端)

B -->|SQLite3| C[书籍元数据库] B -->|OpenCV| D[扫描版小说处理模块] A -->|本地SQLite| E[用户阅读历史]

2. 模块划分

2.1 客户端（Windows QT 客户端）

书籍展示：通过 QT 界面展示本地书库和从服务器同步的书籍列表，支持分类浏览、搜索等功能。

阅读界面：提供舒适的阅读体验，包括字体设置、背景颜色调整、翻页效果等功能。

书签管理：支持添加、删除、修改书签，并将书签信息同步到本地 SQLite3 数据库和服务器。

内容爬取：通过网络爬虫技术，从网站上获取小说内容，并将其保存到本地书库。

2.2 服务端（Linux 服务端）

用户认证：验证用户的身份信息，确保只有合法用户能够使用系统。

书籍同步：处理客户端的书籍同步请求，将新的书籍信息和阅读进度更新到服务器的书籍元数据库中，并同步给其他设备。

OCR 处理：接收客户端上传的扫描版小说图像，使用 OpenCV 库进行文字识别和提取，将处理结果反馈给客户端。

2.3 联动通信

TCP 协议封装书籍元数据：使用 TCP 协议在客户端和服务器之间传输数据，将书籍元数据封装为 JSON 格式，方便数据的解析和处理。

3. 详细设计

3.1 客户端详细设计

3.1.1 书籍展示模块

使用 QT 的 QListWidget 或 QTreeView 控件展示书籍列表，根据书籍的分类、名称等信息进行排序和显示。

提供搜索功能，使用 QLineEdit 控件输入关键词，通过模糊查询查找相关书籍。

3.1.2 阅读界面模块

使用 QTextEdit 或 QPlainTextEdit 控件显示小说内容，支持设置字体、字号、颜色等样式。

实现翻页功能，通过键盘事件或鼠标点击触发。

提供夜间模式、护眼模式等阅读模式切换功能。

3.1.3 书签管理模块

使用 QTableWidget 控件展示书签列表，显示书签的名称、页码、时间等信息。

提供添加、删除、修改书签的操作按钮，与本地 SQLite3 数据库进行交互。

3.1.4 内容爬取模块

使用 QT 的 QNetworkAccessManager 类发送 HTTP 请求，获取小说网站的 HTML 页面。

使用正则表达式或解析库（如 QJsonDocument）提取小说内容和相关信息。

将爬取到的内容保存到本地 SQLite3 数据库中。

3.2 服务端详细设计

3.2.1 用户认证模块

使用 C 语言的 socket 编程实现 TCP 服务器，监听客户端的连接请求。

接收客户端发送的用户名和密码，与服务器端的用户数据库进行比对。

如果认证成功，返回认证结果和令牌给客户端；否则返回错误信息。

3.2.2 书籍同步模块

接收客户端发送的书籍同步请求，解析 JSON 格式的书籍元数据。

将新的书籍信息和阅读进度更新到服务器的 SQLite3 数据库中。

根据客户端的设备 ID，将最新的书籍信息和阅读进度同步给其他设备。

3.2.3 OCR 处理模块

接收客户端上传的扫描版小说图像，保存到服务器的临时目录中。

使用 OpenCV 库进行图像预处理（如灰度化、降噪、二值化等）和文字识别。

将识别结果生成文本文件，返回给客户端。

三、用例图

mmermaid usecase User usecase "上传扫描版小说" as UC1 usecase "同步阅读进度" as UC2 usecase "多终端登录" as UC3 User --> UC1 User --> UC2 User --> UC3

用例说明

上传扫描版小说：用户可以通过客户端上传扫描版小说图像，服务器使用 OpenCV 库进行 OCR 处理，并将识别结果返回给客户端。

同步阅读进度：用户在不同设备上登录系统后，系统会自动同步阅读进度和书签信息，确保用户可以随时随地继续阅读。

多终端登录：用户可以在 Windows 和 Linux 系统上同时登录系统，享受跨平台的阅读体验。

四、数据库设计

1. 客户端数据库（本地 SQLite3）

用户阅读历史表（user_read_history） | 字段名 | 类型 | 描述 | | ---- | ---- | ---- | | id | INTEGER | 主键，自增 | | book_id | TEXT | 书籍 ID | | page_num | INTEGER | 阅读页码 | | read_time | DATETIME | 阅读时间 |

书签名表（bookmark） | 字段名 | 类型 | 描述 | | ---- | ---- | ---- | | id | INTEGER | 主键，自增 | | book_id | TEXT | 书籍 ID | | bookmark_name | TEXT | 书签名称 | | page_num | INTEGER | 书签页码 | | create_time | DATETIME | 创建时间 |

2. 服务端数据库（SQLite3）

用户表（users） | 字段名 | 类型 | 描述 | | ---- | ---- | ---- | | id | INTEGER | 主键，自增 | | username | TEXT | 用户名 | | password | TEXT | 密码 |

书籍元数据表（book_metadata） | 字段名 | 类型 | 描述 | | ---- | ---- | ---- | | id | INTEGER | 主键，自增 | | book_title | TEXT | 书籍标题 | | author | TEXT | 作者 | | category | TEXT | 分类 | | publish_date | TEXT | 出版日期 |

用户书籍关联表（user_book_relation） | 字段名 | 类型 | 描述 | | ---- | ---- | ---- | | id | INTEGER | 主键，自增 | | user_id | INTEGER | 用户 ID | | book_id | INTEGER | 书籍 ID | | reading_progress | INTEGER | 阅读进度 |

五、代码实现示例

1. 客户端 Qt 代码示例（C++）

cppcpp #include

class MainWindow : public QMainWindow { Q_OBJECT

public: MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) { // 初始化界面 initUI(); }

private slots: void onUploadButtonClicked() { // 处理上传扫描版小说按钮点击事件 QString filePath = QFileDialog::getOpenFileName(this, "选择扫描版小说图像"); if (!filePath.isEmpty()) { // 发送上传请求到服务器 } }

private: void initUI() { // 创建上传按钮

用户功能体验流程图

库管理模块

系统架构图

读器核心模块

跨平台联动流程图

整体系统流程

异常处理