test: add current protocol compatibility gate

2026-09-20 01:30:28 +08:00
parent 88ec4545b4
commit 695dc969aa
10 changed files with 165 additions and 5 deletions
--- a/docs/sdk/release.md
+++ b/docs/sdk/release.md
@@ -25,6 +25,8 @@ sh scripts/test-sdk-isolation.sh

 `package_count` 随示例增加而变化，不能作为兼容性版本号。门禁只证明源码在当前 Go 工具链下保持独立和可构建，不代表已经发布到远端模块代理，也不替代旧 SDK/新服务端和新 SDK/旧服务端的协议兼容矩阵。

+协议版本、WebSocket 子协议、流程 schema 和数据库版本见[兼容矩阵](compatibility.md)。发布候选还必须执行仓库根目录的 `make protocol-check`；它检查当前服务端、SDK 和机器可读 schema 是否仍在同一协议线，不把历史版本组合标记为已验证。
+
 ## 接入方式

 SDK 尚未发布正式标签时，开发项目可以使用本地 replace；发布候选必须使用独立 module 的版本标签和干净 checkout 验证。接入方应固定 SDK 版本，升级前先执行自己的接口和业务幂等回归：