移除时间表
这些日期和门禁决定了已弃用 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