用途:为 Customer.io 配置相互隔离的开发、CI、预发与生产工作区,每个工作区使用独立的 Site ID、Track API Key 与 App API Key,并配合带校验的类型化配置与环境感知客户端,防止跨环境数据泄漏。
主要能力:定义 CioEnvConfig 并在启动时校验(如生产环境禁止 dry-run、禁止事件前缀);封装 EnvAwareCioClient,在非生产环境为事件与用户 ID 加前缀并注入 _cio_env 标记,dry-run 时仅打印日志不发送;通过 .env.development、.env.staging、.env.production 与 Kubernetes ConfigMap 基础文件加各环境 overlay patch 管理配置;提供 scripts/verify-isolation.ts 用独立凭据逐环境 identify 后 suppress、destroy 清理;提供 GitHub Actions workflow_dispatch 晋级工作流,在目标环境跑冒烟测试后部署。
使用方式:先在 fly.customer.io 创建多个工作区,准备环境变量管理与按环境部署的 CI/CD;按步骤创建配置与客户端文件;本地可运行 npx tsx scripts/verify-customerio.ts 做冒烟测试。
适用场景:需要 dev/staging/prod 多工作区隔离、环境感知客户端、Kubernetes 配置覆盖与安全晋级的团队。
限制:资料未提供依赖版本、完整安装命令、收费与价格信息;晋级流程中的回滚实现细节、synthetic 校验与审批步骤未给出具体代码。