用途:在常规本地开发循环中使用 Fathom 集成,流程为小范围改动、合成数据验证、审查、聚焦测试与可回滚提交。
主要能力:使用仅限开发的数据与身份做单点集成或配置改动;检查 diff、运行聚焦的 mock/单元检查,并执行有边界的合成工作流测试;将审查过的改动单独提交,仅通过正常受保护流程推进。产出为带测试证据和正常回滚路径的小改动,且不涉及生产会议或联系人数据。
使用方式:前置条件包括干净或可恢复的分支、开发凭据、合成会议/CRM 夹具、仓库规则与测试命令。项目结构示例含 src/fathom_client.py、transcript_processor.py、webhook_handler.py,tests/fixtures/meeting.json、transcript.json,以及 .env.local、requirements.txt。可用模拟数据运行:FATHOM_MOCK=true python3 src/transcript_processor.py;使用真实 API 运行:python3 src/transcript_processor.py。
适用场景:构建会议分析工具、测试 webhook 处理器、迭代 Fathom 集成配置。
限制与错误处理:若合成测试暴露真实数据,应停止、限制访问并遵循数据流程;CRM 映射或测试失败时,在范围内回滚或修正,不得用生产记录诊断;工作树混杂时,提交前分离无关改动。测试失败或出现无关文件变更时,应回滚或拆分工作,而不是禁用检查或让本地工具指向生产。后续可参考 fathom-sdk-patterns 了解生产 API 封装。