k2safe/orbit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: record verified v0.1.0 remote SDK release

Browse Source
This commit is contained in:
k2safe
2026-09-20 23:10:57 +08:00
parent 0e8b2ef297
commit bf76f13430
5 changed files with 47 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/sdk/release.md
View File

@@ -40,6 +40,6 @@ go mod verify
仓库主分支为 `main`。服务端标签 `v0.1.0` 和独立 SDK 标签 `sdk/go/v0.1.0` 指向同一发布提交；Go 子模块标签必须包含 `sdk/go/` 前缀，业务端的模块版本不带此前缀。已发布标签保持不可变，修复使用新的补丁版本。`v0.1.0` 用于开发与测试接入，正式生产仍需完成[交付核对清单](../release-checklist.md)。
发布后需在仓库外新建业务 module、使用空模块缓存和 `GOWORK=off`，通过匿名远端下载，执行 `go mod tidy`、编译、SDK 调用 smoke 和 `go mod verify`，确认解析版本精确为 `v0.1.0` 且不存在 `Replace`。后续发布继续重复这一步，并按[兼容矩阵](compatibility.md)验证旧/新组合。
`v0.1.0` 已在仓库外的新业务 module、空模块缓存和 `GOWORK=off` 下通过公开远端下载、`go mod tidy`、编译、SDK HTTP smoke 和 `go mod verify`，解析版本精确为 `v0.1.0` 且不存在 `Replace`。发布提交、校验和与网络条件见[远端验证报告](../reports/phase-7-sdk-remote-release.md)。后续发布继续重复这一步，并按[兼容矩阵](compatibility.md)验证旧/新组合。
本地联调可以临时添加 `replace`，但不能提交到业务项目的发布分支。SDK 不负责 TLS 终止、凭据托管、对象存储或外部副作用核查；这些边界仍由平台接口手册和接入方运行手册定义。