用途：定义应用输入与 Algolia 搜索结果之间的读取路径，让查询构造、允许的过滤器、分页和结果投影保持显式，便于独立测试 UI 行为。
主要能力与要求：使用 searchSingleIndex 处理单索引，在 v5 客户端传入 indexName 和 searchParams；将 filters 与 facet filters 视为结构化应用输入，不拼接不可信语法；仅请求界面需要的属性，保留 objectID 作为稳定结果标识；仅在产品同时实现查询 ID 与事件契约时启用点击分析。
前提：明确仓库、环境、Algolia 应用或索引；以本地 lockfile 和已安装客户端类型为实现依据；准备只读查询或可丢弃的测试目标；参考当前官方文档。
使用方式：用 Read、Glob、Grep 检查本地代码、配置、测试与依赖版本，仅用 WebFetch 获取官方 Algolia 文档，确定目标文件与验证方案后再写改。先检查客户端版本、索引设置、记录模式与当前 UI 查询状态；定义有类型搜索输入（查询长度、页、每页命中、过滤器、分面有界）；通过允许列表转换过滤器而非接受原始字符串；调用 v5 搜索边界并映射为应用结果类型；测试空查询、无结果、特殊字符、分页边界和缺失分面；验证返回属性不泄露不应暴露字段。
认证：浏览器搜索应使用 search-only key 或后端生成的安全密钥；具备写权限的凭据保留在服务端。
审批边界：未经明确评审，读取路径实现中不得更改索引设置、启用分析或暴露额外属性。
错误处理：过滤器语法无效时在应用边界拒绝或规范化；分面缺失时先确认属性已配置再改 UI；返回意外字段时收紧检索与索引可见性设置；无查询 ID 时仅在事件设计获批后启用点击分析。
输出：返回类型化输入/输出契约、查询构造器、相关测试、凭据边界、观察到的响应元数据以及所需的索引设置变更。
限制：资料未提供具体安装命令、价格、平台或效果数据。