name: idempotent-redundancy description: 幂等冗余 user-invocable: false
幂等冗余
当添加冗余路径(备用路径、冗余机制)时,使其具有幂等性。
模式
没有幂等性的冗余会导致循环、抖动或数据损坏。
推荐做法
- 使用
_is_merge: true进行Braintrust更新 - 在写入前检查值是否存在(仅在缺失时使用备用路径)
- 对于文件操作,使用原子写/重命名
- 使协调步骤可以安全地重复运行
避免做法
- 无条件地在备用路径中写入
- 允许多个写入器相互覆盖
- 触发可能引发更多修复的“修复”操作
来源会话
- a541f08a: “冗余只有在幂等时才有效”
- 1c21e6c8: “冗余机制,但要使其幂等”
- 6a9f2d7a: “幂等修复钩子”