用途:该技能为 Algolia 记录转换和搜索行为建立快速本地开发循环,避免污染共享索引,适用于迭代搜索代码的场景。它结合确定性的离线测试与可选的临时索引集成测试,明确不假设模拟能复现供应商排序、任务时序或授权。
主要能力与使用方式:保持记录转换和查询构建为可离线测试的纯函数;仅模拟应用自有客户端边界,不模拟 SDK 内部实现细节;实时检查使用唯一的临时索引名,绝不复用生产凭据;等待写入任务并显式清理实时夹具。使用 Read、Glob、Grep 检查本地代码、配置、测试与依赖版本,仅用 WebFetch 获取官方 Algolia 最新文档,在明确目标文件和验证计划后再写或编辑。步骤包括:检查客户端封装、包脚本、夹具和测试框架;提取纯记录塑形与查询构建函数并配单元测试;创建类型化适配器并模拟应用级响应与失败;添加验证生成的临时索引名的可选实时测试;写入已知记录、等待、查询、断言并清理,保留任务凭据;记录开发者如何选择离线或实时模式。
认证与限制:离线测试无需凭据;可选实时测试使用限制在临时前缀的自定义密钥,缺少凭据时禁用。默认测试命令不要求实时凭据,不得共享个人 Admin 密钥,不得清理已验证临时前缀之外的任何索引。凭据缺失时运行离线测试并报告实时测试已跳过;模拟与适配器不一致时同步更新适配器契约和类型化夹具;临时前缀无效时在任何网络写入前失败;清理失败时报告确切保留的索引供人工审查。示例输入:mode=offline-default; integration=ALGOLIA_LIVE_TEST=1; prefix=dev-$USER-$RUN,预期移交:unit=pass; live=skipped; production-index-access=none。