容器镜像标签

Wegent 将稳定发布镜像和 main 分支快照镜像分开。普通用户和生产环境应使用稳定标签；维护者、贡献者和测试环境可以使用 main 分支快照标签验证最新合并结果。

标签语义

标签	类型	更新来源	推荐用途
latest	可移动稳定标签	正式发布流程	普通用户快速部署、非严格生产环境
1.2.3	版本标签	正式发布流程	生产环境、可复现部署、回滚
main	可移动快照标签	main 分支合并后的快照流程	内部测试、贡献者验证
edge	可移动快照标签	main 分支合并后的快照流程	与 main 等价，面向习惯使用 edge 通道的用户
main-<short-sha>	提交快照标签	main 分支合并后的快照流程	精确复现某次 main 构建、排障和回滚
main-<short-sha>-amd64 / main-<short-sha>-arm64	架构标签	快照流程内部使用	组成多架构 manifest，不建议直接部署

latest 只表示最新稳定发布版，不代表 main 分支的最新提交。main 和 edge 可能包含尚未正式发布的功能，部署前应确认测试环境可以接受不稳定变更。

快照镜像

每次代码合并到 main 后，Snapshot Image workflow 会构建以下镜像：

ghcr.io/wecode-ai/wegent-backend
ghcr.io/wecode-ai/wegent-web
ghcr.io/wecode-ai/wegent-executor
ghcr.io/wecode-ai/wegent-executor-manager
ghcr.io/wecode-ai/wegent-chat-shell
ghcr.io/wecode-ai/wegent-knowledge-runtime
ghcr.io/wecode-ai/wegent-knowledge-doc-converter
ghcr.io/wecode-ai/wegent-standalone

流程会先推送按提交命名的 main-<short-sha> 多架构标签，并验证 standalone 镜像可以启动。验证通过后，才会将同一批镜像提升到可移动的 main 和 edge 标签。

发布构建维护

正式发布固定使用触发时的提交：手动发布使用工作流触发提交，版本升级 PR 合并触发时使用合并提交。所有构建、Wework 内置源码标识和最终版本标签共用该提交，避免构建期间 main 更新导致源码与产物错位。

正式发布与快照流程共用 .github/actions/setup-rust-cache 配置 executor 的固定 Rust 工具链和缓存。打包二进制时须从该 action 导出的 CARGO_TARGET_DIR 读取产物；macOS x64 产物位于其 x86_64-apple-darwin/release 子目录。

前端和 standalone 镜像的前端、Wework 构建阶段必须包含 shared/data，供共享协作组件读取内置模板。修改构建输入后，运行 bash scripts/test-publish-image-release-policy.sh 检查本地 action、二进制打包路径和各阶段模板文件；该检查也在 CI 中运行。

使用示例

使用最新稳定版：

docker pull ghcr.io/wecode-ai/wegent-standalone:latest

使用 main 分支最新快照：

docker pull ghcr.io/wecode-ai/wegent-standalone:edge

复现某次 main 构建：

docker pull ghcr.io/wecode-ai/wegent-standalone:main-631609e5a123

标准多容器部署测试 main 快照时，应让所有 Wegent 服务使用同一个快照标签，避免不同服务之间版本不一致。