安装与首次配置
Kazumi 的安装本身不难，卡人的通常是三件事：系统不认签名、不知道包该放哪、装完打开发现是空的。前两件按平台分开讲，最后一件在文末统一解决。
Windows：MSIX 与便携版
下载 Kazumi_windows_*.msix 后双击安装——文件名中间的星号就是版本号。Windows 会把它当成一个现代应用处理：出现在开始菜单里，支持自动更新，也能接管 kazumi:// 深链。
如果只想临时试用，下载 .zip 便携版解压到任意目录，运行里面的 exe 即可，不写注册表、不进开始菜单。
「已保护你的电脑」提示
这是 SmartScreen 对下载量较少的新应用的默认拦截，不代表真的有病毒。点「更多信息」，再点「仍要运行」。Windows 版由 SignPath 提供代码签名，介意的话可以在文件属性 → 数字签名里核对签名主体再决定。
安装失败、提示需要证书
MSIX 需要系统信任签名证书。Windows 10 较老的版本或精简版系统可能缺少根证书，此时改用 zip 便携版最省事。
# 解压到 D:\Apps\Kazumi 后 D:\Apps\Kazumi\kazumi.exe
macOS：提示「已损坏，无法打开」怎么办
打开 dmg，把 Kazumi 拖进「应用程序」文件夹，这一步和普通 Mac 应用一样。
第一次启动如果弹「Kazumi 已损坏，无法打开。你应该将它移到废纸篓」，不是文件坏了。这是 Gatekeeper 对未经过公证（notarization）的应用的拦截，去掉隔离属性即可。
打开「终端」，执行右边这条命令，把路径换成你自己的应用位置，然后重新打开应用。
sudo xattr -rd com.apple.quarantine /Applications/Kazumi.app
Linux：三种装法，按发行版选
Debian / Ubuntu 系直接装 deb，能得到完整的图标与托盘支持；其他发行版用 Flatpak 最稳；Arch 用户走 AUR。tar.gz 只适合二次打包，解压出来的程序没有桌面集成。
sudo dpkg -i Kazumi_linux_*_amd64.deb # 若提示缺依赖 sudo apt install -f
flatpak install flathub \ io.github.Predidit.Kazumi flatpak run io.github.Predidit.Kazumi
yay -S kazumi-bin # 或从源码构建 yay -S kazumi
Android：一个通用 apk
Kazumi 只发一个通用 apk，不用分辨自己手机是 arm64 还是 armeabi，装就完了。
从浏览器下载后，系统会提示「为了安全，你的手机不允许安装未知来源的应用」。在提示里点「设置」，允许当前浏览器安装应用，返回后继续即可。
部分国产 ROM 会在安装时二次扫描并提示风险，这是厂商行为。确认包来自官方渠道后选择「继续安装」。
iOS：App Store 没有，只能侧载
官方发布的 Kazumi_ios_*_no_sign.ipa 是未签名包，必须自己签名后才能装进 iPhone 或 iPad。常用工具是 AltStore 与 Sideloadly，两者都需要一台电脑配合。
用 AltStore 需要先在电脑装 AltServer 并登录 Apple ID；Sideloadly 则是直接把 ipa 拖进去。
免费账号签名的应用有效期为 7 天，到期打不开，重新签一次就行。想在手机上长期挂着，需要保持 AltServer 在同一 Wi-Fi 下做后台刷新。
到「设置 → 通用 → VPN 与设备管理」，找到对应的开发者描述文件并点信任，应用才能启动。
AltStore 还是 Sideloadly
两者都能签。区别在于 AltStore 在手机上留一个常驻应用，靠同一 Wi-Fi 下的电脑自动续签，代价是电脑要时不时开着；Sideloadly 是纯电脑端一次性操作，签完就拔线，但 7 天到了得重新插线。
装完打不开，多半是这两步
一是漏了「信任描述文件」，二是签名时用的 Apple ID 没在这台手机上登录过。免费账号还有 3 个应用的上限，装满了要先删一个再签。
HarmonyOS NEXT：鸿蒙版 Kazumi 怎么侧载装上
鸿蒙 NEXT 不再兼容 Android 应用，apk 在这类设备上根本装不进去。Kazumi 的鸿蒙版由社区维护在独立分支里，不随主仓库发版，产物是 .hap，只能靠侧载安装——全程需要一台电脑配合，第一次装大约十五分钟。
先备齐四样东西
- hap 安装包：下载页的目录里就有一份；若那里还没跟上新版本，再去鸿蒙分支仓库的 Releases 取。
- 一台电脑：Windows、macOS、Linux 都能用，前提是装好 Java 运行环境。
- 华为账号：签名环节绕不开，建议提前完成实名认证，能少掉一次重装的功夫。
- 同一网络：手机和电脑连同一个 Wi-Fi；走数据线也可以，只是少了无线的方便。
进「设置 → 关于本机」，在「软件版本」上连点五下，系统会要求验证锁屏密码，之后提示已进入开发者模式。返回设置，在「系统」下面就能看到新出现的「开发者选项」。不同鸿蒙版本这里的一级菜单名字略有出入，找不到就翻一翻「系统」和「关于」这两处。
开发者选项里找到「无线调试」并打开，此时页面上会显示一组 IP 与端口，形如 192.168.1.20:41234。这组数字下一步要填进电脑端工具，切走之前先记下来——端口每次重开都有可能变。
用社区开源的 小白调试助手，它负责代你调签名服务、把 hap 推送到手机。Windows 首次打开会提示安装 Java，跟着装就行；Linux 依赖 zenity，而且不能用 root 权限运行；macOS 见下面的命令。
打开工具先「登录账号」，浏览器会跳到华为账号页，点允许，等它提示登录成功返回。然后「连接设备」，填入刚才记下的 IP 与端口。接着「选择」挑出准备好的 hap 文件，工具会读出包名和支持安装的设备。最后点「开始调试」，等进度条走完，手机上就出现 Kazumi 了。
macOS 用户多一步。从网络下载的工具会被 Gatekeeper 拦一道，首次运行前先在终端里去掉隔离属性，否则会提示「已损坏」。
命令执行完再双击打开就行，不需要重启。
sudo xattr -d com.apple.quarantine \ /Applications/小白调试助手.app
装不上时，按症状对一下
| 症状 | 多半是 | 怎么处理 |
|---|---|---|
| 连接设备一直失败 | 手机和电脑不在同一网段，或无线调试被系统关掉了 | 回手机确认开关仍开着，重新看一眼 IP 与端口有没有变 |
| 提示找不到 Java | 电脑没装运行环境 | Windows 装 JDK 后重开工具；macOS 用 brew install openjdk |
| 签名阶段报错退出 | 华为账号没实名，或证书配额已满 | 先去开发者联盟完成实名，再回工具里重新「开始调试」 |
| 装好了但一开就闪退 | hap 的 API 版本与本机系统不匹配 | 换分支仓库里对应系统版本的构建产物，别用最旧的那份 |
| 用了几天突然打不开 | 签名证书到期了 | 重新走第 4 步，应用数据不会丢 |
鸿蒙版的功能与主线不完全同步，遇到与系统相关的问题，优先到对应的分支仓库反馈，那里比主仓库更容易找到人。
首次启动：三分钟配好第一条规则
首次启动的引导页会给出「浏览规则仓库」的入口。如果列表一直在转圈，去「网络设置」打开「规则仓库镜像」再试。
不建议只装一条。不同源覆盖的番剧不一样，装两三条能明显提高搜到的概率。装好后状态会显示「搜索有效」。
首页搜索框输入番名。搜不到就换关键词（试试日文原名或英文名），还是搜不到就说明这个源确实没有。
确认几个稳定的源后，在规则管理里把长期失效的删掉。规则太多会拖慢搜索，也会让结果列表变乱。