Kazumi 中文文档 下载 App

规则是什么:五行选择器决定一个片源

规则是这款应用的灵魂概念:一小段描述文本,告诉应用去哪个网站搜索番剧、怎么从搜索结果里定位条目。官方的说法很精辟——使用最多五行基于 XPath 语法的选择器构建自己的规则。

规则只管两段路

一条规则负责的路段其实很短:

  1. 检索:拿你的关键词拼出搜索地址,请求网站,从返回的 HTML 里框出「结果列表」和每条结果的「名字」「详情链接」;
  2. 选集:进入某部番的页面后,框出「播放线路」和每条线路下的「剧集列表」。

从剧集页面到真实视频流的最后一公里不需要规则操心——应用会在后台用 WebView 自动嗅探视频地址。这就是为什么官方文档反复强调:你只需要帮应用找到「最终播放页面」。

规则长什么样

规则编辑器里主要有九个字段:规则名、版本号、网站地址、搜索地址(含关键词占位符),以及五条 XPath——搜索列表、结果名称、结果链接、线路列表、剧集链接。每个字段的具体填法在动手写规则一组里逐个拆解。

除了传统的 XPath 网页规则,新版还支持直接对接 JSON 接口的 API 规则,两种类型可以在检索和选集两段路上自由混搭,详见API 规则页。

规则的三个来源

  1. 应用自带:装好就有的三条内置规则,见下一页;
  2. 社区仓库:官方在 GitHub 维护的公共规则仓库,应用内可以一键导入,见仓库添加页;
  3. 自己写:五行选择器起步,参照示例规则改,见规则编辑器总览。

理解了「规则只管找页面、嗅探自动拿视频流」这个分工,很多排错思路会清晰起来——比如搜得到列表但播放黑屏,问题多半不在规则的选集字段,而在嗅探环节。