OpenSoha 0.1.x 发布说明
OpenSoha 各组件采用独立的语义化版本。一次发布组合用于记录彼此兼容的公开产物,不要求所有仓库、运行时镜像、npm 包和 Helm chart 使用同一个版本号。
Core、Web、Contracts、CLI、Agent、Skills 和 Connectors 现已统一从主仓 opensoha/soha 按组件标签发布;opensoha/soha-operator 与 opensoha/soha-helm 继续保持独立仓库与发布周期。
2026 年 11 月合仓发布组合
| 组件 | 版本 / 标签 | 公开产物 |
|---|---|---|
| Contracts | contracts/v0.2.0 | @opensoha/contracts@0.2.0、Go 模块 github.com/opensoha/soha/contracts@v0.2.0 与 GitHub Release |
| Soha 控制面(含内嵌 Web) | v0.1.13 | GitHub Release 附件为 soha-linux-amd64、soha-linux-amd64.sha256 与 soha-release-manifest.json;Web 已内嵌在二进制和 ghcr.io/opensoha/soha:v0.1.13 中,另有配套 soha-network-gateway、soha-proxy-mihomo、soha-proxy-sing-box、soha-proxy-v2ray、soha-radius 同版本镜像 |
| Soha CLI | cli/v0.2.1 | GitHub Release 、@opensoha/cli@0.2.1、Go 模块 github.com/opensoha/soha/cli@v0.2.1 与 ghcr.io/opensoha/soha-cli:v0.2.1 |
| Soha Agent 与运行时 | agent/v0.2.0 | GitHub Release 、ghcr.io/opensoha/soha-agent:v0.2.0、ghcr.io/opensoha/soha-dsh:v0.2.0、ghcr.io/opensoha/soha-docker-volume-reader:v0.2.0、ghcr.io/opensoha/soha-buildpacks-agent:v0.2.0 与 ghcr.io/opensoha/soha-buildpacks-agent:daemonless-v0.2.0 |
| Soha Operator | v0.1.1 | GitHub Release 与 ghcr.io/opensoha/soha-operator:0.1.1(同发 v0.1.1 标签) |
| 官方 Skills | skills/v0.1.4 | GitHub Release 已校验资产与签名 |
| 官方 Connectors | connectors/v0.1.1 | GitHub Release 已校验运行时包与清单 |
对应的公开 Helm 仓库地址为 https://opensoha.github.io/soha-helm。当前已发布的最新 chart 版本如下:
| Helm chart | 已发布 Chart 版本 | 默认 Runtime appVersion | 状态说明 |
|---|---|---|---|
soha | 0.1.10 | 0.1.9 | 面向 Core v0.1.13 的新版 chart 待发布 |
soha-agent | 0.2.5 | 0.1.9 | 面向 Agent v0.2.0 的新版 chart 待发布 |
soha-hermes-agent | 0.1.7 | 0.1.7 | Hermes 已停止发布新镜像,保留 v0.1.12 及更早镜像供兼容使用 |
soha-operator | 0.1.2 | 0.1.1 | 匹配 Operator v0.1.1 |
soha-observability | 0.2.1 | 0.157.0 | 保持默认 logs-only,可选开启带认证的 OTLP metrics / traces |
主要变更
- 主仓统一发布:六个原独立组件仓库(
soha-contracts、soha-web、soha-cli、soha-agent、soha-skills、soha-connectors)已归档为只读历史源,后续组件版本统一从opensoha/soha发布,Web 控制台由 Core 发布工作流基于同提交源码构建并嵌入交付。 - Contracts
0.2.0:启用github.com/opensoha/soha/contractsGo 模块路径与@opensoha/contracts@0.2.0npm 包,补充agent/dsh-runtime.schema.json、虚拟机与工作区契约以及受控 CLI 会话端点定义。 - Core
v0.1.13与 Agentv0.2.0:合入统一内网访问运行时镜像、可选dsh/ Hindsight 配置入口(默认关闭)以及soha-dsh:v0.2.0、soha-docker-volume-reader:v0.2.0、soha-buildpacks-agent多架构镜像;Hermes runner 停止发布新镜像,既有镜像和可选运行入口保留。 - CLI
v0.2.1:修复 npm 12 打包描述符校验并完成签名 npm 启动器、原生归档、Go 子模块与双架构镜像公开校验(cli/v0.2.0仅发布了原生归档与容器镜像,未发布 npm 包,既有不可变产物保留)。 - Operator
v0.1.1:更新WorkloadCronJob对账与源工作负载 / CronJobresourceVersion状态记录,配套发布soha-operatorHelm chart0.1.2。
升级顺序
- 只有在
@opensoha/contractsnpm 包与github.com/opensoha/soha/contractsGo 模块标签均可解析后,才升级下游组件或外部消费者。 - Core
v0.1.13镜像与发行资产已内置同提交构建并校验的 Web 控制台产物;启用新 Chat / Heya 前需额外部署匹配的soha-dsh:v0.2.0并按 Agent Runtime 完成离线维护切换。 - Agent、CLI 与 Operator 独立升级;兼容边界是公开 API、Agent 协议与能力矩阵,而不是相同的 SemVer 数字。
- 对应 GHCR 镜像可用后再升级 Helm chart。Chart 版本与
appVersion采用各自独立的版本序列;在新版soha/soha-agentchart 发布前,不要假定 Helm 默认appVersion已自动指向v0.1.13/v0.2.0。
Soha、CLI、Agent、DSH 与网络运行时镜像使用带 v 前缀的 runtime tag。Operator 同时发布 vX.Y.Z 与不带 v 的 X.Y.Z 镜像标签,原生清单与 Operator chart 从 appVersion 使用不带 v 的 0.1.1。
回滚
- 回滚 Soha 时,同时恢复匹配的 Core 镜像(及其内嵌 Web 产物)、网络运行时镜像和数据库兼容范围;已启用加密检查点时保留有效凭据加密密钥。
- 回滚 Agent、DSH、Hermes 或 Operator 时,同时固定上一版已验证镜像与匹配的清单或 chart 版本。
- 已发布的 npm 包、Go module 版本和 GHCR 发布标签不可变;出现问题时发布向前补丁版本(例如
cli/v0.2.1),不移动标签或覆盖已公开产物。
验证与历史归档说明
soha-web-dist.tar.gz 与 Web 摘要保存在发布工作流的 Actions 构建产物中,不是 v0.1.13 的独立 GitHub Release 下载附件。公开 manifest 记录同提交 Web 的摘要,使用发行二进制或镜像即可获得内嵌控制台。
发布流水线会校验源码提交绑定、checksum、签名 provenance 与重新下载的公开资产;Core、Agent、CLI 与 Operator 关键运行镜像提供 GHCR 多架构 manifest(soha-proxy-v2ray 与 soha-radius 当前仅构建 linux/amd64)。
2026 年 8 月早期组合(Contracts 0.1.13、Core / Web / CLI / Agent v0.1.6、Operator v0.1.0、Skills v0.1.1)的原始标签与资产字节已保全在主仓历史归档中;原独立组件仓库归档退役后,历史旧仓库 URL 与旧 Go 模块路径可能停止解析,新安装与固定版本应统一使用上表中的 opensoha/soha 与 opensoha/soha-operator 产物。