ContextQMD
Back to Legado

源规则帮助

app/src/main/assets/web/help/md/ruleHelp.md

3.257.9 KB
Original Source

源规则帮助

@@ 默认规则,直接写时可以省略@@
@XPath: xpath规则,直接写时以//开头可省略@XPath
@Json: json规则,直接写时以$.开头可省略@Json
: regex规则,不可省略,只可以用在书籍列表和目录列表
  • jsLib

注入JavaScript到RhinoJs引擎中，支持两种格式，可实现函数共用

JavaScript Code 直接填写JavaScript片段
{"example":"https://www.example.com/js/example.js", ...} 自动复用已经下载的js文件

注意此处定义的函数可能会被多个线程同时调用，在函数里的全局变量内容将会共享使用，对其进行修改可能会出现竞争问题 函数内不可声明全局变量，函数外的全局变量不可再赋值，否则会抛出 无法修改密封对象的属性 异常

  • 并发率

并发限制，单位ms，可填写两种格式

1000 访问间隔1s
20/60000 60s内访问次数20

  • 书源类型: 文件

对于类似知轩藏书提供文件整合下载的网站，可以在书源详情的下载URL规则获取文件链接

通过截取下载链接或文件响应头头获取文件信息，获取失败会自动拼接书名 作者和下载链接的UrlOption的type字段

压缩文件解压缓存会在下次启动后自动清理，不会占用额外空间

  • CookieJar

启用后会自动保存每次返回头中的Set-Cookie中的值，适用于验证码图片一类需要session的网站

  • 登录UI

不使用内置webView登录网站，需要使用登录URL规则实现登录逻辑，可使用登录检查JS检查登录结果
版本20221113重要更改：按钮支持调用登录URL规则里面的函数，必须实现login函数

规则填写示范
[
    {
        "name": "telephone",
        "type": "text"
    },
    {
        "name": "password",
        "type": "password"
    },
    {
        "name": "注册",
        "type": "button",
        "action": "http://www.yooike.com/xiaoshuo/#/register?title=%E6%B3%A8%E5%86%8C"
    },
    {
        "name": "获取验证码",
        "type": "button",
        "action": "getVerificationCode()",
        "style": {
            "layout_flexGrow": 0,
            "layout_flexShrink": 1,
            "layout_alignSelf": "auto",
            "layout_flexBasisPercent": -1,
            "layout_wrapBefore": false
        }
    }
]
  • 登录URL

可填写登录链接或者实现登录UI的登录逻辑的JavaScript

示范填写
function login() {
    java.log("模拟登录请求");
    java.log(source.getLoginInfoMap());
}
function getVerificationCode() {
    java.log("登录UI按钮：获取到手机号码"+result.get("telephone"))
}

登录按钮函数获取登录信息
result.get("telephone")
login函数获取登录信息
source.getLoginInfo()
source.getLoginInfoMap().get("telephone")
source登录相关方法,可在js内通过source.调用,可以参考阿里云语音登录
login()
getHeaderMap(hasLoginHeader: Boolean = false)
getLoginHeader(): String?
getLoginHeaderMap(): Map<String, String>?
putLoginHeader(header: String)
removeLoginHeader()
setVariable(variable: String?)
getVariable(): String?
AnalyzeUrl相关函数,js中通过java.调用
initUrl() //重新解析url,可以用于登录检测js登录后重新解析url重新访问
getHeaderMap().putAll(source.getHeaderMap(true)) //重新设置登录头
getStrResponse( jsStr: String? = null, sourceRegex: String? = null) //返回访问结果,文本类型,书源内部重新登录后可调用此方法重新返回结果
getResponse(): Response //返回访问结果,网络朗读引擎采用的是这个,调用登录后在调用这方法可以重新访问,参考阿里云登录检测
  • 发现url格式
json
[
  {
    "title": "xxx",
    "url": "",
    "style": {
      "layout_flexGrow": 0,
      "layout_flexShrink": 1,
      "layout_alignSelf": "auto",
      "layout_flexBasisPercent": -1,
      "layout_wrapBefore": false
    }
  }
]
  • 请求头,支持http代理,socks4 socks5代理设置

注意请求头的key是区分大小写的
正确格式 User-Agent Referer
错误格式 user-agent referer

socks5代理
{
  "proxy":"socks5://127.0.0.1:1080"
}
不支持需要验证的socks代理
http代理
{
  "proxy":"http://127.0.0.1:1080"
}
支持http代理服务器验证
{
  "proxy":"http://127.0.0.1:1080@用户名@密码"
}
注意:这些请求头是无意义的,会被忽略掉
  • url添加js参数,解析url时执行,可在访问url时处理url,例
https://www.baidu.com,{"js":"java.headerMap.put('xxx', 'yyy')"}
https://www.baidu.com,{"js":"java.url=java.url+'yyyy'"}
  • 增加js方法，用于重定向拦截
    • java.get(urlStr: String, headers: Map<String, String>)
    • java.post(urlStr: String, body: String, headers: Map<String, String>)
  • 对于搜索重定向的源，可以使用此方法获得重定向后的url
(()=>{
  if(page==1){
    let url='https://www.yooread.net/e/search/index.php,'+JSON.stringify({
    "method":"POST",
    "body":"show=title&tempid=1&keyboard="+key
    });
    return source.put('surl',String(java.connect(url).raw().request().url()));
  } else {
    return source.get('surl')+'&page='+(page-1)
  }
})()
或者
(()=>{
  let base='https://www.yooread.net/e/search/';
  if(page==1){
    let url=base+'index.php';
    let body='show=title&tempid=1&keyboard='+key;
    return base+source.put('surl',java.post(url,body,{}).header("Location"));
  } else {
    return base+source.get('surl')+'&page='+(page-1);
  }
})()
  • 图片链接支持修改headers
let options = {
"headers": {"User-Agent": "xxxx","Referrer":baseUrl,"Cookie":"aaa=vbbb;"}
};
''
  • 字体解析使用

使用方法,在正文替换规则中使用,原理根据f1字体的字形数据到f2中查找字形对应的编码

<js>
(function(){
  var b64=String(src).match(/ttf;base64,([^\)]+)/);
  if(b64){
    var f1 = java.queryTTF(b64[1]);
    var f2 = java.queryTTF("https://alanskycn.gitee.io/teachme/assets/font/Source Han Sans CN Regular.ttf");
    // return java.replaceFont(result, f1, f2);
    return java.replaceFont(result, f1, f2, true); // 过滤掉f1中不存在的字形
  }
  return result;
})()
</js>
  • 购买操作

可直接填写链接或者JavaScript，如果执行结果是网络链接将会自动打开浏览器,js返回true自动刷新目录和当前章节

  • 图片解密

适用于图片需要二次解密的情况，直接填写JavaScript，返回解密后的ByteArray
部分变量说明：java（仅支持js扩展类），result为待解密图片的ByteArray，src为图片链接

js
java.createSymmetricCrypto("AES/CBC/PKCS5Padding", key, iv).decrypt(result)
js
function decodeImage(data, key) {
  var input = new Packages.java.io.ByteArrayInputStream(data)
  var out = new Packages.java.io.ByteArrayOutputStream()
  var byte
  while ((byte = input.read()) != -1) {
    out.write(byte ^ key)
  }
  return out.toByteArray()
}

decodeImage(result, key)
  • 封面解密

同图片解密 其中result为待解密封面的inputStream

js
java.createSymmetricCrypto("AES/CBC/PKCS5Padding", key, iv).decrypt(result)
js
function decodeImage(data, key) {
  var out = new Packages.java.io.ByteArrayOutputStream()
  var byte
  while ((byte = data.read()) != -1) {
    out.write(byte ^ key)
  }
  return out.toByteArray()
}

decodeImage(result, key)