规则驱动的番剧播放器完整使用手册
关于本站:第三方整理的中文文档站,非官方页面;内容来自公开资料整理,功能与界面以官方最新版为准。
装好就能看番的播放器很多,但装好之后什么都没有、需要你自己决定「从哪里看」的播放器很少。这里整理的就是这样一款工具:它用最多几行 XPath 选择器决定内容来源,用规则仓库和分享机制把「片源」变成可以流通的小配置文件。本手册按「装上 → 喂规则 → 调播放 → 连服务」的真实使用旅程组织,每个功能点单独一页。


产品档案速览
| 项目 | 内容 |
|---|---|
| 软件定位 | 基于自定义规则的跨平台番剧采集与在线观看应用 |
| 开发者 | Predidit(GitHub 开源项目) |
| 技术底座 | Flutter 构建,播放内核基于 media-kit |
| 开源协议 | GPL-3.0 |
| 当前版本 | 2.3.8(2026 年 10 月初发布,以项目发布页为准) |
| 支持平台 | Android 10+ / Windows 10+ / macOS 10.15+ / Linux(实验性)/ iOS 13+(侧载)/ HarmonyOS 5.0+(侧载) |
| 数据来源 | 番剧元数据来自 Bangumi 开放 API,弹幕来自弹弹play 等开放平台 |
| 隐私情况 | 项目声明不收集任何用户数据、不含遥测组件 |
本站结构导览
手册分成七个部分,建议按顺序读前三个部分,其余按需跳转:
- 先弄懂它:这款应用和普通播放器的本质区别、内容进来的三条通道、六个平台的版本要求。新手从这里建立正确预期,避免「装完发现没片源」的误判。
- 装到设备上:六个平台逐个讲安装。安卓与桌面端是安装包直装,iOS 与鸿蒙要走侧载,各有两条路线可选。
- 喂它第一条规则:规则是什么、自带哪三条规则、怎么从仓库和剪贴板添加、仓库连不上怎么办。这是从「空壳」到「能看」的关键一步。
- 动手写规则:规则编辑器九个字段逐个拆解,从复制完整 XPath 开始写自己的规则,进阶到 API 规则与调试排错。
- 把播放调到顺手:超分辨率两个档位怎么选、弹幕正则屏蔽怎么写、外部播放器与投屏的边界在哪里。
- 连上云与伙伴:Bangumi 账号同步、WebDAV 备份、和朋友开 SyncPlay 房间一起看。
- 排错与答疑:卡顿、广告、反盗链、Linux 托盘缺失这些高频问题的答案。
从哪里开始
如果只读三页,读这三页:
- 这款追番工具的工作方式——理解规则、元数据、嗅探三条通道,后面所有操作都建立在这个认知上。
- 规则是什么:五行选择器决定一个片源——本工具最核心的概念。
- 超分辨率两个档位怎么选——画质与流畅的第一道取舍。
想直接查某个具体开关的用法,用左侧导航按分组找即可;每页只讲一个功能点,不互相牵扯。