源文件里通常写什么
字段不多,关键在于四段规则各管一段流程
配置文件是文本格式,用编辑器打开就能读。常见的字段大致分两类:一类是身份信息,告诉客户端这条源叫什么、对应哪个站点、规则本身是第几版;另一类是流程规则,把「搜索 → 详情 → 章节 → 图片」拆成四段分别描述。字段名各版本略有差别,但用途一致。
| 字段 | 作用 |
|---|---|
| 名称 | 显示在源列表与搜索结果分组里的名字 |
| 版本 | 规则自身的版本号,源站改版后需要往上抬 |
| 站点地址 | 请求的基础域名,换镜像时改这里 |
| 搜索规则 | 关键词怎么拼进地址,结果列表从哪一段取 |
| 详情规则 | 作品页的标题、封面、简介、标签怎么取 |
| 章节规则 | 章节列表的结构,以及每章的图片集合 |
链接导入和文件导入的差别
一个省事,一个稳妥
链接导入
把配置地址粘进输入框,客户端自己下载并解析。省事,但要求当前网络能访问那个地址,国内直连海外仓库时容易超时。
文件导入
先把配置文件存到手机,再从本地选中。多一步,但不受网络影响,也不怕地址以后失效。
两种都要做的
导入后在源列表里确认已启用,再回发现页刷新一次,规则才会真正参与聚合搜索。
版本号写低了会怎样
不是格式错,而是「看起来正常但取不到东西」
版本号是最容易被忽略的一栏。源站改版之后,旧规则里的地址还能请求,只是返回的结构变了,解析出来是空的:搜索有结果但没封面,章节列表点进去是零章,图片地址拼出来全是 404。这种状态不会报错,只会让人以为源失效了。
判断办法很直接:换一条同站的新版规则,如果立刻正常,说明原来的规则旧了。自己维护的源,遇到站点改版就把版本号往上抬一位,再逐段核对地址。
改源时最容易漏的两处
一处是相对路径,一处是编码
- 相对路径。章节与图片地址常常是相对站点根目录拼出来的,换了镜像域名却沿用旧的路径前缀,就会拼出重复的段。
- 编码。站点用哪种字符集解析,规则里要跟着写;写错时标题会变成一串问号,但请求本身是成功的。
改完不必急着发布,先在客户端里用一本书走一遍完整流程:搜索、进详情、翻两章、看图片能不能加载。四步都过,这条源才算能用。
装好客户端再动手改
改一行就能立刻在手机上验证,比对着文档猜要快。
立即下载