跳转至

版本回退边界

一句话:用过 v0.10.138 之后,不要再把插件文件夹换回旧版本。 换回去的话,插件打不开你的数据 —— 数据还在,但读不出来。

为什么

v0.10.138 为了存整页 Markdown,给本地数据库加了一张新表,数据库版本号从 5 升到 6。

浏览器的 IndexedDB 有一条规矩:版本号只能往上,不能往下。 旧版本插件认的是版本 5,它打开一个已经是版本 6 的库时会直接报错退出。

flowchart TD
    A[v0.10.137 及更早<br/>认版本 5] --> B{打开数据库}
    C[v0.10.138 起<br/>认版本 6] --> B
    B -->|库是版本 5| D[正常打开]
    B -->|库是版本 6,插件认 5| E[报错:VersionError<br/>整库读不出来]
    B -->|库是版本 5,插件认 6| F[自动升级到 6<br/>老数据不动]

会看到什么

从 v0.10.135 起,这种失败不再是静默的:插件图标上会出现一个红色 ! 角标, 鼠标悬停能看到具体报错,系统日志里也有记录。

看到 ! 角标又刚换过版本,基本就是踩到这条了。

真要回退怎么办

顺序不能错:

  1. 先在当前(新)版本里把数据导出
  2. 再换成旧版本插件
  3. 旧版本会在一个全新的空库上重新开始,把导出的数据按需导入

不要指望「换回旧文件夹就恢复原状」—— 那是最容易发生的操作,也正是这条边界最容易被踩到的地方。

备份目录里的旧版本

backup/ 里 v0.10.137 及更早的所有版本目录同样不可回退,原因相同。 backup/README.md 和 backup/v0.10.137_20260902_last-rollbackable/README-回退边界.md 都已标注。