用途:在正式开发搜索功能前,先完成 Algolia JavaScript v5 客户端的安装与认证边界设定,把应用 ID 与 API Key 区分开,并将浏览器搜索与可信写操作分离。
主要能力:按仓库既有包管理器与锁文件安装固定版本的 v5 客户端;使用 algoliasearch v5 的导入与客户端级方法,避免已被移除的 initIndex 模式;浏览器侧只暴露 search-only 或适当受限的 key;后端任务使用最小 ACL 与索引限制的自定义 key;通过仓库既有密钥机制加载凭证;验证浏览器只读查询,并仅在可丢弃索引上验证后端写入;扫描构建产物与源码历史,检查写入 key 是否意外泄露。
使用方式:先用 Read、Glob、Grep 检查本地代码、配置名、测试与依赖版本;仅在需要当前官方 Algolia 文档时使用 WebFetch;确认目标文件、约束与验证计划后再用 Write 或 Edit。按原生包工作流安装兼容的 pinned v5 版本,为应用 ID、浏览器搜索 key、服务端写入 key 定义独立环境变量名,按信任边界创建客户端工厂,缺配置时直接拒绝而不回显值。
限制与边界:不安装依赖、不创建 provider key、不修改密钥存储或轮换既有凭证,除非在给定仓库与账号范围内。不要在浏览器构建中放入写入 key,否则停止并轮换。无安全测试索引时,验证仅限只读搜索。代码中出现 v4 API 时,先参考官方 v5 迁移指南再混合使用。凭证不得打印或提交 .env 文件,不得默认用 Admin key 作后端凭证。