漫画源管理与排错 · 禁用、更新与常见问题

漫画源管理入口

所有漫画源（内置和自定义）的管理入口都在：设置 → 漫画源。

这里列出了所有漫画源及其启用状态。点击某个源可以进入该源的详细设置（比如 e-hentai 的 Cookie 配置、绅士漫画的分类屏蔽）。

启用与禁用

勾选/取消勾选漫画源即可启用或禁用。禁用后该源不会出现在首页、搜索和书架中。

移除漫画源（从应用中完全删除）：自定义源可以完全移除，内置源无法移除但可以禁用。

V3.1.0 修复了"移除漫画源没有删除相关页面设置的问题"——移除漫画源后，与该源关联的阅读器设置（比如阅读模式、翻页方式）会一起清理，不会残留到其他源上。

更新检测与执行

自定义漫画源在以下情况会提示有更新：

• 应用打开时检查源脚本版本
• 手动点击"检查更新"按钮

更新时应用会重新下载脚本文件并替换。更新过程中如果网络中断，旧版本的脚本不会被破坏——只有下载成功并通过格式校验后才会替换。

常见问题

源加载后页面空白

检查点：

1. 源脚本是否为 3.1.0+ 格式（旧源不兼容新引擎）
2. 应用内日志是否有错误输出（V4.0.2 新增本地文件日志）
3. HTTP 请求是否成功（漫画源的 log() 接口可以打印请求结果）

旧源升级后失效

这是 3.1.0 版本的破坏性变更导致的预期行为。需要用 3.1.0+ 格式的源脚本重新添加。社区列表中的源如果标注了 3.1.0+，直接点添加即可。

自定义源封面不显示

V3.1.1 修复了这个问题。如果仍遇到封面不显示，检查源脚本中封面 URL 是否有效（HTTP 200），以及图片格式是否被支持（PNG/JPG/WebP/GIF）。

JS Map 类型转换问题

3.1.1 修复了自定义漫画源中 JS Map 类型到 Dart Map 类型的转换问题。如果你在编写源时用到了 ES6 Map，升级到 3.1.1+ 后应该能正确工作。

日志输出问题

3.1.1 修复了 log() 只能接受 string 类型的问题，现在可以直接传入对象或数组，会自动序列化为字符串输出。

日志查看

V4.0.2 引入的本地文件日志是排查漫画源问题最重要的工具。在设置 → 关于 → 日志文件路径可以找到日志文件位置。日志包含：

• 漫画源加载错误
• HTTP 请求失败详情
• JS 引擎执行错误
• 格式校验失败信息

排查问题时，先看日志比盲目重试有效得多。