Legado书源规则说明
更新时间：2020-03-06
概况
- 1、语法说明
- 2、Legado的特殊规则
- 3、书源之「基本」
- 4、书源之「搜索」
- 5、书源之「发现」
- 6、书源之「详情页」
- 7、书源之「目录」
- 8、书源之「正文」
- 9、补充说明
1、语法说明
-
JSOUP之Default
- 语法如下：
@为分隔符,用来分隔获取规则 每段规则可分为3段 第一段是类型,如class,id,tag,text,children等, children获取所有子标签,不需要第二段和第三段,text可以根据文本内容获取 第二段是名称,text. 第二段为文本内容的一部分 第三段是位置,class,tag,id等会获取到多个,所以要加位置 如不加位置会获取所有 位置正着数从0开始,0是第一个,如为负数则是取倒着数的值,-1为倒数第一个,-2为倒数第二个 !是排除,有些位置不符合需要排除用!,后面的序号用:隔开0是第1个,负数为倒数序号,-1最后一个,-2倒数第2个,依次 获取列表的最前面加上负号- 可以使列表倒置,有些网站目录列表是倒的,前面加个负号可变为正的 @的最后一段为获取内容,如text,textNodes,ownText,href,src,html,all等 如需要正则替换在最后加上 ##正则表达式##替换内容，替换内容为空时，第二个##可以省略 例:class.odd.0@tag.a.0@text||tag.dd.0@tag.h1@text##全文阅读 例:class.odd.0@tag.a.0@text&&tag.dd.0@tag.h1@text##全文阅读- 标准规范与实现库 Package org.jsoup.select, CSS-like element selector
-
JSOUP之CSS
- 语法见http://www.open-open.com/jsoup/selector-syntax.htm
- 必须以
@css:开头 - 标准规范与实现库 Package org.jsoup.select, CSS-like element selector
- 在线测试 Try jsoup online: Java HTML parser and CSS debugger
-
注意：获取内容可用text,textNodes,ownText,html,all,href,src等
-
例子见最后的【书源一】的搜索页和正文页规则
-
JSONPath
- 语法见 JsonPath教程
- 最好以
@json:或$.开头，其他形式不可靠 - 标准规范 goessner JSONPath - XPath for JSON
- 实现库 json-path/JsonPath
- 在线测试 Jayway JsonPath Evaluator
-
例子见最后的【书源三】的搜索页、目录页和正文页规则
-
XPath
- 语法见 XPath教程、XPath库的说明
- 必须以
@XPath:或//开头 - 标准规范 W3C XPATH 1.0
- 实现库 hegexiaohuozi/JsoupXpath
-
例子见最后的【书源二】的搜索页、详情页和正文页规则，以及目录页的下一页规则
-
JavaScript
- 可以在
@js:中使用，结果存在result中 @js:只能放在其他规则的最后使用tag.li//a - 在搜索列表、发现列表和目录中使用可以用
+开头，使用AllInOne规则
- 可以在
-
正则之AllInOne
-
只能在搜索列表、发现列表、详情页预加载和目录列表中使用
-
必须以
:开头 -
教程 veedrin/horseshoe 2018-10 | Regex专题
语法 方法 引擎
-
例子见最后的【书源一】的目录页规则，最前面的
-表示目录倒序，以及【书源二】的目录页规则
-
-
正则之OnlyOne
- 形式
##正则表达式##替换内容### - 只能在搜索列表、发现列表、详情页预加载、目录列表之外使用
- 例子见最后的【书源一】的详情页规则
- 形式
-
注意点：该规则只能获取第一个匹配到的结果并进行替换
-
正则之净化
- 形式
##正则表达式##替换内容 - 只能跟在其他规则后面，独立使用相当于
all##正则表达式##替换内容 - 例子见最后的【书源一】的正文页规则
- 形式
-
注意点：该规则为循环匹配替换
-
自定义三种连接符号
-
符号：
&&、||、%% -
只能在同种规则间使用，不包括js和正则
-
&&会合并所有取到的值, -
||会以第一个取到值的为准 -
%%会依次取数，如三个列表，先取列表1的第一个，再取列表2的第一个，再取列表3的第一个，
再取列表1的第二个，再取列表2的第二个…
-
2、Legado的特殊规则
-
URL必知必会
- 请求头
-
一般形式，如下所示
{ "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36", "Accept-Language":"zh-CN,zh;q=0.9" } -
复杂情况可使用js
(()=>{ var ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36"; var headers = {"User-Agent": ua}; return JSON.stringify(headers); })() ※其中，
ua必须保证是JavaScript的String类型，JSON.stringify()才能将header转换为字符串。
- GET请求
-
一般形式如下，charset为utf-8时可省略，无特殊情况不需要请求头和webView，参数webView非空时采用webView加载
https://www.baidu.com,{ "charset": "gbk", "headers": "{\"User-Agent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36\"}", "webView": true } -
复杂情况可使用js
var ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36"; var headers = {"User-Agent": ua}; var option = { "charset": "gbk", "headers": JSON.stringify(headers), "webView": true }; "https://www.baidu.com," + JSON.stringify(option) ※其中，
ua必须保证是JavaScript的String类型，JSON.stringify()才能将header转换为字符串。
- POST请求
-
一般形式如下，body是请求体，charset为utf-8时可省略，无特殊情况不需要请求头和webView，参数webView非空时采用webView加载
https://www.baidu.com,{ "charset": "gbk", "method": "POST", "body": "bid=10086", "headers": "{\"User-Agent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36\"}", "webView": true } -
复杂情况可使用js
var ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36"; var headers = {"User-Agent": ua}; var body = "bid="+"10086"; var option = { "charset": "gbk", "method": "POST", "body": String(body), "headers": JSON.stringify(headers), "webView": true }; "https://www.baidu.com," + JSON.stringify(option) ※其中，
ua和body必须保证是JavaScript的String类型，JSON.stringify()才能转换字符串成功。变量是计算得到的尽量都用String()强转一下类型。
-
变量的put与get
-
@put与@get只能用于js以外的规则中，@put里使用JSONPath不需要加引号，其他规则需要加引号，
例：@put:{bid:"//*[@bid-data]/@bid-data"}
-
java.put与java.get只能用于js中，在js中无法使用@get
-
-
{{}}与{}规则-
在搜索URL与发现URL中的
{{}}在{{}}里只能使用js
-
在搜索URL与发现URL以外的
{{}}可在
{{}}中使用任意规则（正则除外？），默认为js，使用其他规则需要有明显的标志头，如：Default规则需要以
@@开头，XPath需要以@xpath:或//开头，JSONPath需要以@json:或$.开头，CSS需要以@css:开头 -
{}规则留用了阅读2.0的规则，只能使用JSONPath，尽量避免使用
-
-
自定义js方法
//当前页的responseBody result //当前页的URL baseUrl //输入urlStr获取网页内容，返回类型String? java.ajax(urlStr: String) //格式化时间戳，返回类型String java.timeFormat(timestamp: Long) //base64解码，返回类型String java.base64Decode(str: String) //java.base64Decode(str: String, flags: Int) //未启用 //base64编码，返回类型String? java.base64Encode(str: String) java.base64Encode(str: String, flags: Int) //md5编码，返回类型String? java.md5Encode(str: String) java.md5Encode16(str: String) /**************以下部分方法由于JAVA不支持参数默认值，调用时不能省略***************/ //设置需解析的内容content和baseUrl，返回类型AnalyzeRule java.setContent(content: Any?, baseUrl: String? = this.baseUrl) //输入规则rule和URL标志isUrl获取文本列表，返回类型List? java.getStringList(rule: String, isUrl: Boolean = false) //输入规则rule和URL标志isUrl获取文本，返回类型String java.getString(ruleStr: String?, isUrl: Boolean = false) //输入规则ruleStr获取节点列表，返回类型List java.getElements(ruleStr: String)
3、书源之「基本」
-
书源URL(bookSourceUrl)
- 必填
- 唯一标识，不可重复
- 与其他源相同会覆盖
-
书源名称(bookSourceName)
- 必填
- 名字可重复
-
书源分组(bookSourceGroup)
-
可不填
-
用于整理源
-
登录URL(loginUrl)
-
可不填
-
用于登录个人账户
-
-
书籍URL正则(bookUrlPattern)
-
可不填
-
添加网址时，用于识别书源
-
例:https?://www.piaotian.com/bookinfo/.*
-
-
请求头(header)
- 可不填
- 访问网址时使用
4、书源之「搜索」
-
搜索地址(url)
-
key为关键字标识，通常形态为{{key}}，运行时会替换为搜索关键字也可以对key进行加密等操作，如：
{{java.base64Encode(key)}} -
page为关键字标识，通常形态为{{page}}，page的初值为1也可以对page进行计算，如：
{{(page-1)*20}}，有时会遇到第一页没有页数的情况，有两种方法：①
{{page - 1 == 0 ? "": page}}②
<,{{page}}> -
支持相对URL
-
-
书籍列表规则(bookList)
-
书名规则(name)
-
作者规则(author)
-
分类规则(kind)
-
字数规则(wordCount)
-
最新章节规则(lastChapter)
-
简介规则(intro)
-
封面规则(coverUrl)
-
详情页url规则(bookUrl)
5、书源之「发现」
-
发现地址规则(url)
-
page为关键字标识，通常形态为{{page}}，page的初值为1，也可以对page进行计算，如：
{{(page-1)*20}}，有时会遇到第一页没有页数的情况，有两种方法：①
{{page - 1 == 0 ? "": page}}②
<,{{page}}> -
发现URL可使用
&&或换行符隔开 -
支持相对URL
-
-
书籍列表规则(bookList)
-
书名规则(name)
-
作者规则(author)
-
分类规则(kind)
-
字数规则(wordCount)
-
最新章节规则(lastChapter)
-
简介规则(intro)
-
封面规则(coverUrl)
-
详情页url规则(bookUrl)
6、书源之「详情」
-
预处理规则(bookInfoInit)
-
只能使用正则之AllInOne或者js
-
正则之AllInOne必须以
:开头 -
js的返回值需要是json对象，例：
(function(){ return { a:"圣墟", b:"辰东", c:"玄幻", d:"200万字", e:"第两千章 辰东肾虚", f:"在破败中崛起，在寂灭中复苏。沧海成尘，雷电枯竭...", g:"https://bookcover.yuewen.com/qdbimg/349573/1004608738/300 ", h:"https://m.qidian.com/book/1004608738" }; })() 此时，书名规则填
a，作者规则填b，分类规则填c，字数规则填d，最新章节规则填e，简介规则f，封面规则填g，目录URL规则填h -
-
书名规则(name)
-
作者规则(author)
-
分类规则(kind)
-
字数规则(wordCount)
-
最新章节规则(lastChapter)
-
简介规则(intro)
-
封面规则(coverUrl)
-
目录URL规则(tocUrl)
7、书源之「目录」
-
目录列表规则(chapterList)
- 首字符使用负号(
-)可使列表反序
- 首字符使用负号(
-
章节名称规则(ruleChapterName)
-
章节URL规则(chapterUrl)
-
VIP标识(isVip)
- 当结果为
nullfalse0""时为非VIP
- 当结果为
-
章节信息(ChapterInfo)
- 可调用java.timeFormat(timestamp: Long)将时间戳转为yyyy/MM/dd HH:mm格式的时间
-
目录下一页规则(nextTocUrl)
- 可返回list或者string
- js中返回
[]或null或""时停止加载下一页
8、书源之「正文」
-
正文规则(content)
- 如下示例，在详情页(目录页)和正文使用webView加载，例：
{ "bookSourceName": "猫耳FM", "bookSourceType": 1, "bookSourceUrl": "https://www.missevan.com", "customOrder": 0, "enabled": false, "enabledExplore": false, "lastUpdateTime": 0, "ruleBookInfo": "{}", "ruleContent": "{\n \"content\": \"https://static.missevan.com/{{//*[contains(@class,\\\"pld-sound-active\\\")]/@data-soundurl64}}\",\n \"sourceRegex\": \"\",\n \"webJs\": \"\"\n}", "ruleExplore": "{}", "ruleSearch": "{\n \"author\": \"author\",\n \"bookList\": \"$.info.Datas\",\n \"bookUrl\": \"https://www.missevan.com/mdrama/drama/{{$.id}},{\\\"webView\\\":true}\",\n \"coverUrl\": \"cover \",\n \"intro\": \"abstract\",\n \"kind\": \"{{$.type_name}},{{$.catalog_name}}\",\n \"lastChapter\": \"newest \",\n \"name\": \"name\",\n \"wordCount\": \"catalog_name \"\n}", "ruleToc": "{\n \"chapterList\": \"@css:.scroll-list.btn-groups>a\",\n \"chapterName\": \"text\",\n \"chapterUrl\": \"href##$##,{\\\"webView\\\":true}\"\n}", "searchUrl": "https://www.missevan.com/dramaapi/search?s={{key}}&page=1", "weight": 0 } -
正文下一页URL规则(nextContentUrl)
-
webJs
- 用于模拟鼠标点击
-
资源正则(sourceRegex)
-
用于嗅探
-
一般情况下的无脑教程如下＿φ( °-°)/
-
章节链接后面加
,{"webView":true}٩(๑❛ᴗ❛๑)۶，不要洒敷敷的写成tag.a@href,{"webView":true}或$.link,{"webView":true} -
在有嗅探功能的浏览器（如：via、x浏览器等）中，输入章节链接。注意(｡•́︿•̀｡)
千万别带,{"webView":true}(╯﹏╰)b -
媒体开始播放后使用浏览器的嗅探功能，查看资源的链接
-
在资源正则里填写资源链接的正则，一般写
.*\.(mp3|mp4).*这个就可以了 -
最后在正文填写
result -
如下示例，在正文嗅探mp3和mp4的资源：
{ "bookSourceName": "猫耳FM", "bookSourceType": 1, "bookSourceUrl": "https://www.missevan.com", "customOrder": 0, "enabled": false, "enabledExplore": false, "lastUpdateTime": 0, "ruleBookInfo": "{}", "ruleContent": "{\n \"content\": \"result \",\n \"sourceRegex\": \".*\\\\.(mp3|mp4)\",\n \"webJs\": \"\"\n}", "ruleExplore": "{}", "ruleSearch": "{\n \"author\": \"author\",\n \"bookList\": \"$.info.Datas\",\n \"bookUrl\": \"https://www.missevan.com/mdrama/drama/{{$.id}},{\\\"webView\\\":true}\",\n \"coverUrl\": \"cover \",\n \"intro\": \"abstract\",\n \"kind\": \"{{$.type_name}},{{$.catalog_name}}\",\n \"lastChapter\": \"newest \",\n \"name\": \"name\",\n \"wordCount\": \"catalog_name \"\n}", "ruleToc": "{\n \"chapterList\": \"@css:.scroll-list.btn-groups>a\",\n \"chapterName\": \"text\",\n \"chapterUrl\": \"href##$##,{\\\"webView\\\":true}\"\n}", "searchUrl": "https://www.missevan.com/dramaapi/search?s={{key}}&page=1", "weight": 0 } -
9、补充说明
- 显示js的报错信息
(function(result){
try{
// 处理result
// ...
// 当返回结果为字符串时
return result;
// 当返回结果为列表时
return list;
}
catch(e){
// 当返回结果为字符串时
return ""+e;
// 当返回结果为列表时
return [""+e]; //列表对应名称处填""+result 查看
}
})(result);
-
请善用调试功能
-
调试搜索
输入关键字，如：
系统 -
调试发现
输入发现URL，如：
月票榜::https://www.qidian.com/rank/yuepiao?page={{page}} -
调试详情页
输入详情页URL，如：
https://m.qidian.com/book/1015609210 -
调试目录页
输入目录页URL，如：
++https://www.zhaishuyuan.com/read/30394 -
调试正文页
输入正文页URL，如：
--https://www.zhaishuyuan.com/chapter/30394/20940996 -
无脑
{"webView":true}很方便 -
特别注意用
JSON.stringify()方法时，需要保证JSON对象的value都是JavaScript的String类型(在阅读3.0中) -
附：
-
书源一
{ "bookSourceGroup": "CSS; 正则", "bookSourceName": "🔥小说2016", "bookSourceType": 0, "bookSourceUrl": "https://www.xiaoshuo2016.com", "bookUrlPattern": "", "customOrder": 0, "enabled": true, "enabledExplore": false, "exploreUrl": "", "lastUpdateTime": 0, "loginUrl": "", "ruleBookInfo": "{\n \"author\": \"##:author\\\"[^\\\"]+\\\"([^\\\"]*)##$1###\",\n \"coverUrl\": \"##og:image\\\"[^\\\"]+\\\"([^\\\"]*)##$1###\",\n \"intro\": \"##:description\\\"[^\\\"]+\\\"([\\\\w\\\\W]*?)\\\"/##$1###\",\n \"kind\": \"##:category\\\"[^\\\"]+\\\"([^\\\"]*)##$1###\",\n \"lastChapter\": \"##_chapter_name\\\"[^\\\"]+\\\"([^\\\"]*)##$1###\",\n \"name\": \"##:book_name\\\"[^\\\"]+\\\"([^\\\"]*)##$1###\",\n \"tocUrl\": \"\"\n}", "ruleContent": "{\n \"content\": \"@css:.articleDiv p@textNodes##搜索.*手机访问|一秒记住.*|.*阅读下载|\",\n \"nextContentUrl\": \"\"\n}", "ruleExplore": "{}", "ruleSearch": "{\n \"author\": \"@css:p:eq(2)>a@text\",\n \"bookList\": \"@css:li.clearfix\",\n \"bookUrl\": \"@css:.name>a@href\",\n \"coverUrl\": \"@css:img@src\",\n \"intro\": \"@css:.note.clearfix p@text\",\n \"kind\": \"@css:.note_text,p:eq(4)@text\",\n \"lastChapter\": \"@css:p:eq(3)@text\",\n \"name\": \"@css:.name@text\"\n}", "ruleToc": "{\n \"chapterList\": \"-: -
书源二
{ "bookSourceGroup": "XPath; 正则", "bookSourceName": "🔥采墨阁手机版", "bookSourceType": 0, "bookSourceUrl": "https://m.caimoge.com", "bookUrlPattern": "", "customOrder": 0, "enabled": true, "enabledExplore": false, "exploreUrl": "", "lastUpdateTime": 0, "loginUrl": "", "ruleBookInfo": "{\n \"author\": \"//*[@property=\\\"og:novel:author\\\"]/@content\",\n \"coverUrl\": \"//*[@property=\\\"og:image\\\"]/@content\",\n \"intro\": \"//*[@property=\\\"og:description\\\"]/@content\",\n \"kind\": \"//*[@property=\\\"og:novel:category\\\"]/@content\",\n \"lastChapter\": \"//*[@id=\\\"newlist\\\"]//li[1]/a/text()\",\n \"name\": \"//*[@property=\\\"og:novel:book_name\\\"]/@content\",\n \"tocUrl\": \"//a[text()=\\\"阅读\\\"]/@href\"\n}", "ruleContent": "{\n \"content\": \"//*[@id=\\\"content\\\"]\",\n \"nextContentUrl\": \"\"\n}", "ruleExplore": "{}", "ruleSearch": "{\n \"author\": \"//dd[2]/text()\",\n \"bookList\": \"//*[@id=\\\"sitebox\\\"]/dl\",\n \"bookUrl\": \"//dt/a/@href\",\n \"coverUrl\": \"//img/@src\",\n \"kind\": \"//dd[2]/span/text()\",\n \"lastChapter\": \"\",\n \"name\": \"//h3/a/text()\"\n}", "ruleToc": "{\n \"chapterList\": \":href=\\\"(/read[^\\\"]*html)\\\">([^<]*)\",\n \"chapterName\": \"$2\",\n \"chapterUrl\": \"$1\",\n \"nextTocUrl\": \"//*[@id=\\\"pagelist\\\"]/*[position()>1]/@value\"\n}", "searchUrl": "/search.html,{\n \"method\": \"POST\",\n \"body\": \"searchkey={{key}}\"\n}", "weight": 0 } -
书源三
{ "bookSourceGroup": "JSon", "bookSourceName": "猎鹰小说网", "bookSourceType": 0, "bookSourceUrl": "http://api.book.lieying.cn", "customOrder": 0, "enabled": true, "enabledExplore": false, "header": "{\n \"User-Agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36\"\n}", "lastUpdateTime": 0, "ruleBookInfo": "{}", "ruleContent": "{\n \"content\": \"$.chapter.body\"\n}", "ruleExplore": "{}", "ruleSearch": "{\n \"author\": \"$.author\",\n \"bookList\": \"$..books[*]\",\n \"bookUrl\": \"/Book/getChapterListByBookId?bookId={$._id}\",\n \"coverUrl\": \"$.cover\",\n \"intro\": \"$.shortIntro\",\n \"kind\": \"$.minorCate\",\n \"lastChapter\": \"$.lastChapter\",\n \"name\": \"$.title\"\n}", "ruleToc": "{\n \"chapterList\": \"$.chapterInfo.chapters.[*]\",\n \"chapterName\": \"$.title\",\n \"chapterUrl\": \"$.link\"\n}", "searchUrl": "/Book/search?query={{key}}&start={{(page-1)*20}}&limit=40&device_type=android&app_version=165", "weight": 0 }