yaoyao/docs/release-process.md

夭夭 AI 发布流程

“发布新版本”包括本地构建、GitHub Release 附件和 Docker Hub 远程镜像。三部分均完成并验证后，才算发布完成。

版本与产物

1. 核对当前提交、工作区、已发布版本和客户端改动。release.json 的 releaseVersion、webVersion、gitTag 与根目录 package/lock 版本保持一致。
2. 完成适用的单元测试、浏览器验证和生产构建；用中文提交修改。正式产物对应已确认的源码提交，并记录真实构建身份。
3. 构建 Web 源码包、macOS 桌面安装包和适用的 Android 正式签名 APK，验证签名、架构、启动及完整性，生成 SHA256SUMS.txt。
4. 推送源码与版本标签，上传 GitHub Release 附件，核对远端附件状态、大小和 SHA-256。已发布的 Git 标签与旧附件保持不变。

Docker Hub 远程镜像

固定仓库为 samienluo/yaoyao。以每次发布的 vX.Y.Z 为版本标签：

标签	内容	更新规则
samienluo/yaoyao:vX.Y.Z-amd	linux/amd64	每个新版本发布，保留旧版本标签
samienluo/yaoyao:vX.Y.Z	同时包含 linux/amd64、linux/arm64 的通用镜像	每个新版本发布，客户端自动选择架构
samienluo/yaoyao:latest	最新稳定版本的同一通用镜像	新版本验证通过后更新

• 远程镜像必须使用本次版本对应的源码与构建产物，不能只改标签或复用旧版内容。
• 先推送、验证固定版本标签，再将 latest 指向已验证的通用镜像。保留全部旧版本标签，不覆盖或删除旧版本。
• 检查远端 manifest/index：通用版本包含两个目标架构，-amd 标签对应 AMD64，latest 与新通用版本的 index digest 一致。
• 拉取并检查两个架构的版本与运行情况，验证 /healthz。记录原生或模拟运行方式；/readyz 的上游连接状态另行说明。
• 本地离线 tar 不能代替远程镜像推送。用户另有离线包要求时，同时交付可加载的 tar、镜像标签和校验值。

发布说明与最终核验

版本标题与更新说明只描述夭夭 AI 自身的功能、修复和兼容性，不出现其他参考产品的名称或对比。

每次在 docs/releases/vX.Y.Z.md 和 GitHub Release 中同步说明：

• 本次改动、Web/桌面/Android 版本、下载附件与签名状态。
• 三个 Docker Hub 标签及对应架构，并提供拉取或 Compose 更新方法。
• 远端固定版本与 latest 的 digest、架构和运行验证结果。未完成的项目明确标出，不写“已验证”。
• latest 已更新，旧版本标签保留；数据备份、权限或迁移方面的必要说明。

发布完成前，确认 GitHub Release 为正式版本（非草稿、非预发布），最新版本接口指向目标版本，所有附件摘要一致，远程镜像与 latest 已按上述规则验证。

当前镜像标签与部署方法见 Docker 部署说明。