Skip to content

小说数据

小说数据存储

数据来源与生命周期

  1. 内置预览小说:由阅读器示例数据提供。
  2. 离线导入小说:解析后保存在 React 内存状态中,刷新或关闭页面后不会由当前实现自动恢复。
  3. 在线小说:正文和元数据存于 Node API 的 MariaDB book 表;搜索列表返回摘要,选择书籍后通过详情接口加载正文。
  4. 用户书架:保存在服务端 user_book 关联表;移除书架项不会等同于删除公共书籍。

阅读样式通过 localforage 持久化,小说内容和阅读进度则没有使用该存储层持久化。不要将离线模式等同于本地小说数据库。

在线书籍字段

数据库字段以 genshin-novel-reader-scripts/sql/init.sql 为准,主要包括:

id, name, cover_photo, author, brief, detail, created_at,
price, size, tag, download_count

size 按 JavaScript String.length 计算。tag 是逗号分隔的字符串,最多 50 字符;它由 Python API 生成并由 Node 写入数据库。price 是遗留字段,不代表当前存在付费/VIP 功能。

阅读器解析

阅读器通过文件模型规范化在线或本地文件的显示数据。小说正文可按章节/段落或分页模式呈现;模式转换属于前端视图逻辑,不表示正文在数据库中按章节拆表存储。

持久化格式变化时需以应用实际迁移实现为准;当前不应依赖文档中的伪代码推断存在自动数据迁移。