当前位置：首页 > news >正文

Kazumi：基于自定义规则的跨平台番剧采集器终极指南

news 2026/6/30 7:16:12

Kazumi：基于自定义规则的跨平台番剧采集器终极指南

【免费下载链接】Kazumi基于自定义规则的番剧采集APP，支持流媒体在线观看，支持弹幕，支持实时超分辨率。项目地址: https://gitcode.com/gh_mirrors/ka/Kazumi

Kazumi是一款基于Flutter开发的跨平台番剧采集应用，通过自定义XPath规则实现多源聚合，支持弹幕互动和实时超分辨率技术，为动漫爱好者提供一站式追番解决方案。这款免费开源工具支持Android、Windows、macOS、Linux和iOS平台，让用户能够轻松构建个性化的动漫资源库。

核心技术架构解析

模块化设计与状态管理

Kazumi采用Flutter Modular框架实现模块化架构，核心模块位于lib/modules/目录下。应用使用MobX进行状态管理，确保UI与数据状态同步。每个功能模块都包含独立的Controller、Module和Service层：

Controller层：处理业务逻辑和状态管理，如PluginsController管理插件规则
Module层：实现依赖注入和路由管理，如AppModule作为应用入口模块
Service层：提供平台相关功能，如VideoSourceService处理视频源解析

跨平台播放引擎集成

项目采用media-kit作为核心播放引擎，支持硬件加速和高性能视频渲染。通过lib/services/player/目录下的音频控制器、外部播放器管理等功能，实现了统一的播放体验：

// 播放器配置示例 media_kit: git: url: https://github.com/Predidit/media-kit.git ref: 11d02cb804b8faf944137834a1b0ac80880a4079

自定义规则系统实现

Kazumi的规则系统基于XPath选择器，仅需5行代码即可定义完整的资源站规则。系统通过xpath_selector库解析网页结构，支持动态规则更新和分享：

// 规则配置示例 { "name": "LMM", "version": "1.2", "baseURL": "https://www.lmm92.com/", "searchURL": "https://www.lmm92.com/vod/search.htr", "searchList": "//div[@class='video-list']/a", "searchName": "//h3[@class='title']" }

实战配置：从零开始搭建个人番剧库

安装部署最佳实践

Kazumi支持多种安装方式，针对不同平台推荐以下方案：

Windows用户：下载.msix安装包获得完整系统集成，支持全局快捷键和任务栏进度显示Android用户：通过F-Droid商店安装，确保应用签名安全Linux用户：使用.deb包安装以获得托盘图标和通知功能

编译环境配置：

git clone https://gitcode.com/gh_mirrors/ka/Kazumi cd Kazumi flutter pub get # 根据目标平台构建 flutter build apk # Android flutter build windows # Windows flutter build linux # Linux

规则管理高效配置

规则管理是Kazumi的核心功能，通过"我的"→"插件管理"→"导入规则"即可添加新源。系统内置多个预配置规则，如LMM、ciyuancheng、clicli等，每个规则显示版本状态和安装时间。

规则更新策略：

定期检查官方规则仓库更新
手动导入社区分享的规则文件
使用规则编辑器自定义适配特定网站

多源聚合搜索优化

Kazumi支持同时搜索多个视频源，智能排序搜索结果。在lib/plugins/plugins_controller.dart中实现了插件加载和搜索优先级管理：

// 插件搜索逻辑 Future<List<SearchResult>> search(String keyword) async { final results = <SearchResult>[]; for (final plugin in activePlugins) { try { final pluginResults = await plugin.search(keyword); results.addAll(pluginResults); } catch (e) { logger.e('搜索失败: ${plugin.name}', e); } } return _sortResults(results); }

高级功能深度应用

实时超分辨率技术应用

Kazumi集成Anime4K实时超分辨率技术，通过assets/shaders/目录下的GLSL着色器文件实现画质提升：

Anime4K_AutoDownscalePre_x2.glsl：2倍降采样预处理
Anime4K_Upscale_CNN_x2_M.glsl：中等质量2倍超分
Anime4K_Restore_CNN_VL.glsl：高质量细节恢复

性能调优建议：

高性能显卡：开启"质量档"获得最佳效果
集成显卡：使用"效率档"平衡性能与画质
移动设备：建议关闭以节省电量

弹幕系统集成方案

通过canvas_danmaku库实现弹幕渲染，支持实时弹幕加载和屏蔽设置。系统与弹弹play开放API集成，提供丰富的弹幕体验：

弹幕密度控制：根据视频类型调整弹幕显示频率
屏蔽规则配置：支持关键词、用户、类型等多维度屏蔽
发送功能集成：内置弹幕发送接口

跨设备同步实现

Kazumi通过WebDAV协议实现观看记录同步，lib/services/sync/目录下的同步服务支持：

历史记录同步：自动同步播放进度
收藏列表同步：跨设备管理追番列表
配置同步：个性化设置云端备份

// WebDAV同步配置 webdav_client: ^1.2.2

性能优化与问题排查

播放卡顿解决方案

当遇到播放卡顿时，可以按以下步骤排查：

视频源选择：切换到速度更快的源（如ciyuancheng）
画质调整：降低分辨率到720p或480p
超分辨率设置：暂时关闭Anime4K功能
缓存管理：清理应用缓存释放内存

内存占用优化策略

Kazumi采用主动缓存策略提升观看体验，但可能造成内存占用较高。优化方案：

低内存模式：在播放设置中启用，限制缓存大小
定期清理：手动清理观看历史和缓存文件
后台播放控制：关闭不必要的后台服务

规则编写常见问题

问题1：规则无法检索解决方案：确保XPath选择器以//开头，参考示例规则格式

问题2：规则可检索但无法播放解决方案：关闭"内置播放器"选项，尝试使用WebView播放

问题3：视频源失效解决方案：检查BaseURL和SearchURL配置，确认网站结构是否变化

进阶配置与自定义开发

自定义规则编写指南

规则编辑器提供完整的配置界面，支持以下关键参数：

基础配置：名称、版本、基础URL
搜索配置：搜索URL、列表选择器、标题选择器
播放配置：视频URL提取规则、播放器类型
高级配置：请求头、编码设置、代理支持

插件系统扩展开发

Kazumi的插件系统位于lib/plugins/目录，支持第三方扩展开发：

// 自定义插件示例 class CustomPlugin extends BasePlugin { @override String get name => '自定义源'; @override Future<List<SearchResult>> search(String keyword) async { // 实现搜索逻辑 } @override Future<VideoSource> resolve(String url) async { // 实现视频解析 } }