用途：为 Fathom 会议智能集成搭建 CI/CD，验证转录、摘要与行动项的数据解析逻辑，以及实时会议事件的 webhook 处理。
主要能力：在拉取请求上运行确定性的 schema、映射、模板与单元检查，无需凭据；仅在受保护分支上运行实时合成集成检查。提供无凭据的 PR 校验通道，以及使用开发凭据的受信任集成通道，并保留脱敏证据。
使用方式：前置条件包括受保护仓库、模拟固件、必需检查，以及单独作用域的开发凭据。GitHub Actions 工作流按路径触发 PR、按 main 分支推送触发，先跑单元测试，再跑集成测试，集成步骤通过 secrets.FATHOM_API_KEY 注入密钥。模拟单元测试以 vi.mock 替换客户端，断言行动项抽取结果；集成测试通过 fetch 调用 https://api.fathom.video/v1/meetings?limit=1 并带 Bearer 令牌，缺少密钥时跳过。
适用场景：验证会议转录解析、行动项抽取、CRM 映射与 webhook 处理，在合并到 main 时检查实时 API 连通性。
限制：需限定重试与资源，保留脱敏证据，生产部署审批需独立进行。不得向分叉代码暴露 Fathom/CRM 凭据或真实会议数据。常见问题包括 401 密钥失效、会议列表为空、转录仍在处理、webhook 签名不匹配与 429 限流，各自有对应处置。更多部署细节见 fathom-deploy-integration。