Kazumi：跨平台自定义规则追番客户端
1. 项目简介
Kazumi 是一款支持自定义解析规则的跨平台追番客户端 项目本身不内置任何视频资源，核心设计思路是让用户通过简短的 XPath 或 API 规则，自主定义、导入、分享番剧数据源，实现多站点流媒体统一观看。配套独立的社区规则仓库，规则可一键导入、同步更新。
项目采用 GPL-3.0 开源协议，全平台原生 Flutter 构建，兼顾移动端与桌面端，支持 Bangumi 数据对接，同步番剧进度、收藏、追番列表，弹幕接入 DandanPlay，播放器内置硬件解码与 Anime4K 超分滤镜，提升低清片源观感。
仓库地址：https://github.com/Predidit/Kazumi
2. 核心技术栈
项目主体使用 Dart + Flutter 开发，跨平台一套代码编译多端安装包。
主要依赖组件：
Flutter：跨平台 UI 框架，统一 Android/iOS/ 桌面端界面
Anime4K：GLSL 实时超分辨率着色器，视频播放时实时放大降噪
media_kit：高性能跨平台播放器内核，硬件加速解码
Dio：网络请求，用于拉取页面、弹幕、视频流
Isar：本地数据库，存储观看历史、追番记录、规则配置
WebView：辅助页面解析，配合 XPath 解析器提取播放信息
Bangumi API、DandanPlay API：番剧元数据、弹幕数据源对接
3. 主要功能特性
3.1 自定义解析规则系统
这是 Kazumi 最核心的特性，支持 XPath 规则、API 规则以及混合模式，最多仅需少量配置即可完成站点解析。支持规则导出、导入、二维码分享，社区共享规则库持续维护。应用本身不自带任何播放源，数据源完全由规则管理。
3.2 播放器与画质增强
内置弹幕播放，支持弹幕屏蔽、字号、速度、透明度自定义；
Anime4K 实时超分辨率，播放过程中对视频画面做锐化放大；
外挂字幕、多字幕切换；
硬件解码，高刷屏幕适配，手势调节亮度、音量、进度；
DLNA 投屏，推流到电视、投屏设备。
3.3 番剧与进度管理
对接 Bangumi，同步番剧信息、收藏、追番进度；
番剧时间表、新番连载提醒；
观看历史、本地收藏、分集管理；
番剧搜索、按标签筛选番组。
3.4 跨平台支持
编译产出 Android APK、iOS 安装包、Windows、macOS、Linux 桌面包，同时提供 Flatpak、F-Droid 渠道分发。多端配置可通过备份文件迁移。
3.5 附加能力
规则编辑器，App 内直接调试、编写解析规则；
播放缓存策略，可自定义缓存大小与位置；
主题切换，深色模式；
自动检查版本更新。
4. 典型使用场景
追番爱好者：统一在一个客户端观看不同站点番剧，弹幕同步，管理追番进度；
规则制作者：学习 XPath 网页解析，编写、分享视频源规则；
多设备用户：手机、电脑共用一套追番客户端，进度备份迁移；
开发者：学习 Flutter 跨平台播放器、GLSL 着色实时渲染、网页解析规则引擎实现。
5. 获取与部署
项目 Releases 提供各平台预编译包；Android 可通过 F-Droid 安装，Linux 支持 Flatpak。源码可直接克隆编译，GPL 协议要求修改后的衍生版本同样开源。首次启动需要导入社区规则才能正常搜索播放。
6. 总结
Kazumi 和传统视频播放器最大区别在于 “规则驱动”，把数据源的选择权交给用户和社区。依托 Flutter 实现全平台覆盖，Anime4K 实时超分、弹幕、Bangumi 同步等功能完整，形成一套轻量化、可扩展的追番方案。它不绑定固定资源站，依靠社区规则生态持续迭代，是开源追番工具里差异化很强的项目。