Skip to content

源字段速查 (Source Fields) ​

本文档列出源 JSON 中各部分(搜索、发现、详情页、目录、正文)的所有可用字段。

1. 基本字段 ​

字段必须说明
bookSourceUrl是源 URL,唯一标识,不可重复。与其他源相同会覆盖
bookSourceName是源名称,可重复
bookSourceGroup否源分组,用于整理
bookSourceType否源类型:0(文本,默认)、1(音频)
bookUrlPattern否书籍 URL 正则,添加网址时用于识别源
header否请求头 JSON 字符串,见 请求头配置
loginUrl否登录 URL,见 认证与登录
exploreUrl否发现地址,见 发现 URL 配置
searchUrl否搜索地址
weight否源权重,搜索排序时使用
enabled否是否启用
enabledExplore否是否启用发现
customOrder否自定义排序
lastUpdateTime否最后更新时间
bookSourceComment否源备注

2. 搜索字段 (ruleSearch) ​

字段说明
url搜索地址。 为关键字, 为页码
bookList书籍列表规则
name书名规则
author作者规则
kind分类规则
wordCount字数规则
lastChapter最新章节规则
intro简介规则
coverUrl封面规则
bookUrl详情页 URL 规则

3. 发现字段 (ruleExplore) ​

字段说明
url发现地址。 为页码,支持 JSON 数组格式
bookList书籍列表规则
name书名规则
author作者规则
kind分类规则
wordCount字数规则
lastChapter最新章节规则
intro简介规则
coverUrl封面规则
bookUrl详情页 URL 规则

4. 详情页字段 (ruleBookInfo) ​

字段说明
bookInfoInit预处理规则(仅支持 AllInOne 正则或 JS)
name书名规则
author作者规则
kind分类规则
wordCount字数规则
lastChapter最新章节规则
intro简介规则
coverUrl封面规则
tocUrl目录 URL 规则(仅支持单个 URL)
canReName允许修改书名作者
relatedBooks关联书籍配置,见 关联书籍配置

预处理规则 (bookInfoInit) ​

只能使用 AllInOne 正则(以 : 开头)或 JS。JS 返回值需为 JSON 对象:

javascript
(function(){
    return {
        a: "书名",
        b: "作者",
        c: "分类",
        d: "字数",
        e: "最新章节",
        f: "简介",
        g: "封面URL",
        h: "目录URL"
    };
})()

此时各规则字段填对应的 key:name → a,author → b,以此类推。

canReName 逻辑 ​

条件行为
规则不为空 且 详情页书名不为空使用详情页书名
否则使用搜索页书名
规则不为空 且 详情页作者不为空使用详情页作者
否则使用搜索页作者

5. 目录字段 (ruleToc) ​

字段说明
chapterList目录列表规则。首字符 - 可使列表反序
chapterName章节名称规则
chapterUrl章节 URL 规则
isVipVIP 标识。结果为 null、false、0、"" 时为非 VIP
updateTime章节信息(可用 java.timeFormat(timestamp) 转换时间戳)
nextTocUrl目录下一页规则。支持单个 URL、URL 数组,JS 返回 []/null/"" 时停止

6. 正文字段 (ruleContent) ​

字段说明
content正文规则
nextContentUrl正文下一页 URL 规则。支持单个 URL、URL 数组
sourceRegex资源正则,用于嗅探媒体资源
webJsWebView JS,用于模拟点击等操作。必须有返回值(不为空表示执行成功)

WebView JS (webJs) ​

用于模拟鼠标点击等操作,返回值不为空表示执行成功(否则会无限循环),返回值用于资源正则或正文。

示例:

javascript
getDecode();$('#content').html();

资源正则 (sourceRegex) ​

用于嗅探 WebView 加载的媒体资源。配合章节 URL 的 {"webView": true} 使用。

一般写 .*\.(mp3|mp4).* 即可匹配常见媒体格式。

7. 完整 JSON 结构 ​

json
{
    "bookSourceUrl": "https://www.example.com",
    "bookSourceName": "示例源",
    "bookSourceGroup": "分组",
    "bookSourceType": 0,
    "bookUrlPattern": "",
    "header": "",
    "loginUrl": "",
    "searchUrl": "/search?key={{key}}&page={{page}}",
    "exploreUrl": "",
    "enabled": true,
    "enabledExplore": false,
    "weight": 0,
    "ruleSearch": {
        "bookList": "",
        "name": "",
        "author": "",
        "kind": "",
        "wordCount": "",
        "lastChapter": "",
        "intro": "",
        "coverUrl": "",
        "bookUrl": ""
    },
    "ruleExplore": {
        "bookList": "",
        "name": "",
        "author": "",
        "bookUrl": ""
    },
    "ruleBookInfo": {
        "name": "",
        "author": "",
        "kind": "",
        "intro": "",
        "coverUrl": "",
        "tocUrl": ""
    },
    "ruleToc": {
        "chapterList": "",
        "chapterName": "",
        "chapterUrl": "",
        "nextTocUrl": ""
    },
    "ruleContent": {
        "content": "",
        "nextContentUrl": "",
        "sourceRegex": "",
        "webJs": ""
    }
}

基于 Apache-2.0 许可发布