kzkazumiRULE-BASED PLAYER
获取安装包 →
多源聚合 · 规则可编辑

规则在手,
片源就不必等别人更新

大多数追番工具把源写死在代码里,源挂了只能等新版本。kazumi 把这件事交给你:一条 JSON 描述一个站点,导入后立即生效,多个源还能拼成同一个播放列表。

// 同时也提供 Windows / macOS / Linux 桌面端,规则文件三端通用

rules/new-source.json
// 一条规则 = 一个站点
{
  "name": "示例源 A",
  "baseUrl": "https://example.org",
  "search": "/search?q={kw}",
  "list": ".video-list a",
  "detail": {
    "episode": ".play-list li",
    "player": "#player iframe"
  },
  "headers": {
    "Referer": "{baseUrl}/"
  },
  "timeout": 8000
}
导入方式:设置 → 规则管理 → 粘贴或读取文件生效无需重启
3 端规则文件通用
∞可接入源数量
0.6s规则热加载
MIT开源协议
PIPELINE

一次播放,经过了什么

透明,可调试

① 载入规则 load

读取你导入的 JSON,校验字段完整性。任何一条选择器写错,都会在列表里标红并指出出错的行,而不是静默失败。

② 抓取列表 fetch

按规则里的 search 模板替换关键词,拿到 HTML 后用 CSS 选择器抽出条目,统一成「标题 / 封面 / 集数」结构。

③ 合并多源 merge

同名剧集按标题相似度合并,集数取并集。哪一源缺第 7 集,列表会自动从另一源补齐,播放时也可手动切换。

④ 解析播放地址 resolve

支持直链、iframe 与 m3u8 三种形态。遇到加密片源会尝试用规则里声明的解密参数处理,失败则回退到下一源。

⑤ 记忆进度 store

播放位置按「剧集 + 集数」写入本地,换源后依然能续上。进度只存在设备内,不上传任何服务器。

CAPABILITY

几个不太常见的能力

01规则调试器

内置选择器测试面板,输入 URL 与表达式即可看到匹配到的节点数量,改规则不用来回切浏览器。

节点高亮错误定位请求日志

02弹幕轨道独立加载

弹幕与画面解耦,换源后弹幕不丢,时间轴偏移可在播放器里直接拖动对齐。

时间轴校准按集归档可导出

03离线规则包

把多个源打包成一个 .kz 文件分享给朋友,对方导入即用,不必逐个粘贴。

一键导出校验签名版本对比

04桌面端同源

Windows / macOS / Linux 与移动端共用一套规则与进度文件,电脑上看到一半,手机可以接着看。

规则通用进度同步快捷键
SCREENS

客户端界面

移动端实拍
kazumi 热门番组首页
首页热门番组
kazumi 番剧时间表
时间表按星期
kazumi 追番列表
追番我的列表
kazumi 播放器界面
播放多源切换
kazumi 规则设置页
设置规则管理
CHANGELOG

版本更新记录

按提交顺序
v2.7.1

规则调试器加入请求头编辑;修复 m3u8 片源在部分机型上首帧黑屏。

v2.6.4

多源合并改为按集数取并集,缺集自动补源;弹幕时间轴支持 0.05 秒微调。

v2.5.0

新增离线规则包导出与导入;桌面端与移动端进度文件格式统一。

v2.3.8

规则热加载耗时从 2.4 秒降到 0.6 秒;修复批量导入时重复条目问题。

v2.1.0

重构解析器,支持 CSS 选择器与 XPath 两种写法;错误提示精确到字段名。

v1.8.6

首个提供桌面端的版本;播放器加入逐帧与倍速记忆。

FAQ

常见问题

不会写规则也能用吗?
可以。安装包内附一份公共规则包,导入后即可直接搜索播放;想接入新站点时再学写规则,字段只有六七个,照着示例改半小时就能上手。
规则失效了怎么办?
站点改版后选择器往往需要调整。打开规则调试器,先看列表选择器是否还能匹配到节点,再逐层排查详情与播放地址,多数情况改一行就好。
几个源的内容能混着看吗?
可以。同一个剧集合并后会显示「可用源:4」,播放时可在播放器内切换;某一源缺集时会自动跳到有该集的源,时间轴保持连续。
为什么安装包比同类应用大?
内置了完整的 WebView 内核与解析器,避免依赖系统组件导致不同机型行为不一致。桌面端为 60MB 左右,含三套渲染后端。
iOS 版本有什么限制?
受分发方式限制,iOS 版以描述文件安装,首次启动需在系统设置中信任。功能与安卓版一致,差别仅在后台保活策略。

源会变,规则不会过时

kazumi v2.7.1 · Android / iOS / Windows / macOS / Linux