用途：诊断并修复 Customer.io 集成中最常见的错误，包括 API 状态码、SDK 异常、投递失败、活动触发问题与事务消息问题。
主要能力：提供 HTTP 状态码参考（200、400、401、403、404、408、422、429、500、503）及是否可重试与对应动作；按错误类型给出排查步骤，如认证失败（401/403）、时间戳格式（400）、事件未触发活动、事务消息失败（422）、限流（429）、EU 区域不匹配、用户收不到邮件等。
使用方式：需具备 Customer.io 仪表盘访问权限、已配置 API 凭据、可访问应用日志。可用 curl 测试 Track API 与 App API 认证，例如：curl -s -w "\nHTTP %{http_code}\n" -u "$CUSTOMERIO_SITE_ID:$CUSTOMERIO_TRACK_API_KEY" -X PUT "https://track.customer.io/api/v1/customers/test-diag" -H "Content-Type: application/json" -d '{"email":"diag@example.com"}'；也可查询状态页 https://status.customer.io/api/v2/status.json。代码层面建议实现退避与幂等，遇到 429 时尊重 Retry-After 头，避免洪泛重试或关闭限流。
适用场景：排查 API 报错、SDK 异常、投递失败、活动触发异常、事务消息发送失败等集成问题。
限制：资料未提供具体收费、价格、平台支持范围或效果保证；部分错误原因需结合仪表盘与日志确认。处理敏感属性时应先脱敏诊断数据并校验数据契约，再重试。