Kazumi 番剧聚合使用指南：5 分钟装好并搭好你的追番源
【免费下载链接】Kazumi基于自定义规则的番剧采集APP，支持流媒体在线观看，支持弹幕，支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi
想在多个站点之间来回翻找同一部新番、手机和电脑进度还对不上？Kazumi 是一款基于 Flutter 的开源番剧聚合应用，用自定义规则从各站点采集并在线播放番剧，支持弹幕、实时超分辨率，追番与观看记录还能跨设备同步。
🎯 它解决什么问题
Kazumi 自己不存任何资源，而是靠"规则"工作：规则告诉它去哪个站点搜索、按什么结构解析结果，它把多个站点聚合进同一个搜索框和同一个播放页，元数据、线路状态、分集列表都由它打理，你只管挑一部看。
适合：
- 手机、平板、电脑多处看番，希望进度一致的人
- 会写 XPath、或者至少愿意导入社区分享规则的人
- 在意隐私的人：项目声明不收集用户数据、不带遥测
不适合：想要零配置打开就看的人——必须先装至少一条规则，没有规则无法搜索；以下载高清离线片为主的人——它定位是流媒体采集与在线播放，下载只是辅助。
🚀 从零跑通：安装 → 首启 → 第一次播放
- 安装。Android 10+ 可从 F-Droid 或项目发布页获取 APK；Windows、macOS 为直接安装程序。Linux 用户最省事的方式是 Flathub：
flatpak install flathub io.github.Predidit.Kazumi想从源码构建，先装好 Flutter 开发环境再执行：
git clone https://gitcode.com/gh_mirrors/ka/Kazumi cd Kazumi && flutter pub get && flutter run- 首次运行：引导页共四步——同意使用约定、选择更新来源（应用内更新或交给 F-Droid）、检查访问加速（镜像默认开启，保持即可）、最后在规则商店挑选并安装至少一条规则。跳过规则步骤会在进入应用前被再次提醒。
- 第一次搜索：进入推荐页，点右上角搜索图标输入关键词，搜索会并行打到所有已装规则，结果以封面网格返回。
- 第一次播放：点结果进入详情页，封面下方是一排来源标签，选一个带绿色圆点的源，即可开始播放。
📺 跟着使用流程走
发现：推荐页按日常、原创、校园、搞笑等分类标签组织热门番剧；右上角搜索框支持关键词搜索、筛选面板，还有以图搜番——不知道番名时截一张画面就能识别。
时间表页按季度和星期几分组新番，切到"四"就能看到周四播什么。感兴趣的番点一下心形按钮收藏，它会自动进入追番列表，之后在"追番"页统一查看。
使用：详情页顶部显示番组编号与放送日期，封面下方的来源标签实时标注每条规则的在线状态。点某个标签时，Kazumi 会用番剧名在所有已装源里重新检索并切到该源，一个源挂掉直接换下一个，不用退出重进。
播放页顶部是实时弹幕，底部是选集与评论两个标签页，弹幕数据来自弹弹play开放平台。控制条支持倍速、DLNA 无线投屏、截图与转交外部播放器；不想依赖网络时，把分集加入离线下载即可。
扩展：观看进度会自动写入历史记录，"我的"页能看到观看统计；和朋友约好一起看时，用"一起看"功能按同一进度同步播放。
🔧 把它调成你的样子
整个应用的内容来源由规则控制。"我的 → 规则管理"里能看到每条规则的版本、状态与安装时间：带"可更新"标签说明规则仓库有新版本，一键升级；"搜索有效"表示该源当前可用。
添加规则有三条路：规则商店挑选、导入社区分享的规则文件、在编辑器里手写一条。
规则编辑器填几个字段就能跑通：Name（规则名）、BaseURL（站点根地址）、SearchURL（搜索地址，@keyword会被替换成实际搜索词），再加一串 XPath：SearchList、SearchName、SearchResult、ChapterRoads 分别定位结果列表、标题、详情页与分集列表。注意目前只支持以//开头的选择器，建议照着一条现成的社区规则改。能搜索但不能播放时，关掉编辑器里的"内置播放器"，改走 WebView 播放，兼容性更好。
推荐配置：
- 保留 2–3 条"搜索有效"的来源，其中一条带弹幕，其余作备份
- 超分辨率三档：独立显卡选质量档，其余设备选效率档（需启用硬件解码）
- 内存紧张的设备在播放设置中开启低内存模式，限制播放缓存
- WebDAV 同步打开观看记录与收藏两项
- 弹幕设置中调透明度、配置屏蔽词与显示区域
💡 老用户技巧
- 源优先级：把画质最好、速度最快的源放前面，至少留一条备用；详情页的来源状态点是最快的健康指示器，挂掉先换源再谈卡顿。
- 卡顿排查：开超分后卡顿就降一档，或只对低分辨率源开超分；超分不生效时确认已启用硬件解码，仍不行就把视频渲染器切换为 gpu。
- 外部播放器的边界：大部分作品可转交外部播放器，但带反盗链措施的源在外部播放器里播不了——反盗链 Kazumi 内置播放器能解决，遇到这类源留在内置播放器里看。
- 多设备协作：在设置里配好 WebDAV 云盘后，观看记录、收藏与弹幕屏蔽词自动跨设备同步，换设备不用重设。
- 以图搜番：基于 trace.moe 的画面识别，追番时看到片段截屏即可反查番名，不用硬回忆关键词。
🔍 出问题了先查这里
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 搜索无结果 | 规则过期或站点结构变化 | 到规则管理更新对应规则，或切换到其他源 |
| 首次搜索/播放什么都没有 | 未安装任何规则 | 在规则商店或规则管理中先装至少一条规则 |
| 开超分后播放卡顿 | GPU 性能不足 | 改效率档，或对低分辨率源使用超分 |
| 播放时内存占用高 | 默认尽可能多地缓存视频 | 播放设置中启用低内存模式 |
| Linux 版没有图标和托盘 | 装的是 tar.gz 版 | 改用 .deb 包安装 |
| 外部播放器无法播放 | 视频源反盗链 | 使用内置播放器观看 |
🌱 生态与参与
主要代码都在lib/下：pages/是各页面与视图，services/承载规则引擎、网络、播放、同步等业务能力，plugins/是规则模型与控制器，request/是网络请求层，bean/是通用 UI 组件。完整目录说明见 STRUCTURE.md。
参与方式主要有三种：
- 写规则：照编辑器字段写一条能用的规则，提交到社区规则仓库，让规则商店里多一个可装选项
- 报问题：在仓库 Issue 中提交 bug 或功能建议，附上复现步骤
- 提交代码：先读 CONTRIBUTING.md，一个 PR 只解决一件事，使用 AI 辅助开发需在 PR 中说明所用模型
Kazumi 把一堆站点变成一块听你规则办事的屏幕。现在下载安装包，装进第一条规则，完成第一次聚合搜索。
【免费下载链接】Kazumi基于自定义规则的番剧采集APP，支持流媒体在线观看，支持弹幕，支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
