用途：为 Klaviyo 集成搭建 GitHub Actions CI/CD 流水线，实现自动化测试与密钥配置。
主要能力：采用标准双作业结构。unit-tests 作业使用模拟（vi.mock）的 klaviyo-api SDK，无需 API 密钥，可在每个 PR 上安全运行；integration-tests 作业依赖前者，仅在 main 分支推送时运行真实 Klaviyo API，避免在无法获取密钥的 fork PR 上调用真实接口。流水线还包含 tsc --noEmit、通过 npm list klaviyo-api 校验 SDK 版本，以及 API 连通性冒烟测试。
使用方式：先配置加密仓库密钥：gh secret set KLAVIYO_PRIVATE_KEY --body "pk_test_" 与 gh secret set KLAVIYO_WEBHOOK_SIGNING_SECRET --body "whsec_test_"。再创建 .github/workflows/klaviyo-ci.yml，定义两个作业；集成作业设置 if: github.event_name == 'push' && github.ref == 'refs/heads/main'，并注入 KLAVIYO_PRIVATE_KEY 与 KLAVIYO_TEST='1' 环境变量。测试分两套：单元测试模拟 SDK 且无需密钥；集成测试用 describe.skipIf 依据 KLAVIYO_TEST 与 KLAVIYO_PRIVATE_KEY 守卫，无密钥时自动跳过。本地运行集成测试：export KLAVIYO_TEST=1、export KLAVIYO_PRIVATE_KEY="pk_test_***"、npm run test:integration。
适用场景：需要为 Klaviyo 集成建立自动化测试、CI 密钥管理与真实 API 验证的 GitHub 仓库。
限制与前置条件：需启用 Actions 的 GitHub 仓库、来自测试/沙箱账户的 Klaviyo 测试 API 密钥，以及仓库中已配置 klaviyo-api SDK 与 Vitest。常见问题包括密钥未设置、集成测试遇 429 限流、密钥名与工作流环境变量不匹配、响应慢导致超时。完整工作流 YAML 与测试示例见其参考文档，本资料未提供具体价格或平台支持范围。