自定义漫画源失效 · 3.1.0 重构导致旧源失效

现象

从旧版本升级到新版本后，之前添加的自定义漫画源全部消失，或者出现在列表里但打开任何页面都是空白/报错。

原因

3.1.0 版本对自定义漫画源进行了一次大规模重构：

• 更换了 JS 引擎：底层执行环境完全不同
• 重写了接口设计：新增/修改/删除了大量接口
• 新增大量接口：覆盖漫画源完整生命周期

这次重构是破坏性的——3.0.x 及更早版本格式的漫画源在 3.1.0+ 上完全无法运行。

官方处理方式

PicaComic 在 3.1.0 release note 里明确说明：

"已添加的旧版本的自定义漫画源将会失效，你需要重新添加"

应用不会在升级过程中自动转换旧格式的源——这由设计决定，不是 bug。

处理步骤

1. 确认升级到 3.1.0+ 版本
2. 进入设置 → 漫画源 → 浏览列表
3. 找到你之前用的那些漫画源，查看是否有 3.1.0+ 兼容的新版本
4. 如果有，点"添加"重新安装（旧版本源可以从列表里移除了）
5. 如果没有，去源作者的仓库或社区看是否有更新计划
6. 如果是自己写的源，需要按照新版接口重写脚本

怎么判断一个漫画源是否兼容

在浏览列表里，每个漫画源会标注适用的版本：

• 标注"3.1.0+" → 新版格式，在 3.1.0+ 上正常运行
• 标注"3.0.x"或更早 → 旧版格式，在 3.1.0+ 上无法运行

也可以看源脚本的头部注释（如果作者写了版本声明）。

社区源更新情况

3.1.0 发布后，社区维护的漫画源列表经历了一轮集中更新。大部分常用源都有了 3.1.0+ 兼容版本。

升级前的数据备份建议

升级到 3.1.0+ 之前，建议：

1. 导出应用数据（书架、收藏、历史等，参考"数据导入与导出"页）
2. 截图保存当前启用的自定义漫画源列表
3. 升级后逐一重新添加

即使自定义源失效，书架、收藏、阅读历史这些数据不会丢——它们和漫画源脚本是分开存储的。