Kazumi完全指南：开源番剧管理工具的高效使用方法

Kazumi是一款基于自定义规则的开源番剧采集应用，支持流媒体在线观看与弹幕互动，帮助用户构建个性化番剧收藏库。通过灵活的数据源配置和直观的界面设计，该工具实现了番剧发现、追更管理和内容定制的一体化解决方案，适用于各类动漫爱好者。

价值定位：为什么选择Kazumi

作为开源番剧管理工具，Kazumi的核心优势在于三点：首先是多平台适配能力，支持Android、iOS、Linux等多系统环境；其次是自定义数据源，用户可根据需求配置内容采集规则；最后是轻量化设计，无需复杂部署即可实现高效番剧管理。这些特性使Kazumi成为替代传统视频平台的理想选择。

核心体验：三大用户场景应用

日常追番场景：智能时间线管理

通过"时间表"功能，用户可按星期维度查看当日更新番剧，系统会自动标记未看内容。界面顶部的季节标签（如"2025年冬季新番"）帮助快速定位当季热门作品，点击番剧卡片即可进入详情页。时间线视图支持左右滑动切换日期，配合醒目的更新提示，确保不错过任何新内容。

内容发现场景：个性化推荐机制

首页采用卡片式布局展示推荐番剧，顶部分类标签（日常/原创/校园等）支持快速筛选。系统基于用户观看历史和收藏偏好生成个性化推荐，点击任意番剧卡片可查看详细信息，包括更新状态、制作人员和观众评分。收藏功能通过心形图标实现，收藏内容自动同步至"追番"页面。

观看互动场景：沉浸式播放体验

播放界面集成弹幕系统，支持实时评论互动。用户可调整弹幕速度、透明度和显示区域，也可关闭弹幕专注观看。选集列表清晰展示剧集信息，支持连续播放和记忆播放位置。播放控制区提供倍速调节、画质选择和投屏功能，满足不同观看需求。

扩展能力：数据源配置与管理

数据源管理：多规则并行方案

在"规则管理"页面，用户可查看已安装的数据源规则，包括版本信息、安装时间和搜索有效性。系统支持规则更新和禁用，确保内容采集的时效性。每个规则独立运行，避免单一数据源失效导致的内容中断，提升整体可用性。

自定义规则：高级用户功能

规则编辑器提供可视化配置界面，用户可设置数据源名称、基础URL和搜索路径。通过填写CSS选择器定义内容提取规则，支持自定义搜索列表、名称和结果路径。内置播放器选项可在调试时禁用，便于规则测试。高级用户可通过导入/导出功能分享规则配置。

快速上手：安装与基础设置

环境准备

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/ka/Kazumi
2. 根据目标平台执行依赖安装：
   • Android：cd android && ./gradlew assembleDebug
   • iOS：cd ios && pod install
3. 启动应用后，首次运行需授予存储和网络权限

基础配置

• 进入"我的"页面完成用户信息设置
• 在"规则管理"中启用默认数据源
• 调整"设置"中的播放参数（如默认画质、弹幕设置）

进阶技巧

1. 规则备份策略：定期导出自定义规则至本地，避免重装应用导致配置丢失
2. 多数据源协同：同时启用多个规则，通过搜索结果排序实现内容互补
3. 播放优化方案：在网络不稳定时，开启"预加载"功能确保流畅观看体验

相关资源

• 官方规则库：assets/plugins/
• shader效果配置：assets/shaders/
• 应用图标资源：assets/images/logo/