常见问题
按症状查，比按功能查快。先看下面这张速查表定位，再展开对应条目。答案都尽量给到「为什么」和「怎么处理」，而不是一句「重装试试」。
安装与启动
为什么安装后提示「还没有规则，无法开始观看」？
因为安装包里不内置任何默认规则。Kazumi 只是一个采集与播放的框架，内容来源需要你自己接。
处理方式：在首次启动的引导流程里从规则仓库添加至少一条；或者到「我的 → 规则管理（设置 → 规则设置）→ 添加规则」，从仓库、剪贴板或本地 JSON 文件导入。若仓库列表加载不出来，去「网络设置 → 规则仓库加速」换成另一个前缀——它不是开关，是四选一，选哪个有讲究。
Kazumi 要钱吗？会不会偷偷收费？
不要钱。没有会员、没有内购、没有广告，也不收集你的观看记录用于变现。项目以 GPL-3.0 协议在 GitHub 开源，代码任何人都能审计。
如果某个网站或某个人要求你付费购买、扫码解锁、关注公众号才能拿到 Kazumi，那不是官方行为。
支持哪些平台？有没有电视版？
Android 10 及以上、Windows 10 及以上、macOS 10.15 及以上、Linux（实验性）、iOS 13 及以上（需侧载）、HarmonyOS 5.0 及以上（分支仓库，需侧载）。另有 Web 版，需要在电脑上运行服务端后由局域网设备访问。
没有独立的 Android TV 版本。想在电视上看，可以用 DLNA 投屏，或把装有 Kazumi 的设备画面投到电视。
播放与性能
为什么少数番剧里有广告？
本项目没有插入任何广告。广告来自你选中的那个视频源——源站自己在播放器里叠了广告层。
处理方式：换一条线路试试；或者在规则的「高级选项」/「播放设置」里开启 HLS 广告过滤。另外请务必不要相信视频里出现的任何广告内容，也不要点击。
开了超分辨率之后播放卡顿怎么办？
超分对 GPU 要求高。如果你不是在独显机器上跑，把档位从「质量」切到「效率」，或者只对低分辨率源开启超分（给已经 1080p 的源再超分，收益低但开销一样）。
移动设备上不要用质量档。手机和平板的 GPU 散热余量很小，开质量档很快就会掉帧甚至发热降频。
为什么播放视频时内存占用较高？
这是设计行为：在非移动网络下，Kazumi 会尽可能多地把已缓冲的视频留在内存里，以减少拖动进度条时的等待；在移动数据下默认自动开启低内存模式。
内存紧张时，把「播放设置 → 低内存模式」改为始终开启，缓存上限会被压低，代价是拖进度条时可能需要重新缓冲。
为什么少数番剧没法用外部播放器打开？
因为部分源站做了反盗链：播放地址需要特定的 Referer、Cookie 或临时签名。Kazumi 内部处理得掉这些，但交给 mpv、VLC 等外部播放器时它们不具备这些上下文，就会被拒绝。
这不是配置问题，也没有通用解法。遇到这类源，用内置播放器看即可。
为什么 Linux 版缺少图标和托盘？
因为 .tar.gz 这种打包格式先天不支持桌面集成（不带 .desktop 文件与图标资源）。改用 .deb 安装，或者用 Flatpak 版本，就都有图标和托盘了。
手动补 .desktop 文件不是好办法——应用更新后会覆盖。
规则与数据
为什么我的自定义规则无法检索或选集？
XPath 规则：选择器必须以 // 开头；SearchName、SearchResult 要填相对于 SearchList 的路径；ChapterResult 要填相对于 ChapterRoads 的路径。最常见的错误是 SearchResult 指向了搜索页而不是选集页。
API 规则：JSONPath 必须以 $ 开头，且不支持递归 ..、过滤表达式 [?(...)]、数组切片。若搜索接口只返回裸 ID、选集却用 XPath 解析详情页，需要在搜索规则里配置引用 @source 的详情页地址模板。
规则全挂之前都好好的，为什么突然都失效了？
先分清是「一条失效」还是「全部失效」。一条失效通常是那个源站改版；全部失效更可能是网络层的问题：规则仓库镜像连不上、代理配置异常、系统更新后重置了应用的网络权限。
排查顺序：单独搜一部番 → 换源再搜 → 检查网络设置 → 确认应用版本。全部规则同时改版的可能性极低。
换手机 / 重装系统后，规则和追番记录还能找回吗？
规则与记录存在应用本地数据库里，卸载应用会一起删掉。稳妥的做法有两种：
一是登录项目提供的账号，追番与进度会随账号同步；二是在「规则管理」里把手上的规则导出成 JSON存成一份文件放好，换机后再导入。
Android 用户还要注意：覆盖安装会保留数据，先卸载再装则不会。
安全与渠道
搜索引擎里那些「Kazumi 官网」都是真的吗？
不都是。Kazumi 是开源项目，任何人都能做一个长得像官网的页面。常见套路包括：要求关注公众号才给下载链接、下载的是「安装器」而不是安装包、引导你填写手机号、把开源软件包装成付费版。
判别标准很简单：官方来源只有 GitHub Releases 与 AUR。本站的下载页也给了一份下载，但它把来源写在明面上、包体不做任何改动，后缀与平台都标得清楚。凡是把「关注领取」「扫码解锁」当前置条件的，都不属于这一类。
完整渠道清单与辨别方法 → 拿到包之后怎么确认没被换过，看安装包校验 →
下载后被杀毒软件报毒，是误报吗？
先确认来源。如果是从上面列出的官方渠道下的，报毒多半是启发式规则误判未签名或新发布的应用；Windows 版有 SignPath 提供的代码签名，可以在文件属性里核对。
如果来源不明，不要「添加信任」，直接删掉重下。省下的时间不值得冒这个风险。判断依据可以自己造：算一遍 SHA256 跟官方那份对比 →
我想自己编译，但是失败了。
编译需要良好的网络环境。除了 Google 托管的 Flutter 依赖，项目还依赖 MavenCentral、GitHub、SourceForge 上的资源。在中国大陆，通常需要给这些源配置合适的镜像。
只是想用的话，没有必要自己编译——直接下载发布包即可，功能完全一样。