本页内容
本页内容
插件内部
移除时间表
控制已弃用表面何时可移除的日期和门限。 Plugin SDK 迁移 指南的一部分。
pnpm plugin-sdk:surface:check 独立于导出计数预算强制执行最新稳定版本的承诺类型公共表面。删除已传送的子路径或命名导出需要覆盖 deprecated、removal-pending 或 removed 兼容性记录，其中 removeAfter 日期严格早于当前 UTC 日期；仅 removalGate 并不授权删除。没有 types 导出条件的打包私有运行时外观被排除在外，因为它们没有声明类型化公共合约。
移除时间线
| 什么时候 | 会发生什么 |
|---|---|
| 现在 | 可发出警告的已弃用接口会发出运行时警告；仓库防护措施会拒绝核心和捆绑插件导入已弃用的 SDK 接口 |
| 等待所有者决策 | 没有 removeAfter 或 removalGate 的记录仍保持已弃用状态，在其所有者发布门控之前不具备移除资格 |
deprecated 记录的 removeAfter 日期后的天 |
在 00：00 UTC，该记录变得符合日期条件，并且 pnpm plugins:boundary-report --fail-on-eligible-compat 以非零值退出。该日期本身就是最终兼容日。 |
A removal-pending 记录的 removeAfter 日期 |
在 00：00 UTC，报告标记该记录需要审核并列出其阻止程序。它不会触发兼容性失败标志。 |
| 2026-12-31 — 最终 SQLite 兼容性日 | 已弃用的同步 SQLite-backed 成员在此日期之前保留其已发布的合约。在升级到 1 月删除版本之前，请迁移到记录的 async/V2 替换版本。 |
| 2027 年 1 月第一个稳定版本 | 在下一个稳定版本发布警告和迁移指南后，删除过时的同步 SQLite 兼容性成员。不需要 SDK 专业。日期门首次允许移除日期为 2027 年 1 月 1 日 UTC。 |
| 其他普通稳定释放闸门 | inbound-reply-dispatch 和已弃用的提及收件箱签名保留单独的、未注明日期的 stable-deprecation-period 门。它们的主人必须宣布一个窗口并授权拆除。 |
下面其余的公共 SDK 表面具有注册表支持的删除窗口。对于同步 SQLite- 支持的系列，removeAfter 是 2026-12-31，删除目标是 2027 年 1 月第一个稳定版本。在 main 上写入的弃用元数据并不能证明稳定版本中包含警告。下一个稳定版本必须宣布此窗口并发布警告和迁移说明；地表守卫仍必须看到已达到的日期。此准备工作增加了弃用和替换，但不删除公共成员。请参阅完整成员迁移表、等待迁移说明和转录和TTS替换。 7 月 30 日的行在早期维护者授权的清理后被删除：未使用的子路径被删除，早期的兼容性别名被删除，仅捆绑的模块被降级为私有本地构建映射。
8 月 15 日的兼容性子路径 agent-config-primitives、channel-logging、channel-secret-runtime、channel-streaming、group-access、matrix、text-runtime 和 zod 已通过显式提前停用SDK-所有者于2026年8月批准。使用插件SDK子路径目录中的重点替换，并直接从zod包导入zod。 inbound-reply-dispatch 仍然可用，直到所有者授权在以后的稳定版本中删除为止。
beta.5 全会话存储桥已于 2026 年 9 月 30 日（比原定的 10 月 12 日截止日期提前）退役，并获得 SDK-owner 的明确批准。支持的插件截止排除了 v2026.7.1-beta.5 以及仍然导入这些桥导出或包根全商店别名的所有版本。在升级主机之前，将受影响的插件升级到作用域行和转录本身份 API。 session-store-runtime 子路径和 resolveStorePath 仍受支持；请参阅 删除的会话 API 和替换 。
| 移除门控 | 层级 | SDK 子路径 |
|---|---|---|
2026-12-31； 2027 年 1 月稳定 |
最终兼容性日/删除版本 | 同步 SQLite- 支持 session/transcript、插件状态、绑定、auth/provider、channel/approval、工作区、代理捕获、技能发现、运行时配置和迁移指南中记录的 TTS 准备 API。 |
| 后来的普通稳定版——TBD | 需要业主迁移 | inbound-reply-dispatch 和已弃用的提及收件箱签名具有单独的未注明日期的窗口。 |
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-owner 明确批准提前停用。该决定取代了 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-owner 明确批准提前停用。该决定关闭了它们的兼容性窗口；它并不证明每个外部插件都已迁移。他们的公共出口被删除。在将受影响的插件加载到包含此删除的主机上之前，先升级它们。请参阅 命令和通道外观替换 。
捆绑插件迁移并不能证明每个外部调用者都可以使用仅路径替换。使用经过验证的类型公共映射迁移函数；在删除的命名类型或所需行为缺乏公共替换的情况下调整调用者。不要替换私有本地主机导出。运行 pnpm plugins:boundary-report 以查看插件使用的表面的日期、大门和拦截器。