用途：当运行时出错（URL 返回 500、部署不可用、临时环境行为异常）时，先看实际发生了什么，再改代码。
主要能力与用法：
- 复现并记录真实故障（状态码、错误、请求 id、时间）。
- 优先查可观测性：日志、追踪、指标。若已连接可观测性 MCP（如 Datadog）则使用，否则回退到平台日志流（CI 任务、容器、Jenkins、云日志）。
- 依据证据定位出错服务和代码行，而非猜测。
- 修复真实原因，不把只加日志的“修复”当作完成。
- 对有意设置的实验/临时配置（测试密钥、fail-open），不要误报警，保留所需环境变量。
MR 本地预览：请求本地链接时，应针对现有 Docker 数据存储启动真实 worktree 应用，而非用截图集替代。先检查 Docker Desktop 和现有容器，再使用 worktree 的 Node 18.20.4 并显式设置 NODE_ENV=local / NODE_PATH。分别验证 /200 和请求页面：服务健康时若 Mongo 无 CMS 内容仍可能返回 404。恢复前先检查本地 CMS 集合计数；空的 Atlas Local 容器需要脱敏种子数据；启动大刷新前检查缓存归档与下载大小，尤其在受限连接下。不要仅为启动服务器而重置或重新播种现有数据。
研究预览延迟：改公共页面前，先把中间件 TTFB 与图片/渲染时间分开。在 portal 应用中，本地预览若未配置 Upstash Redis，即便页面是静态的，限流调用也可能重试数秒。复用现有 Docker Redis 和 serverless-redis-http 服务及其映射端口。重连预览后先验证 HTTP 链路，再验证页面的限流响应头；不要为让本地计时看似更快而绕过生产限流。当 Vercel 预览检查点拒绝 curl/无头请求时，使用有头 Chrome。按堆栈 URL 归因第三方预览工具栏异常，而非隐藏所有页面错误。对减少动效证明使用精确作品元素裁剪对比；整屏截图会包含动画预览外壳。
pnpm 部署安装：冻结安装失败即视为部署阻塞，即便直接调用 Next 能构建成功。对 ERR_PNPM_IGNORED_BUILDS，检查确切的依赖生命周期脚本和被跟踪的 pnpm-workspace.yaml；pnpm 可能在本地生成被忽略的占位决策。提交经审查的、明确版本范围的允许/拒绝决策，对未知版本保持严格检查开启，并在重新部署前验证正常的冻结安装/构建路径。
限制与禁忌：不要在读日志前推测性重写代码；不要未重新检查运行时就说已修复。