用途:当本地诊断不足,需要复现或升级 SerpAPI 问题时,整理一份隐私安全的支持包,在收集足够证据的同时排除凭证、敏感查询与不必要的结果数据。
前提条件:需要故障时间窗、受影响引擎、可用时的搜索 ID、故障负责人;对任何查询或结果披露需有数据分类与批准;以及当前客户端版本、运行时、部署与重试配置。
工具使用:使用 Read、Glob、Grep 追踪代码与日志,WebFetch 核实状态与支持合同,Write 或 Edit 生成脱敏包,Bash(python3:*) 仅用于已批准的 Account API 或归档诊断。
当前契约:Account API 提供套餐用量与每小时吞吐量,且不消耗月度搜索;标准搜索记录按文档保留期过期,归档访问在删除后可能返回 410。ZeroTrace 搜索故意没有归档记录,更难调试。
认证:仅在诊断进程中加载 SERPAPI_KEY,保存或共享前移除 api_key、含 key 的 URL、账户邮箱与 ID、敏感查询值、原始 HTML 及无关结果。
步骤:冻结时间窗并记录安全的运行时、客户端、部署、引擎、超时、重试与区域信息;从现有证据提取 HTTP 状态、顶层错误、搜索状态、search ID、耗时与参数名;经批准查询 Account API,仅保留剩余搜索次数、当前用量、当前/每小时用量与账户吞吐量;仅在归档记录存在、仍在保留期内且数据分类允许时检索;先对脱敏 fixture 复现,必要时经批准做一次有限实况复现;执行自动与人工脱敏检查,生成含哈希的清单,原始材料留在批准的故障边界内;共享支持所需的最小包,并记录接收者、目的、保留期与删除日期。
输出:返回包清单、脱敏上下文与元数据、Account API 容量快照、fixture/实况复现结果、哈希、脱敏证据与支持交接负责人。
错误处理:缺少 search ID 时从安全本地证据诊断,不要臆造归档查询;归档返回 410 时记录过期并在复现前请求批准;使用 ZeroTrace 时说明预期无归档并依赖本地脱敏证据;无法证明脱敏时不得导出。
限制:不编造功能与价格;示例 incident=SERP-42; engine=google; http=503; search_id=present; account_capacity=healthy; fixture=reproduced; live_replay=not-needed; secrets=0; bundle_sha256=recorded。后续:按期删除已共享的包,并把已解决的故障转为脱敏回归 fixture。