grid-qa

排查"功能静默失效"（rerank 没生效/图谱没融合/缓存没命中）时使用。项目所有降级走 DEGRADED 指标+日志，用它定位。

改了项目代码/配置后，判断该 rebuild 哪个镜像、哪些走 HMR、.env 改动要不要重建容器。避免"改了没生效"的最常见坑。

排查检索召回差/路由偏差/改写没效果/某文档召不出问题时使用。用 debug_search 透出每步中间结果定位。

排查问答缓存问题（不命中/脏缓存/黑名单误拦/置信度过滤/多轮不缓存）时使用。覆盖三级缓存(Redis/MySQL/Semantic)+黑名单+置信度规则。