跳转至

移除时间表

这些日期和门禁决定了已弃用 API 表面何时变为可移除。它是 Plugin SDK 迁移 指南的一部分。

pnpm plugin-sdk:surface:check 独立于导出数量预算,强制执行最新稳定版本已提交的类型化公共 API 表面。移除已发布的子路径或命名导出需要一个覆盖的 deprecated、removal-pending 或 removed 兼容性记录,并且其 removeAfter 日期严格早于当前 UTC 日期;仅有 removalGate 并不授权移除。没有 types 导出条件的打包私有运行时门面被排除,因为它们不是声明的类型化公共契约。

移除时间线

何时 发生什么
现在 支持警告的已弃用 API 表面会发出运行时警告;仓库守卫会拒绝来自核心和捆绑插件的已弃用 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、同步插件键控存储、内存会话清单读取器、同步 Mention Inbox 持久化方法以及同步会话/扩展/提供者重放持久化达到其显式 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;loadArchivedSessions 和 resolveMemorySessionTargets;mentionInbox.list、mentionInbox.dismiss、mentionInbox.recordCommittedInput 和 mentionInbox.invalidate;同步 SessionManager、扩展会话和提供者重放持久化契约
2026-10-01 媒体遗留投影 agent-media-payload,以及非子路径 MsgContext Media* 字段、通道入站媒体负载构建器、buildMediaPayload、钩子媒体别名和 {{Media*}} 模板
移除门控 层级 SDK 子路径

五个兼容性子路径 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。

兼容性子路径 command-auth、discord 和 telegram-account 已于 2026 年 10 月 2 日经 SDK 负责人明确批准提前退役。该 决定关闭了它们的兼容性窗口;它并不证明每个 外部插件都已完成迁移。它们的公共导出已被移除。在包含此移除项的主机上加载受影响插件之前,请先升级这些插件。请参阅 命令和通道门面替代方案。

捆绑插件迁移并不能证明每个外部调用方都可以使用 仅路径替换。迁移具有已验证类型化公共映射的函数; 当被移除的命名类型或必需行为缺少 公共替代方案时,请调整调用方。不要替换为私有本地主机导出。运行 pnpm plugins:boundary-report 以查看你的插件所使用的 接口面的日期、门控和阻塞项。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw