agent-coherence

当两个AI代理（或两个会话、一个代理与一个脚本）同时读取同一文件并分别写回时，后写入的操作会静默覆盖先前的写入：没有错误提示，但工作成果就此消失。agent-coherence 是一个即插即用的防护工具，能够在覆盖操作发生前检测到过时的读取，从而拒绝过时的写入者，并强制其重新读取最新数据。

核心功能

• 冲突检测：在写入前检查文件是否已被其他代理修改，避免静默覆盖。
• 自动重试：当检测到冲突时，拒绝写入并提示代理重新读取最新版本。
• 多形态部署：提供 MCP 服务器、LangGraph 存储插件 和 Python 库 三种集成方式。

主要特性

• 即插即用：无需修改现有代码，只需替换文件操作接口即可。
• 形式化验证：核心逻辑经过 TLA+ 验证，确保正确性。
• 单机高效：当前支持单机多代理场景（2个以上代理在同一台机器上）。
• 开源透明：代码完全开源，可审计、可定制。

适用场景

• 多代理协作：多个AI代理同时读写共享文件（如配置文件、中间结果）。
• 人机协作：人类与AI代理同时编辑同一文档。
• 自动化流水线：多个脚本或工具链并发处理同一文件。

agent-coherence 为共享状态操作提供了安全保障，让AI代理协作更加可靠。