版本、升级与数据兼容
当前文档描述哪个版本
本轮操作说明核对至 2026-10-04，main 基线 dd253f85。项目 package 版本仍为 3.9.1，但 main 已包含正式 v3.9.1 发布之后的功能与界面变化。
因此“版本号同样是 3.9.1”不代表代码完全相同。排查问题时一起提供构建 commit、访问地址和日期。
在线站点可能有部署时差；固定 Releases不会自动包含后续 main 功能。
升级前
- 在原环境导出完整 JSON，并另存重要正文。
- 保留原始文件；使用硬盘工作区时完成一次明确的差异检查与同步。
- 阅读更新日志中的数据兼容说明。
- 更新后核对作品、章节、素材与保存结果。
本地源码没有个人改动时，可以按 Git 提示更新源码，再运行 npm ci 与 npm run dev。有本地改动时先保留并处理冲突，不要用强制覆盖命令升级。
旧备份不是一律可导入
当前备份校验只接受支持的当前格式。数据库版本迁移与外部备份导入是两条不同路径；支持某些数据库迁移不意味着任意旧 JSON 都能导入。
旧文件被拒绝时：
- 保留原始备份和仍可打开它的原环境。
- 记录版本与错误文本。
- 若原环境能读取，另行导出正文，防止只剩一个格式。
- 提交反馈，等待有证据的兼容方案。
不要手改备份版本号、删除校验字段或清空原浏览器数据库来绕过错误。
回退
回退源码或打开旧 Release 不保证旧程序能读取新数据。更新前保留的原版备份和独立环境是恢复依据。
分支中已有实现、进入远程主干、官网部署成功是三个状态。待合并开发记录单独说明尚未交付的内容；知识库维护日期不是产品发布日期。