ruleHelp.md 4.7 KB

源规则帮助

  • 书源帮助文档
  • 订阅源帮助文档
  • 辅助键盘❓中可插入URL参数模板,打开帮助,js教程,正则教程,选择文件
  • 规则标志, {{......}}内使用规则必须有明显的规则标志,没有规则标志当作js执行

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

    对于类似知轩藏书提供文件整合下载的网站,可以'在书源详情的下载URL规则获取文件链接,支持多个链接,阅读会自动下载并导入

  • CookieJar

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

  • 登录UI

    不使用内置webView登录网站,需要使用登录URL规则实现登录逻辑,可使用登录检查JS检查登录结果

    规则填写示范
    [
    {
        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"
    }
    ]
    成功登录后在js中获取读取登录信息
    source.getLoginInfo()
    source.getLoginInfoMap().get("telephone")
    登录信息示范
    {
    "telephone":"123456",
    "password":"123456"
    }
    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格式

    [
    {
    "title": "xxx",
    "url": "",
    "style": {
      "layout_flexGrow": 0,
      "layout_flexShrink": 1,
      "layout_alignSelf": "auto",
      "layout_flexBasisPercent": -1,
      "layout_wrapBefore": false
    }
    }
    ]
    
  • 请求头,支持http代理,socks4 socks5代理设置

    socks5代理
    {
    "proxy":"socks5://127.0.0.1:1080"
    }
    http代理
    {
    "proxy":"http://127.0.0.1:1080"
    }
    支持代理服务器验证
    {
    "proxy":"socks5://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 java.put('surl',String(java.connect(url).raw().request().url()));
    } else {
    return java.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+java.put('surl',java.post(url,body,{}).header("Location"));
    } else {
    return base+java.get('surl')+'&page='+(page-1);
    }
    })()
    
  • 图片链接支持修改headers

    let options = {
    "headers": {"User-Agent": "xxxx","Referrer":baseUrl,"Cookie":"aaa=vbbb;"}
    };
    '<img src="'+src+","+JSON.stringify(options)+'">'
    
  • 字体解析使用

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

    <js>
    (function(){
    var b64=String(src).match(/ttf;base64,([^\)]+)/);
    if(b64){
    var f1 = java.queryBase64TTF(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 result;
    })()
    </js>
    
  • 购买操作

    可直接填写链接或者JavaScript,如果执行结果是字符串链接将会自动打开浏览器