ZZZFun

你贴的 "zycczhang/ZZZFun" 是一个基于 Flutter 的开源大屏追番客户端，不是那个曾被判刑的盗版"ZzzFun"网站/App（两者只是同名，法律上不是同一件事）。下面把仓库本身的定位、功能、用法和风险边界给你梳理清楚。

🎯 项目定位

ZZZFun 是一个完全在客户端运行的 Flutter 应用，专为 Android TV 和投影仪等大屏设备设计，完整适配遥控器操作 。它的核心思路是：

- 自己不架设任何服务端，不存储、不提供、不上传任何视频文件 - 番剧元数据来自 Bangumi 开放接口（热度、评分、简介、标签、海报、放送日历） - 视频播放地址通过 KazumiRules（API Level 8 规则） 去请求第三方网站并解析 m3u8/mp4

也就是说，它是一个"元数据浏览器 + 规则化播放解析器"的组合，视频资源本身完全取决于你安装了哪些规则、以及这些规则指向的第三方站点是否可用。

📋 核心功能

番剧发现与浏览

- 首页按 Bangumi 热度展示当季热门番剧，带海报轮播 - 周一至周日放送日期表 - 搜索支持热度排序、关键词二次匹配、分页和页面缓存 - 独立番剧详情页，可从首页/日期表/搜索/片单多入口进入

播放能力

- 读取 KazumiRules API Level 8 规则，支持远程刷新、安装、更新、删除 - 多规则播放源检索、别名重试、候选结果选择、分集切换 - 播放页用 WebView 解析 m3u8/mp4，再用 "video_player" 播放 - TV 播放器支持全屏、焦点导航、遥控器快进快退、进度控制、上下集切换

本地与个性化

- 收藏和观看历史用 SharedPreferences 持久化 - 网络海报内存+磁盘双重缓存 - 独立设置页：规则管理、外观、缓存清理、开发者日志、关于 - 日志分级（debug/info/warning/error）并可持久化查看

技术栈：Flutter stable SDK + Dart 3.10.4+，代码结构清晰， "services/" 下分了 Bangumi API、Kazumi 规则仓库、规则引擎、视频资源、存储、日志等模块 。

🛠 使用流程

# 开发/构建 flutter pub get flutter build apk --debug

实际使用顺序 ：

1. 打开设置 → 规则管理，刷新规则仓库并安装需要的播放规则 2. 从首页 / 日期表 / 搜索 / 片单进入番剧详情页 3. 在详情页打开播放源选择窗口，选可用播放源和搜索结果 4. 进入播放页，用遥控器控制进度、播放状态、切换分集

💡 规则只使用已安装到本地的部分。第三方站点可能出现域名变更、网络不可达、反爬验证或资源失效——这是这类客户端最普遍的"播放不出来"原因。 ⚠️ 需要清楚的风险边界

1. 同名法律风险（重要）

"ZzzFun"这个名字在日本内容海外维权案件中已经被定罪：运营盗版 ZzzFun 网站和 App 的中国籍人员于 2025 年 11 月被石家庄裕华区法院以侵犯著作权罪判处有期徒刑 1 年、罚金 3.5 万元，CODA 代表 13 家日本权利方提起刑事控告 。

但这个 GitHub 仓库 ≠ 那个盗版网站。本仓库 README 明确声明自己是无服务端的开源客户端，视频地址来自用户自行安装的第三方规则 。不过名字带来的联想风险是客观存在的。

2. 第三方规则与资源的合规性

仓库使用的 Predidit/KazumiRules 规则文件采用 MIT License ，但规则指向的第三方网站内容是否授权，仓库本身不保证。README 的免责声明写得很直白：使用第三方数据服务、网站、规则和播放地址时，请遵守当地法律法规以及相关服务的使用条款，并自行承担使用这些第三方服务产生的风险 。

3. 实际可用性

由于完全依赖第三方站点和规则，ZZZFun 的播放体验会随着规则维护情况和站点可达性波动，不适合作为唯一可靠的追番方案。

一句判断