常见问题

AniBaka 和 Baka 是什么关系？

仓库与社区名称使用 AniBaka，客户端名称为 Baka。本文档同时使用两者，但指向同一项目体系。

规则文件还需要加密吗？

不需要。当前 anx-rule/2 官方规则以明文 JSON 维护。baka://、bakax:// 和 pack 只作为历史/分享格式兼容。

为什么我的 URL 非空仍然播放失败？

可能返回了 HTML、海报、预览资源、过期签名 URL，或缺少媒体 Header / Cookie。用 Content-Type、Range 请求和 HLS 分片验证确认它是真实媒体。

什么时候使用 useWebview？

只有站点必须执行 JavaScript、通过 challenge 或嗅探网络请求时使用。公开 API 或稳定 HTML 能完成解析时，不应引入 WebView。

什么时候使用 directConnection？

当 token 与媒体请求必须走同一网络出口，而系统代理会导致出口不一致时。普通超时或站点不可达不是充分理由。

为什么 live tests 默认跳过？

它们依赖第三方站点、网络区域和实时协议，容易受限流、超时与站点维护影响。普通 CI 运行确定性测试；规则开发者显式开启 live tests。

Flutter Web 是正式支持平台吗？

当前项目说明和发行流程没有把 Flutter Web 客户端列为主要发行目标。文档站能在 Web 部署，不代表播放器客户端正式支持 Web。

文档站为什么可以部署到 Workers？

VitePress 构建输出是纯静态文件。Workers Static Assets 可以直接托管这些 HTML、CSS、JS 和图片，不需要运行 Node.js 服务器。

新规则必须加入内置 assets 吗？

不是。大部分规则通过远程规则库分发。只有确实要随客户端发行的内置规则，才需要同步登记 BundledRuleStore、pubspec.yaml assets 与版本基线。