Kazumi：开源番剧工具的多平台追番解决方案

作为一款基于Flutter开发的开源番剧工具，Kazumi通过自定义视频源规则实现多平台追番体验，支持实时弹幕和画质增强功能。本文将从价值定位、快速部署、核心体验、深度定制和问题解决五个维度，帮助你构建个性化的番剧采集系统。

价值定位：为什么选择Kazumi作为你的追番工具

Kazumi的核心价值在于其高度的可定制性和跨平台特性。作为开源软件，它允许用户通过自定义规则文件聚合多个视频源，摆脱单一平台的内容限制。与传统视频应用相比，Kazumi具有三大优势：

1. 多平台支持：覆盖Windows、Android、Linux等主流操作系统，实现无缝跨设备追番
2. 自定义视频源：通过简单的规则文件配置，即可接入各类番剧资源站点
3. 轻量级设计：无需复杂配置即可快速上手，同时提供丰富的高级功能

快速部署：从安装到使用的三步流程

1. 获取项目源码

通过Git克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/ka/Kazumi

2. 安装依赖与构建

根据目标平台执行相应的构建命令：

• Android平台：

  flutter build appbundle
  

• Windows平台：

  flutter build windows
  

• Linux平台：

  flutter build linux
  

3. 首次启动与基础配置

💡 首次启动应用后，系统会自动检测assets/plugins/目录下的规则文件。内置的DM84.json、7sefun.json等规则可直接使用，也可作为自定义规则的参考模板。

核心体验：四大功能模块深度解析

模块化架构设计

Kazumi采用清晰的模块化架构，主要代码组织如下：

• 页面组件：lib/pages/目录包含所有UI页面
• 数据模型：lib/modules/定义各类数据结构
• UI组件：lib/bean/提供可复用的界面元素
• 网络请求：lib/request/处理API通信和数据获取

模块间通过flutter_modular实现解耦，mobx管理状态，确保应用性能和可维护性。

时间表功能：掌握番剧更新节奏

时间表功能按星期分类展示番剧更新情况，帮助用户合理安排观看计划。界面采用日历式布局，直观展示每日更新的番剧内容，点击即可进入播放页面。

播放体验：弹幕与画质增强

播放界面集成了完整的控制选项，支持弹幕显示、选集切换和评论查看。特别值得一提的是其内置的Anime4K超分辨率技术，可根据设备性能选择效率模式或质量模式，提升低画质视频的观看体验。

深度定制：打造专属视频源

规则文件格式详解

Kazumi使用YAML格式定义视频源规则，以下是一个基础示例：

api: 1
type: anime
name: 示例规则
version: 1.0
baseURL: https://example.com/
searchURL: https://example.com/search?q=@keyword
searchList: //div[@class='search-results']
searchName: .//h3/text()
searchCover: .//img/@src
searchUrl: .//a/@href

规则编写要点

1. XPath选择器：用于从网页中提取番剧信息
2. 变量替换：使用@keyword等占位符实现动态参数
3. 多规则组合：可同时启用多个规则文件，实现资源互补

💡 规则文件应放置在assets/plugins/目录下，应用启动时会自动加载所有JSON/YAML规则。

问题解决：常见场景与优化策略

播放卡顿问题

可能原因：

• 网络带宽不足
• 设备性能有限
• 视频源服务器负载高

解决方案：

1. 降低播放画质或关闭超分辨率功能
2. 切换到其他视频源
3. 清理应用缓存（设置 > 应用管理 > 清除缓存）

规则失效处理

当规则突然无法使用时，可按以下步骤排查：

1. 检查对应网站是否正常访问
2. 使用浏览器开发者工具验证XPath选择器
3. 参考最新的规则模板更新选择器语法

不同设备优化策略

• 高性能设备：启用超分辨率质量模式，开启硬件加速
• 移动设备：选择效率模式，关闭后台下载
• 低带宽环境：优先使用缓存内容，降低视频分辨率

场景化使用指南

场景一：补番计划制定

当你想系统观看某一系列番剧时，可以：

1. 使用搜索功能找到目标番剧
2. 添加到"追番"列表
3. 在时间表中设置更新提醒
4. 利用批量下载功能缓存剧集

场景二：多人同步观看

通过"一起看"功能创建房间，邀请朋友同步观看：

1. 播放页面点击"一起看"按钮
2. 创建房间并分享邀请链接
3. 房间内成员观看进度自动同步

场景三：资源聚合管理

对于收藏的多个视频源，可以：

1. 在设置中调整规则优先级
2. 使用批量管理功能启用/禁用规则
3. 定期更新规则文件保持资源有效性

Kazumi作为一款开源番剧工具，通过其灵活的自定义视频源机制和跨平台特性，为动漫爱好者提供了高效的追番解决方案。无论是简单的日常观看还是深度的个性化定制，都能满足不同用户的需求。随着社区的持续贡献，Kazumi的功能将不断完善，为用户带来更好的追番体验。