用途：将 Algolia 出现的症状转化为可复现的诊断结论，强调以响应状态、消息、请求 ID、客户端版本、操作和目标索引等具体证据为依据，而非泛化的错误经验。
前提：需明确作用范围内的仓库、环境与 Algolia 应用或索引；以本地 lockfile 和已安装客户端类型为实现权威；准备安全的只读查询或可丢弃的测试目标；涉及变更时参考供应商当前官方文档。
工具纪律：用 Read、Glob、Grep 检查本地代码、配置名、测试与依赖版本；仅用 WebFetch 获取 Algolia 官方最新文档；仅在确定目标文件、约束和验证方案后使用 Write 或 Edit。
关键约定：403 是授权事实，不证明需要无限制密钥；写入成功是异步的，需比对返回的任务 ID 与等待行为后再判定数据过期；404 可能指向缺失的索引、应用、路由或区域端点，应保留完整响应；429 需依据返回消息和当前套餐或密钥限制解读，不能按臆测的通用配额判断。
认证：只检查已脱敏的密钥元数据与 ACL 意图，禁止打印、粘贴密钥，也不得仅为了让失败请求通过而替换为 Admin 密钥。
步骤：捕获最小失败调用的状态、消息、请求 ID、应用 ID 后缀、索引名和包版本；将操作归类为搜索、索引、设置、密钥管理、分析或事件；将该操作与预期密钥 ACL 及索引限制对比；在安全测试索引或只读查询上用相同客户端边界复现；依次检查任务完成、索引拼写、过滤器、属性与环境路由；只应用一处修正，重跑最小复现并记录前后证据。
审批边界：在确认目标与故障类别前，不得扩大 ACL、轮换密钥、修改生产设置或重放写入。
输出：症状、证据、根因假设、已排除的替代项、最小修复、验证结果及剩余不确定性。错误处理：401 或 403 时核实应用与密钥配对及所需 ACL，勿盲目提权；404 时确认端点、应用和精确索引名；429 时遵循响应并在有界重试前衡量请求压力；结果过期时等待特定任务并核实查询的索引。
示例：输入 operation=saveObjects；status=403；index=products_stage，期望结论 cause=missing-addObject-ACL；fix=request-scoped-key；admin-key-used=no。
限制：资料未提供内置脚本、安装命令或具体定价信息，使用需自行准备测试索引与只读环境。