kazumi规则类型怎么选？XPath与API搜索、选集规则说明

想了解 kazumi 的规则类型，可以先从产品站 https://kazumi.app/ 进入，再结合官方规则文档判断要使用 XPath 还是 API。Kazumi 产品站将自己定位为基于自定义规则的跨平台番剧采集与在线观看应用，规则主要负责搜索作品、返回可用线路并组织剧集页面。

XPath 规则适合从网页 HTML 中定位结果，API 规则适合直接读取网站提供的 JSON 接口；搜索和选集可以分别选择类型，不必把整条规则强行固定成同一种方式。

• 可信入口：https://kazumi.app/，首页提供下载、使用指南和共创入口。
• XPath 规则：请求网页 HTML，再定位搜索结果、播放线路和剧集链接。
• API 规则：直接请求 JSON 接口，按字段提取作品、来源、线路和剧集信息。
• 组合方式：官方文档说明搜索与选集类型可以独立选择，也可以混合使用。

kazumi是什么产品？

从产品站首页可见，kazumi 面向希望在不同设备上搜索和观看番剧的用户，展示了 Android、iOS、Windows、macOS、Linux 和 HarmonyOS 等平台。首页同时强调自定义规则、弹幕和实时超分辨率等产品方向；具体内容能否检索或播放，还要看用户选择的规则、来源页面和网络情况。

kazumi规则负责哪些环节？

官方规则文档把规则链路概括为两步：先根据关键词返回作品列表，再根据选中的作品返回播放线路和剧集页面。换句话说，规则不是一个单独的播放器开关，而是连接搜索结果、作品来源、线路和剧集入口的配置层。

实际使用时，应先确认目标公开页面是否能正常打开、搜索是否能返回结果，再考虑如何描述页面结构或接口字段。页面要求登录、验证码或复杂人机验证时，规则配置还可能需要额外处理；本文只介绍官方公开的规则概念，不延伸到绕过限制的做法。

XPath和API规则有什么区别？

XPath 规则会请求目标网页的 HTML，再通过 XPath 定位搜索结果、播放线路和剧集链接，比较适合服务器已经输出完整 HTML 的传统网页。API 规则则直接请求网站提供的 JSON 接口，再通过 JSONPath 等字段路径提取作品、来源和剧集信息，通常更依赖接口字段的稳定性。

官方文档还说明，搜索和选集的规则类型可以分别选择。例如一个来源可以使用 API 完成关键词搜索，再用 XPath 处理选集页面；也可以反过来组合。API 规则文档标注需要 Kazumi API level 8 或更高版本，因此遇到规则编辑器没有 API 选项时，应先核对客户端版本与官方说明。

第一次选择规则类型时怎么判断？

如果目标页面打开后已经把作品列表、线路和剧集链接写在 HTML 中，可以先从 XPath 方向理解页面结构；如果网页主要依赖接口返回 JSON，再从 API 方向检查请求地址、参数和响应字段。不要只根据“看起来像接口”下结论，仍应以页面公开结构和官方文档中可验证的字段为准。

规则配置完成后，建议分段测试：先验证关键词能得到作品列表，再验证选中作品后能出现线路与剧集，最后确认播放页是否能正常打开。某一步失败时，先定位是搜索、选集、来源页面还是播放环境问题，不要把所有问题都归因于播放器。

常见问题

XPath和API可以在同一条规则中混用吗？

可以。官方文档明确说明搜索和选集类型可以独立选择，因此可以根据目标页面的实际结构组合 XPath 搜索、API 选集，或 API 搜索、XPath 选集。组合前应分别确认两端返回的数据能衔接。

为什么规则编辑器里没有API选项？

官方 API 规则文档要求 Kazumi API level 8 或更高版本。可以先核对当前客户端版本、官方发布渠道和规则编辑器功能；如果版本条件满足仍没有选项，再检查是否进入了正确的新建规则页面。

有了规则是不是所有作品都能播放？

不是。规则只负责按公开页面或接口提取搜索、线路和剧集信息，实际播放还会受到来源页面可访问性、网络、地区、资源有效性和授权范围影响。第三方规则及其内容来源应由使用者自行确认合法性。

网页结构变了，应该先改XPath还是换API？

先看失败位置和目标页面当前提供的数据。如果 HTML 结构变化但公开接口稳定，可以评估 API 方式；如果接口字段不稳定而页面仍输出完整 HTML，则可以重新核对 XPath。两种方式都应以当前公开页面为依据，不能通过规避验证或权限限制来恢复访问。

入口与使用边界确认

kazumi 的可信入口是产品站 https://kazumi.app/，规则类型说明可在官方文档 https://kazumi.app/docs/rules/develop-api-rules/ 中核对。下载或更新时优先使用产品站提供的渠道；编写或导入规则前，应确认目标来源公开可访问，并遵守内容版权、网站条款和当地法律要求。