小说数据
小说数据存储¶
数据来源与生命周期¶
- 内置预览小说:由阅读器示例数据提供。
- 离线导入小说:解析后保存在 React 内存状态中,刷新或关闭页面后不会由当前实现自动恢复。
- 在线小说:正文和元数据存于 Node API 的 MariaDB
book表;搜索列表返回摘要,选择书籍后通过详情接口加载正文。 - 用户书架:保存在服务端
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 功能。
阅读器解析¶
阅读器通过文件模型规范化在线或本地文件的显示数据。小说正文可按章节/段落或分页模式呈现;模式转换属于前端视图逻辑,不表示正文在数据库中按章节拆表存储。
持久化格式变化时需以应用实际迁移实现为准;当前不应依赖文档中的伪代码推断存在自动数据迁移。