Kazumi 中文文档 下载 App

规则编辑器九个字段总览:一张地图看懂全流程

规则编辑器界面
规则编辑器界面:基础字段在上,XPath 选择器字段在下,展开高级选项还有更多开关

写规则不难,难的是第一眼看到九个空字段时的手足无措。先建立全局地图,再逐个击破。

九个字段的分工

字段填什么属于哪段路
Name规则名,随意起标识
Version版本号,自用随意,投稿建议 1.0标识
BaseURL目标网站能正常访问的首页地址标识
SearchURL搜索页地址,关键词处用 @keyword 占位检索
SearchListXPath:框住整个搜索结果列表检索
SearchNameXPath:从单条结果里取番剧名检索
SearchResultXPath:从单条结果里取详情页链接检索 → 选集的桥
ChapterRoadsXPath:框住播放页的所有线路选集
ChapterResultXPath:框住线路下的剧集链接选集

前三个是「身份证」,SearchURL 是「出发地址」,五条 XPath 是「导航指令」。每条 XPath 字段的实操写法在本组后续页面逐个展开。

数据流向

SearchURL(带 @keyword)
    ↓ 应用请求搜索页
SearchList 框出结果列表
    ↓ 逐条提取
SearchName(番名)+ SearchResult(详情页链接)
    ↓ 你点选某条结果,应用访问详情页
ChapterRoads 框出线路
    ↓ 逐条线路
ChapterResult 框出剧集
    ↓ 你点某一集,应用嗅探视频流,交给播放器

SearchResult 是承上启下的字段:它的内容决定了 ChapterRoads 和 ChapterResult 面对的是什么页面。 SearchResult 指到详情页,后两个字段就在详情页的 DOM 里找线路;指到播放页,就在播放页里找。字段间这种依赖关系是新手最容易懵的点,专页详解。

两条链路的类型选择

检索和选集两段可以独立选择规则类型:整条链路全用 XPath,全用 API(JSONPath),或者混搭——XPath 搜索配 API 选集也行。初次动手建议从头到尾只用一种类型,跑通整条链路后再考虑混搭。

写之前确认工具:一台电脑(Windows 亦可)、一个能呼出开发者工具的浏览器、装好应用。动线从下一页开始。