venera 拆开一条源
一条源地址表面只是一个链接,背后其实是一份描述文件:它告诉 venera 这个阅读器该去哪个站点搜、怎么取作品详情、怎么翻章节。看懂这几项,遇到打不开的作品就能判断是源的问题还是网络的问题。
配置文件的字段构成
配置的核心是四件事:站点名称、请求地址、请求方式与返回内容的解析规则。名称只影响列表里显示什么,请求地址决定访问哪台服务器,解析规则决定能不能从返回结果里认出作品、章节和图片。
| 字段 | 作用 | 写错时的表现 |
|---|---|---|
| 名称 | 列表里的显示名 | 只影响辨识,不影响可用性 |
| 地址 | 搜索与详情请求的入口 | 刷新后数量为 0,或提示无法连接 |
| 请求方式 | GET 或 POST | 返回内容为空,列表能刷新但没有条目 |
| 解析规则 | 从返回内容里取标题、章节、图片 | 能搜到作品,点进去没有章节或图片空白 |
| 启用状态 | 是否参与搜索 | 关掉后该源的作品暂时不出现在结果里 |
字段名称在不同版本的配置文件里可能略有差异,判断标准始终是「刷新后有没有数量」。
源失效时先看什么
顺序是「能不能连上 → 能不能列出作品 → 能不能取到章节 → 能不能取到图片」。四步里卡在哪一步,问题就出在哪一层。
- 连不上:地址不可达,通常是域名换了或者站点暂时关闭。
- 列不出作品:地址通但返回结构变了,解析规则需要跟着更新。
- 有章节没图片:图片域名被单独拦截,或者需要额外的请求头。
- 偶尔能读偶尔不能:多数是网络抖动,换一个时间段再试比改配置有效。
多源结果的排序与去重
搜索结果是按源分组的,不会混成一条长列表。同一部作品在不同源里出现时,应用按标题归一化比对,把相似条目排在一起,但不会自动合并——章节编号与图片顺序各家不同,贸然合并反而会乱。
书架里同一部作品只保留一条记录,来源可以在详情页切换。换源之后阅读位置按章节序号重新对应,遇到章节编号不连续的情况会提示手动指定。
备份与迁移源配置
源配置可以单独导出成一个文件,和阅读记录分开存放。换设备时先导入源配置,再导入阅读备份,书架里的作品就能重新对上。
配置文件里可能包含访问凭据,分享出去之前先看一眼内容。不需要同步的源建议先停用再导出,文件会干净很多。
自建源要准备什么
自建源本质是写一份能被解析的规则,需要熟悉目标站点的搜索接口与详情页结构。准备三样东西就够:一个稳定的可访问地址、一份准确的字段对应关系、一个用于测试的作品名。
规则写完先在应用里单独启用这一条源,搜索那个测试作品名。能搜到、能打开、能翻页,三步都通过再开始批量使用。
配置看不懂就先用列表
源列表里的现成条目不需要理解字段,勾选就能用。等哪天想自己接一个站,再回头看这份说明。
