Kazumi 自定义规则快速上手：用五行 XPath 搭出你的番剧资源库

Kazumi 自定义规则快速上手：用五行 XPath 搭出你的番剧资源库

【免费下载链接】Kazumi基于自定义规则的番剧采集APP，支持流媒体在线观看，支持弹幕，支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi

Kazumi 是一款免费开源（GPL-3.0）的番剧采集 App，核心理念是“你写规则、它抓源”：你用几行 XPath 选择器描述一个视频源站点，它就负责把番剧目录、搜索结果和分集列表拉回来，供你在线观看、挂弹幕、做 Anime4K 实时超分。适合手里有几套可靠资源站、却想把它们统一到一个界面里的人。

画面感很具体：晚上十一点躺在床上，你打开手机里的 Kazumi，点底部“追番”，再点一集，播放直接从昨晚断掉的位置续上；同一套数据在你桌上的电脑里也在跑。

先接视频源：规则怎么导入、怎么写

没有源，整个应用就是空壳，所以第一件事是管理规则。首次启动引导的最后一页恰好就是“添加规则”，你可以直接导入一份现成的规则文件，也可以在编辑器里自己写。

一条规则长得像一份几个字段的 JSON，XPath 模式下你最需要看懂四处：

• baseURL：站点域名
• searchURL：搜索页地址
• searchList：搜索结果页里每张卡片的选取器
• searchName：番剧标题的选取器

官方口径是“最多五行选择器”就能描述完一个源。如果站点直接提供 JSON 接口，还可以改用 API 模式，连 XPath 都不用写。导入之后，列表里每条规则会标出版本号和“搜索有效”状态，有新版时多一个粉色的“可更新”标签，点右上角加号即可新增或编辑。

操作要点：先导入 2-3 条现成规则跑通流程，打开一条看看字段长什么样，再照葫芦画瓢改出你自己的。

接好源之后：按分类刷番、搜番、查时间表

规则生效后，首页立刻变成一个整理好的番库：顶部一排分类标签（日常、原创、校园、搞笑），点哪个，下面的卡片流就换成哪类。右上角的搜索框可以搜任何番，搜索页会记住你的搜索历史；看到一张截图不知道番名时，还可以用基于 trace.moe 接口的以图搜番。按档期追新的人则常去时间表页，那里按周列出更新档期。

点任意一张卡片进详情页，能看到封面、简介、分集列表与播放线路；同一部番有多条线路时可直接切换。

看的时候：怎么切集、开弹幕和超分

播放页带选集面板，任意一集点一下就换过去。弹幕数据来自弹弹play 开放平台，支持时间偏移、简繁转换和屏蔽规则，弹幕开关放在播放控制区。播放器本身还有倍速、截图、DLNA 投屏、交给外部播放器，以及基于 SyncPlay 协议的“一起看”功能。

对清晰度敏感的人，关键开关是 Anime4K 实时超分——它靠 GPU 着色器实时工作，设置页里明确要求启用硬件解码后才会生效。手机上建议停留在效率档；PC 上有独立显卡再上质量档。

装好之后：怎么完成第一次播放

从项目 Releases 页面下载对应平台的安装包（当前版本 2.4.2）：Android 10+、Windows 10+、macOS 10.15+、iOS 13+ 都覆盖，Linux 目前标为实验性。Android 用户也可以走 F-Droid 安装，Linux 用户能在 Flathub 拿到 Flatpak 包，Arch 上有 AUR 条目。

首次打开，引导页会带你过四页：使用约定、更新来源（仅 Android）、访问加速、添加规则。在“添加规则”页从规则商店里挑一条导入即可；如果一条不选直接点“开始使用”，应用会弹一次确认再让你继续。进入主界面后，用右上角搜索框搜一部番、点进详情页、点播放第一集，装、配、用这条链路就走完了。所有数据默认只存在本机；想在手机和电脑之间共用追番列表、观看历史与弹幕屏蔽配置，去设置里填一个 WebDAV 服务器地址开启同步即可；有 Bangumi 账号的话，还可以把收藏和短评同步到那边。

最常踩的坑与解法

• 搜索一片空白：当前版本只对以//开头的 XPath 选择器有完整支持，检查你的 searchList 与 searchName 是否都以//起头。
• 搜得到但播不了：在规则编辑器里关掉“使用内置播放器”，让它回退到 WebView 播放，兼容性会更好；内置播放器能用的时候，仍建议保留它，因为弹幕体验只在内置播放器里。
• 开了超分反而卡：没有高性能独显的设备改选效率档，并优先对低分辨率源用超分，消耗会小很多。
• 播放时内存占用高：播放器为了流畅默认会把大量视频缓存进内存，内存紧张时在播放设置里打开“低内存模式”限制缓存。
• 个别源里有广告：应用自身不插入任何广告，广告来自视频源本身，换源时优先挑无广告的线路。

上手之后，下一步自然是给常去的站点写一条自己的规则：规则编辑器及相关源码在 lib/pages/plugin_editor/，整体目录结构见 static/doc/STRUCTURE.md，写好的规则也欢迎提交到项目的规则仓库，供其他人直接导入。

【免费下载链接】Kazumi基于自定义规则的番剧采集APP，支持流媒体在线观看，支持弹幕，支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi