浏览规则仓库
社区维护的规则集合，点一下装一条，带版本号与有效性标记。最省事的方式，也是首次启动引导页默认提供的入口。
推荐
Rules
规则入门
装完 Kazumi 打开发现一片空白，不是坏了。它不内置任何番剧源，内容全靠规则接进来。这篇讲清楚规则从哪来、怎么装、失效了怎么判断——看完再去写自己的规则。
What a rule does
一条规则只干两件事
它不负责播放，也不负责找视频地址——那是程序内部的事。规则只把 Kazumi 带到「最终播放页面」这个门口。
FUNCTION 01
搜索
拿到关键词，返回作品列表：每部作品的名称，以及进入下一步所需的页面地址或内部 ID。
FUNCTION 02
选集
拿到被选中的作品，返回播放线路与剧集页面。剩下的视频嗅探由 Kazumi 完成。
想自己动手写？XPath 规则开发 →
Five ways in
获取规则的五种方式
入口在「我的 → 规则管理 → 添加规则」。新手只用第一种就够了，其余的在特定场景下才派得上用场。
从剪贴板导入
别人分享的一串 kazumi:// 链接，复制后粘进来即可。支持一次粘多条，或者直接粘 JSON。
社交场景
从文件导入
选本地 .json 文件，单条或批量都行。换设备、重装系统时用这个把规则整包带走。
备份迁移
批量导入
JSON 数组或包含多条链接的文本，一次性全部装进来。装完记得清理失效的，规则堆太多会拖慢搜索。
一次装很多
从模板新建
想接一个仓库里没有的站点，就从模板开始改。字段不多，五个选择器填对就能跑。
规则仓库镜像
仓库托管在 GitHub，大陆网络可能连不上。在「网络设置」里打开「规则仓库镜像」就能正常浏览与更新。
大陆必看
规则仓库不是一个网站，是 GitHub 上的一个文件夹
软件先读里面的清单，再按名字取某一条规则的文件——所以「装上」「更新」「导入」「镜像」这几件事，其实都绕着这两次请求转。规则仓库怎么运作 →
Two engines
XPath 与 API，区别在哪
规则的搜索与选集可以分别选解析类型，两种类型也能混搭。判断依据很简单：目标站点是直接返回带内容的 HTML，还是靠接口拿数据。
| XPath 规则 | API 规则 | |
|---|---|---|
| 工作方式 | 请求网页 HTML，用 XPath 选择器提取结果、线路与剧集 | 直接请求 JSON 接口，用受限 JSONPath 提取字段 |
| 适合的站点 | 服务端直接吐出完整 HTML 的传统站点 | 前后端分离、数据由接口加载的站点 |
| 需要的基础 | 看懂 HTML 结构，会写 //div[...] | 会看接口返回的 JSON 结构 |
| 语法限制 | 选择器需以 // 开头；子字段写相对于父字段的路径 | 必须是 $ 开头；不支持递归 ..、过滤 [?(...)]、切片 |
| 常见组合 | 纯 XPath：搜索与选集都解析网页 | API 搜索 + XPath 选集：搜索返回裸 ID，用详情页模板拼出 URL 再解析 |
分享出去的链接长什么样形如 kazumi://…，本质是规则的编码形式。收到链接的人不需要任何工具，复制到 Kazumi 的添加规则页就能装。
规则更新会自动提示仓库里的规则有版本号，源站改版后作者更新规则，你在规则管理里会看到「可更新」，点一下升级即可。
规则挂了，不一定是你的错。
源站改版、域名更换、接口加签，都会让一条昨天还能用的规则今天失灵。下面四种情况，帮你快速分清该换源、该更新，还是该改选择器。
规则失效时，怎么判断是谁的问题
规则显示「搜索有效」，但搜不到某部番
大概率是那个源本身就没有这部作品，不是规则坏了。换个关键词（日文原名、罗马音、英文名）再试，或者换一个源搜。
规则状态变成「搜索无效」
源站改版了，或者域名换了。先试着更新规则（仓库里作者可能已经修好）；没有更新就只能等，或者自己改选择器。
搜到了，点进去选集是空的
所有规则同时失效了
如果全部规则一起挂，先怀疑网络或应用版本，而不是规则。检查规则仓库镜像是否可访问、代理是否影响请求，再确认是不是刚升级了系统导致网络权限被重置。
Go deeper
仓库里找不到你要的源？
仓库里找不到你要的源？
那就自己写一条。
五个字段、五行选择器，看懂 HTML 结构就能上手。写完之后还能导出链接分享给别人。