浏览器本地存储¶
当前实现¶
阅读器通过 localforage 抽象浏览器本地存储,封装位于 genshin-novel-reader-web/src/shared/utils/store.js。不同浏览器可能使用 IndexedDB 等底层驱动;具体容量由浏览器配额和驱动决定。
当前 App.js 实际读写的 key 只有:
| Key | 用途 | 当前状态 |
|---|---|---|
novel-reader-style |
阅读样式设置 | 初始化时读取,用户修改样式后写入 |
local-novels |
原计划用于离线小说 | 仅定义常量,当前阅读器未用于小说持久化 |
folder-tree |
原计划用于目录树 | 仅定义常量,当前阅读器未用于目录树持久化 |
离线导入小说、当前阅读位置和阅读进度由 React 内存状态管理,刷新页面后不会自动恢复。在线书架保存在服务端,不在浏览器本地存小说副本。
相关 Cookie¶
Cookie 与 localforage 是不同的存储机制。阅读器从 lang Cookie 读取界面语言;在线模式使用 novelToken 携带 JWT,并使用 username 查找当前用户。其生命周期、安全属性和清除逻辑由登录页面/服务端集成决定。
接口¶
getLocalValue(key) 和 setLocalValue(key, value) 封装 localforage 的读取与写入;读取为异步操作。样式当前以 JSON 字符串写入,加载后再解析。
新增持久化数据时,应明确版本、退出/清除行为、浏览器配额和隐私影响,并实际在使用点接入;仅声明一个 key 不代表功能已经持久化。