调试技巧

从链路定位

按以下顺序判断：

1. 来源是否存在、启用并通过健康检查。
2. 搜索请求是否返回预期页面，而不是登录或验证页。
3. 列表规则是否得到书名和详情地址。
4. 详情是否补全目录地址。
5. 目录是否得到有效章节 URL。
6. 正文是否得到非空内容，图片是否能加载。

常见问题

• 相对链接错误：检查来源基础 URL和 bookSourceUrl 身份，不要手工拼接重复路径。
• 目录成功、正文失败：检查正文规则、Cookie、Referer、编码和章节请求方法。
• 页面只在浏览器可见：使用 WebView 登录/动态渲染流程，并设置合理等待时间。
• 内容有广告：使用来源级替换规则和 ContentCleaner，不要把清洗逻辑散落在 UI。
• 进度看似跳动：分别检查章节 ID、来源切换、缓存和分页状态。

日志原则

调试日志应脱敏 URL 查询参数、Cookie、Authorization 和个人信息。健康检查失败时保留状态和原因，不要把失败来源从用户书架静默删除。