Module compat_lock 

compat.lock.toml - 运行时兼容性协商缓存

当服务发现无法找到精确匹配但找到兼容匹配时，会创建此文件。 此文件的存在表示系统处于亚健康状态 (SUB-HEALTHY)。

功能

• 缓存协商结果，避免重复进行兼容性检查
• 记录系统健康状态，方便运维监控
• 提供快速启动路径，优先尝试已知兼容版本

存储位置

此文件存储在操作系统的临时目录中，而非项目目录：

• Linux/macOS: /tmp/actr/<project_hash>/compat.lock.toml
• Windows: %TEMP%\actr\<project_hash>\compat.lock.toml

project_hash 是根据项目根目录绝对路径计算的唯一哈希值， 确保同一机器上多个 Actor 实例各有独立的缓存。

注意

此文件不应提交到版本控制，因为它反映的是运行时状态。

Structs

CompatLockFile

compat.lock.toml 文件结构

CompatLockManager

兼容性协商管理器 - 运行时使用

NegotiationEntry

兼容性协商记录

Enums

CompatLockError

compat.lock 相关错误

CompatibilityCheck

兼容性检查结果