# 源规则帮助 * [书源帮助文档](https://alanskycn.gitee.io/teachme/Rule/source.html) * [订阅源帮助文档](https://alanskycn.gitee.io/teachme/Rule/rss.html) * 辅助键盘❓中可插入URL参数模板,打开帮助,js教程,正则教程,选择文件 * 规则标志, {{......}}内使用规则必须有明显的规则标志,没有规则标志当作js执行 ``` @@ 默认规则,直接写时可以省略@@ @XPath: xpath规则,直接写时以//开头可省略@XPath @Json: json规则,直接写时以$.开头可省略@Json : regex规则,不可省略,只可以用在书籍列表和目录列表 ``` * 并发率 > 并发限制,单位ms,可填写两种格式 > `1000` 访问间隔1s > `20/60000` 60s内访问次数20 * 书源类型: 文件 > 对于类似知轩藏书提供文件整合下载的网站,可以在书源详情的下载URL规则获取文件链接,支持多个链接,阅读会自动下载并导入 * 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()" } ] ``` * 登录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? 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代理设置 ``` 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)` * `java.post(urlStr: String, body: String, headers: Map)` * 对于搜索重定向的源,可以使用此方法获得重定向后的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;"} }; '' ``` * 字体解析使用 > 使用方法,在正文替换规则中使用,原理根据f1字体的字形数据到f2中查找字形对应的编码 ``` (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; })() ``` * 购买操作 > 可直接填写链接或者JavaScript,如果执行结果是网络链接将会自动打开浏览器 * 图片解密 > 适用于图片需要二次解密的情况,直接填写JavaScript,返回解密后的`ByteArray` > 部分变量说明:java(仅支持[js扩展类](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/help/JsExtensions.kt)),result为待解密图片的`ByteArray`,src为图片链接 * 封面解密 > 同图片解密 其中result为待解密封面的`inputStream`