docs: record verified v0.1.0 remote SDK release

This commit is contained in:
2026-09-20 23:10:57 +08:00
parent 0e8b2ef297
commit bf76f13430
5 changed files with 47 additions and 5 deletions

View File

@@ -0,0 +1,42 @@
# P7:首个远端 SDK 接入版本
验证日期:2026-09-20。仓库为公开的 [k2safe/orbit](https://git.yuntuo.hk/k2safe/orbit),默认分支为 `main`。本批完成源码推送、独立 SDK 版本发布和真实外部项目取包验证。
## 发布身份
| 发布物 | Git 标签 | 不可变源码提交 |
| --- | --- | --- |
| Orbit 服务端 | `v0.1.0` | `0e8b2ef2975df6b55f2240dd14eda83adf30ea94` |
| 独立 Go SDK | `sdk/go/v0.1.0` | `0e8b2ef2975df6b55f2240dd14eda83adf30ea94` |
通过公开 Git 远端读取标签并解引用,确认两个标签指向同一提交。仓库 API 返回 `private=false`、`empty=false`、`default_branch=main`。`main` 后续可以继续更新文档和代码,接入方应固定上述 SDK 版本。
## 外部项目验证
环境为 Go 1.27.1、darwin/arm64。在仓库外创建 `example.com/orbit-remote-consumer`,使用空 `GOMODCACHE`、独立 `GOPATH`、`GOWORK=off` 和 `GOENV=off`;未添加任何 `replace`。关闭 Go HTTP 身份认证及全局 Git 配置,SDK 通过公开代理下载。
本机 Go 进程直连代理发生网络超时。最终使用 `GOPROXY=https://goproxy.cn,direct`,并仅在验证进程中沿用系统已有的 HTTP/HTTPS 网络代理。保留 `GOSUMDB=sum.golang.org`,未设置 `GOPRIVATE` 或 `GONOSUMDB`,未关闭校验和验证,也未修改用户全局 Go/Git 设置。
| 验证 | 实际结果 |
| --- | --- |
| `go get git.yuntuo.hk/k2safe/orbit/sdk/go@v0.1.0` | 从空缓存下载 SDK 和 `github.com/coder/websocket v1.8.15`,退出 0 |
| `go mod tidy` | 退出 0 |
| 外部项目 `go build` | 退出 0 |
| 外部项目运行 SDK HTTP smoke | 真实调用本地 `httptest` HTTP 服务的健康接口,输出 `remote_sdk_http_smoke=passed`,退出 0 |
| `go mod verify` | `all modules verified`,退出 0 |
| `go list -m -json` | `Version=v0.1.0`、`GoVersion=1.27.1`、无 `Replace` |
| 本地独立 SDK 门禁 | race、vet、build 通过;30 个包,禁止依赖为 0 |
| 协议与文档门禁 | 当前 HTTP/Worker/Event/schema 契约匹配,Markdown 本地链接检查通过 |
下载得到的模块校验和:
```text
git.yuntuo.hk/k2safe/orbit/sdk/go v0.1.0 h1:OJp+U8dDNKjiXy4ZhO4MMq68Ek8TkjphUAqsjOOg77c=
git.yuntuo.hk/k2safe/orbit/sdk/go v0.1.0/go.mod h1:9KlMW7Gy+EGaDoEwr3wHHFY47mnAymSfYeQpMS7h4ag=
```
业务接入命令、导入方式和场景见 [SDK 手册](../sdk/README.md#5-外部项目通过远端接入)。若网络无法访问默认模块代理,可单次执行 `GOPROXY=https://goproxy.cn,direct go get git.yuntuo.hk/k2safe/orbit/sdk/go@v0.1.0`;需要网络代理的环境应让 Go 进程使用可用的网络代理,不需要关闭模块校验。
## 结论与边界
业务项目可以固定 `v0.1.0` 进行开发和测试接入,无需取得本机源码或配置本地替换。本批验证远端发布与取包,没有重新声明生产环境验收完成;真实 MySQL/进程全量回归沿用[已记录结果](phase-7-regression-status.md),生产容量、数据库自动切换、完整跨标签矩阵和运维条件仍按[交付清单](../release-checklist.md)完成。