记录 contract
让维护者知道到底在保护哪条旧规则。
Plugins 导读
新本领插件 compatibility：这块新积木往哪儿卡
新本领插件 compatibility 这页像在教你把一块新积木卡进主机身上。你先看它负责哪段本领、说明纸塞在哪里、外面的世界怎么从它这道门进来，以及哪些 secret、route、manifest 最不能写歪。原文最响的一记鼓点，其实是：OpenClaw keeps older 新本领插件 contracts wired through named compatibility adapters before…。
先讲这一页到底在解决什么
新本领插件 compatibility：这块新积木往哪儿卡
新本领插件 compatibility 这页像在教你把一块新积木卡进主机身上。你先看它负责哪段本领、说明纸塞在哪里、外面的世界怎么从它这道门进来，以及哪些 secret、route、manifest 最不能写歪。原文最响的一记鼓点，其实是：OpenClaw keeps older 新本领插件 contracts wired through named compatibility adapters before…。
第一站
兼容层不是怀旧，是防止用户的旧工具突然断电
如果一个旧插件昨天还能用，今天升级后突然不认识新系统，用户会很难排查。compatibility adapter 就像临时转接头，让旧插件还能说上话。
旧契约
像旧插头的形状，插件已经按这个样子做出来了。
新契约
像新插座，更清楚、更强，但形状可能变了。
Adapter
像中间转接头，帮助旧插件继续接入。
第二站
兼容记录要放在登记册里，不能靠记忆
官方提到核心 registry。它像一本值班登记册，记录哪些旧规则还被支持、哪些已经被替换、哪些将来会移除。
外部 inspector
检查插件包时，最好让检查器跟着版本化规则走。
验收 lane
用干净环境跑测试，确认外部包真的能装、能加载。
废弃通知
不能在推出替代品的同一版里马上拆掉旧规则。
最后记住
兼容策略是在保护升级路上的人
好的兼容层会让新系统继续往前走，也让旧插件有时间换新接口。它不是永远保留旧东西，而是给迁移留出清楚的桥。