用途:让 Attio 相关开发在本地快速迭代,同时避免把共享 CRM 变成测试夹具。默认采用离线契约,实盘写入必须显式且可丢弃。
主要能力:区分离线请求/响应契约与实盘集成测试;提供成功、校验失败、授权失败、限流和分页终止等脱敏夹具;设置本地配置守卫,识别工作区并默认禁用写入;在必要时执行有界实盘操作并记录清理台账。
使用方式:先定位 Attio 客户端边界、映射、重试策略和既有夹具约定;定义脱敏夹具;加本地配置守卫;编辑映射或响应归一化时运行最小离线测试;确需实盘行为时,先显示工作区和可丢弃目标,再启用一次有界操作;记录创建的资源 ID 到清理台账,审查后清理并验证不存在。离线输入示例:mode=offline-first; workspace=development; live-writes=disabled,预期交接为 fixtures=pass; guard=pass; live-test=not-needed; leaked-data=0。
适用场景:Attio 本地开发、集成测试、映射与响应归一化调试,以及需要避免污染生产 CRM 数据的迭代。
限制:需具名仓库与测试运行器、脱敏成功和错误夹具、开发 Attio 工作区或经批准测试边界,以及清理台账。认证使用最小权限开发工作区令牌,通过本地密钥注入,不得写入提交的环境文件、夹具、命令记录或快照。实盘写入、模式变更、批量操作和清理删除需经批准的非生产目标;若无法证明工作区身份,则保持离线。不得将生产 CRM 载荷复制到夹具;分页夹具必须匹配所选端点的 offset 或 cursor 契约。错误处理:夹具含真实 CRM 数据须移除并用合成值重新生成;工作区白名单失败则保持写入禁用;实盘响应漂移须在文档复查后有意更新契约;清理失败须停止后续写入并报告确切的 disposable ID。其他官方细节暂未提供。