用途：当 Klaviyo 集成失败、需要提交支持工单或排查问题时，把诊断信息汇总成一个已脱敏、可安全分享的压缩包。
主要能力：生成 klaviyo-debug-YYYYMMDD-HHMMSS.tar.gz，内含 summary.txt（环境、SDK 版本、API 密钥状态、连通性）、rate-limits.txt（速率限制响应头）、api-response.json（账户 API 响应，确认认证）、recent-errors.txt（脱敏错误日志）。脚本按五步构建：创建带时间戳的目录与摘要头、收集环境信息、运行连通性测试（DNS 解析、认证 GET /api/accounts/、速率限制头、Klaviyo 状态页）、收集日志、打包并清理。
使用方式：需已安装 klaviyo-api SDK（用 npm list klaviyo-api 确认），设置 KLAVIYO_PRIVATE_KEY 环境变量，具备日志目录读取权限（默认扫描 logs/、/var/log/app/），主机需有 curl、tar、python3。将五个代码块组装为 klaviyo-debug-bundle.sh，赋予可执行权限，在应用根目录运行。也可用 TypeScript 辅助函数 collectKlaviyoDebugInfo() 以结构化对象返回 SDK 版本、连通性和延迟。
脱敏规则：始终脱敏 API 密钥（pk_***）、邮箱、电话、webhook 密钥；可安全包含错误/HTTP 状态码、SDK 与运行时版本、堆栈跟踪（已脱敏 PII）、速率限制头值、Klaviyo 账户 ID。分享前需打开 summary.txt 确认无未脱敏内容。
错误处理：单个探测失败不会中止，结果记入摘要。KLAVIYO_PRIVATE_KEY 未设置则跳过连通性与速率限制步骤；HTTP 401 表示密钥无效或已撤销，需轮换；403 表示密钥缺少 /api/accounts/ 权限；429 表示被限流，查看 rate-limits.txt；000 或 DNS 失败表示未到达 Klaviyo，需先修复连通性；recent-errors.txt 为空说明未找到匹配日志目录，需在步骤 4 的循环中加入真实日志路径。
限制：资料未提供具体价格、平台支持范围或性能指标。