用途：当常规排查无法定位 HubSpot API 问题时，用系统化分层测试与证据收集来隔离故障点，并整理可提交给官方支持的证据。
主要能力：
- 分层诊断：依次检查 DNS 解析、TCP 443 连通性、TLS 握手、未认证 HTTP 响应、认证请求、限流状态，逐层定位失败位置。
- correlationId 追踪：在 API 调用包装中记录时间戳、correlationId、状态码、category、message 与 endpoint，并汇总为支持工单可用的错误报告。
- 耗时分析：对获取联系人、搜索联系人、获取管道、获取属性等操作各执行多次，输出最小、最大、平均耗时与失败次数。
- 错误复现：提供快速连续请求测试（观察 429 限流）与并发请求测试（观察连接池或并发问题）。
- 支持升级模板：包含严重级别、Portal ID、correlationId 列表、复现步骤、错误响应、环境、时间线与已尝试方案。
使用方式：需可访问应用日志，环境中有 curl 与 jq，并准备 HubSpot access token 用于手动测试。按步骤先跑分层脚本，再接入 correlationId 记录与耗时分析，最后用模板整理证据。
适用场景：间歇性 500、认证突然失效、延迟尖峰、限流敏感、并发失败等难以复现的 CRM API 问题。
限制：资料未提供具体版本兼容范围、配额数值或官方支持响应时限；脚本中的令牌、Portal ID 等需自行替换，实际结果取决于账号权限与网络环境。