新手必看：Kazumi 一站式安装指南，3 分钟上手自定义番剧采集

你是否还在为寻找合适的番剧观看工具而烦恼？是否想要一款能够自定义番剧来源、支持弹幕且跨平台的应用？Kazumi 正是为解决这些问题而生。本文将带你快速完成 Kazumi 的安装与基础配置，让你在几分钟内即可享受个性化的番剧观看体验。

Kazumi 是一款使用 Flutter 开发的番剧采集与在线观看程序，支持通过自定义规则获取番剧资源，提供弹幕、超分辨率等增强功能。支持 Android、Windows、macOS、Linux 等多平台，满足不同设备的使用需求。

支持平台与环境要求

Kazumi 支持多种操作系统，但需要满足以下最低版本要求：

• Android：Android 10 及以上
• Windows：Windows 10 及以上
• macOS：macOS 10.15 及以上
• Linux：实验性支持，推荐使用较新版本的发行版
• iOS：iOS 13 及以上（需要自签名）
• HarmonyOS：HarmonyOS 5.0 及以上（位于分支仓库，需要侧载）

下载与安装步骤

获取安装包

Kazumi 提供多种下载方式，你可以根据自己的操作系统选择合适的版本：

• 官方发布页面：通过项目的 releases 页面获取最新版本
• Android：可通过 F-Droid 安装
• Linux：支持 Flathub、AUR 和 archlinuxcn 等渠道

各平台安装指南

Windows 平台

1. 访问 releases 页面下载 Windows 版本的安装包
2. 双击安装包，按照安装向导指示完成安装
3. 安装完成后，在开始菜单中找到 Kazumi 并启动

Android 平台

除了从 releases 页面下载 APK 安装外，你还可以通过 F-Droid 安装：

1. 打开 F-Droid 应用
2. 搜索 "Kazumi"
3. 点击安装按钮，等待安装完成

Linux 平台

Linux 用户有多种安装选择：

Flathub：

flatpak install flathub io.github.Predidit.Kazumi

AUR：

# 从源码构建
yay -S kazumi
# 或二进制包
yay -S kazumi-bin

archlinuxcn：

sudo pacman -S kazumi

初始设置与界面介绍

首次启动

启动 Kazumi 后，你将看到主界面，包含以下主要区域：

主界面主要包含：

• 顶部导航栏：提供主要功能入口
• 番剧列表区：展示推荐或已添加的番剧
• 底部工具栏：快速访问常用功能

基本配置

1. 添加视频源： 首次使用需要添加视频源，你可以导入预设规则或创建自定义规则。规则文件位于 assets/plugins/ 目录下，包含如 DM84.json、anime7.json 等。

2. 设置画质与播放选项： 进入设置页面，可调整默认画质、播放速度等选项。Kazumi 支持基于 Anime4K 的实时超分辨率，相关 shader 文件位于 assets/shaders/ 目录。

3. 个性化界面： 你可以在设置中更改主题配色，选择适合自己的界面风格。主题设置相关代码位于 lib/bean/settings/theme_provider.dart。

核心功能使用指南

浏览与搜索番剧

Kazumi 提供多种浏览番剧的方式：

1. 推荐番剧：主界面展示热门和推荐番剧
2. 分类浏览：通过顶部导航栏的分类菜单浏览不同类型番剧
3. 搜索功能：使用顶部搜索框查找特定番剧

搜索功能由 lib/modules/search/ 模块实现，支持历史记录和热门搜索建议。

观看番剧与弹幕设置

选择番剧进入播放界面：

播放界面提供丰富的控制选项：

• 播放控制区：包含播放/暂停、进度调整、音量控制等
• 画质设置：可随时切换不同清晰度
• 弹幕控制：开启/关闭弹幕，调整弹幕速度和透明度

弹幕功能由 lib/modules/danmaku/ 模块实现，支持自定义弹幕显示效果。

追番与历史记录

1. 收藏番剧： 在番剧详情页点击收藏按钮，将番剧添加到你的追番列表。收藏功能实现于 lib/bean/widget/collect_button.dart。

2. 查看历史记录： 点击底部工具栏的"历史"按钮，查看观看历史。历史记录管理代码位于 lib/modules/history/。

高级功能配置

超分辨率设置

Kazumi 支持 Anime4K 实时超分辨率技术，可以提升低画质视频的观看体验。相关设置位于设置页面的"超分辨率"选项中：

你可以根据设备性能选择不同的超分模式：

• 效率优先：适合性能较弱的设备
• 质量优先：适合高性能设备，提供最佳画质

超分辨率功能由 lib/shaders/shaders_controller.dart 控制，使用 assets/shaders/ 目录下的 GLSL 着色器文件。

自定义规则编写

Kazumi 最强大的功能之一是支持自定义规则，让你可以添加自己的视频源。规则基于 XPath 语法，只需几行代码即可创建一个新的视频源。

规则编辑器位于 lib/plugins/ 目录，主要实现文件为 plugins_controller.dart。

一个基本的规则文件结构如下：

{
  "name": "示例规则",
  "url": "https://example.com",
  "search": "//div[@class='search-result']",
  "title": ".//h3/text()",
  "cover": ".//img/@src",
  "detail": ".//a/@href"
}

你可以参考现有规则文件如 xfdm.json 来编写自己的规则。

一起看功能

Kazumi 支持多人同步观看功能，让你可以和朋友远程同步观看番剧。相关实现位于 lib/utils/syncplay.dart。

使用方法：

1. 在播放界面点击"一起看"按钮
2. 创建房间或加入现有房间
3. 邀请朋友加入，开始同步观看

常见问题解决

播放卡顿或无法播放

如果遇到播放问题，可以尝试以下解决方案：

1. 降低画质：高画质需要更强的网络和设备性能
2. 关闭超分辨率：超分功能对 GPU 要求较高
3. 切换视频源：某些视频源可能存在地区限制或服务器问题
4. 清除缓存：在设置中清除应用缓存

超分辨率功能导致卡顿

超分辨率功能对 GPU 性能要求较高，如果启用后播放卡顿：

1. 尝试选择效率优先模式而非质量优先
2. 对低分辨率视频使用超分，而非高分辨率视频
3. 在低性能设备上考虑禁用超分辨率功能

找不到特定番剧

如果搜索不到想看的番剧：

1. 尝试使用不同关键词搜索
2. 检查是否添加了包含该番剧的视频源
3. 尝试手动添加自定义规则来获取更多视频源

高级技巧与个性化

导入和分享规则

Kazumi 支持导入和导出自定义规则，让你可以与他人分享自己创建的视频源：

1. 导出规则：在规则管理页面选择要导出的规则，点击导出按钮
2. 导入规则：使用导入功能选择本地规则文件

自定义快捷键

Kazumi 支持自定义快捷键，方便你快速操作。相关配置文件位于 lib/utils/constants.dart，你可以根据需要修改快捷键设置。

硬件加速设置

在设置中可以配置硬件加速选项，以获得更流畅的播放体验。硬件加速相关代码位于 lib/request/query_manager.dart。

总结与资源

通过本文的指南，你应该已经掌握了 Kazumi 的基本安装和使用方法。Kazumi 作为一款开源番剧采集工具，提供了丰富的自定义选项和增强功能，让你可以打造个性化的番剧观看体验。

如果你想深入了解 Kazumi 的更多功能或参与开发，可以参考以下资源：

• 项目源码：整个项目的源代码组织在 lib/ 目录下，包含应用的各个模块和功能实现
• 官方文档：README.md 提供了项目的基本信息和使用说明
• 规则仓库：可以向 规则仓库 提交自定义规则
• 问题反馈：如果遇到问题，可以提交 issue 反馈给开发团队

Kazumi 仍在持续开发中，更多功能如番剧下载、更新提醒等正在开发中，敬请期待未来版本的更新！