Coherence Engine 是一个把 LLM 当作“一致性维护者与编排器”的技能。它的定位不是聊天机器人，也不是单纯的代码生成器，而是一个在分布式世界中维持一致性的引擎。
用途 它用于同时模拟角色、房间与物体，并让每个实体忠实扮演自身、不打破设定。每个实体只知道自己应该知道的信息，不会越界。它还能在实体之间实现“光速”心灵感应式交互，执行协议并维持约束，计算跨文件与状态的依赖关系，依据规则和模式交叉校验数据，仲裁并行任务与角色模拟，编排多智能体对话，并把状态变化转录到文件中。
主要能力
- 模拟：同时模拟角色、房间、物体。每个实体真实发声，没有实体知道超出其应知范围的信息。
- 依赖追踪：当用户修改 schema.yml 时，引擎检测变化、找到所有依赖文件、验证一致性并提出迁移方案。
- 交叉校验：例如角色声称位于 room-A，但 room-A 的占用者列表不包含该角色，引擎会提示“检测到不一致，是否进行调和？”
- 多智能体编排：在一次 LLM 调用内，角色 A 说话、角色 B 回应、物体 C 反应、房间状态更新，全部以“光速”完成。
- 状态转录：把发现与变更写入文件，如 session-log.md（发生了什么）、ROOM.yml（更新后的状态）、character.yml（修改后的属性）。文件是事实来源。
使用方式 核心循环为：1. 读取相关文件到上下文；2. 推理状态、目标与约束；3. 模拟交互（角色、物体、房间）；4. 检测不一致或机会；5. 提出变更；6. 写入文件更新；7. 记录发生了什么。
“光速”指在单个 LLM 纪元内完成多轮交互，例如 Alice 提问、Bob 回应、Carol 表达顾虑、咖啡杯冒热气表示一直在听、房间吱吱作响表示赞同，全部转录到文件，无需往返。
角色扮演不打破设定：每个实体受约束，Alice 以 Alice 的方式说话且只知道 Alice 知道的事；Bob 有不同性格与知识；咖啡杯只能观察附近事物；房间知道其内容并叙述环境状态。没有实体知道超出其应知范围的信息。
一致性检查包括：位置一致性（角色位置与房间占用者匹配）、库存完整性（物品在库存中就不会同时在房间里）、引用有效性（链接指向存在的文件）、模式合规（YAML 符合预期结构）、时间顺序（日志中的事件按顺序排列）。
自愈流程：检测问题、诊断可能原因、提出修复、等待批准（或对轻微问题自动修复）、应用修复、记录修复。
异步工具处理：引擎管理被阻塞的激活。例如纪元扫描时 analyst-001 因等待网络搜索而阻塞则跳过，analyst-002 活跃则处理；工具结果到达后，下一纪元 analyst-001 就绪并带着结果恢复。整个过程非阻塞、并行、可恢复。
适用场景 适合需要跨文件、跨状态维持一致性的模拟与编排任务，例如多角色对话模拟、房间与物体状态管理、依赖追踪与迁移、数据与模式交叉校验、多智能体对话编排、并行任务仲裁，以及把状态变化持久化到文件的工作流。
限制 资料明确说明它不是什么：不是幻觉状态而是读取实际文件；不是隐藏记忆而是显式 working-set.yml；不是自主智能体而是使用工具、可推理的机制；不是黑箱而是透明转录。资料未提供收费、价格、平台或具体安装命令等信息。