移除时间线
治理已弃用接口面何时可移除的日期和门控。属于 Plugin SDK 迁移 指南的一部分。
移除时间线¶
| 时间 | 发生的情况 |
|---|---|
| 现在 | 可发出警告的已弃用接口面会发出运行时警告；仓库守卫会拒绝来自核心和捆绑插件的已弃用 SDK 导入。 |
| 待所有者决定 | 没有 removeAfter 或 removalGate 的记录保持已弃用且不符合条件，直到其所有者发布门控。 |
deprecated 记录的 removeAfter 日期之后一天 |
在 00:00 UTC，该记录变为日期符合条件，并且 pnpm plugins:boundary-report --fail-on-eligible-compat 以非零状态退出。该日期本身是最终兼容日。 |
removal-pending 记录的 removeAfter 日期 |
在 00:00 UTC，报告会标记该记录到期需审查，并列出其阻塞项。它不会触发兼容性失败标志。 |
| 下一个 Plugin SDK 主版本 | inbound-reply-dispatch 和同步插件键控存储达到其显式的 next-plugin-sdk-major 门控；在该版本边界之前，二者均不满足日期条件。 |
以下其余公开 SDK 子路径具有基于注册表的移除窗口。 7 月 30 日的行在其早期维护者授权的清理后被移除： 未使用的子路径被删除，较早的兼容性别名被删除，并且 仅限捆绑的模块被降级为私有本地构建映射。
8 月 15 日的兼容性子路径 agent-config-primitives、
channel-logging、channel-secret-runtime、channel-streaming、
group-access、matrix、text-runtime 和 zod 于 2026 年 8 月经
SDK 所有者明确批准提前退役。请使用
Plugin SDK 子路径目录 中的针对性替代方案，并直接从 zod
包导入 zod。inbound-reply-dispatch 在下一个 Plugin SDK 主版本之前仍可用。
beta.5 整个会话存储桥接已于 2026 年 9 月 30 日经 SDK 所有者明确批准退役，
早于其原 10 月 12 日截止日期。
受支持插件截止日期排除了 v2026.7.1-beta.5 以及所有仍导入
这些桥接导出或包根级整个存储别名的版本。
在升级宿主之前，将受影响的插件升级到作用域行和转录身份 API。
session-store-runtime 子路径和 resolveStorePath
仍受支持；请参阅已移除的会话 API 及替代方案。
| 移除门控 | 层级 | SDK 子路径 |
|---|---|---|
next-plugin-sdk-major |
主版本兼容性门控 | inbound-reply-dispatch；api.runtime.state.openSyncKeyedStore 和 PluginStateSyncKeyedStore |
2026-10-01 |
媒体遗留投影 | agent-media-payload，以及非子路径 MsgContext Media* 字段、通道入站媒体负载构建器、buildMediaPayload、钩子媒体别名和 {{Media*}} 模板 |
五个兼容性子路径 channel-lifecycle、channel-message、
channel-reply-pipeline、config-runtime 和 infra-runtime 于 2026 年 9 月 30 日经
SDK 所有者明确批准提前退役。该决定
取代其 10 月 1 日门控和外部迁移保留阻塞项；它
并不证明每个外部插件都已完成迁移。它们的公开导出
和兼容性别名已被移除。在加载到包含此移除的宿主之前，
请升级受影响的插件。
这些子路径在 2026.8.2 中根据已批准的保留例外仍可用。2026 年 9 月 2 日，发布维护者为 2026.9.1
将其 removeAfter 日期从 9 月 1 日续期至 10 月 1 日。9 月 30 日
的决定取代了该窗口。请参阅通道导入映射
和配置与基础设施迁移
了解替代方案和行为差异。系统事件快照检查与消费
现在使用 openclaw/plugin-sdk/system-event-runtime。
捆绑插件迁移并不能证明每个外部调用方都可以使用
仅路径替代方案。迁移具有已验证类型化公开映射的函数；
当已移除的命名类型或所需行为缺少公开替代方案时，
调整调用方。不要替换为私有本地宿主导出。运行
pnpm plugins:boundary-report 以查看你的插件所使用的接口面的日期、门控和阻塞项。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw