yaoyao/docs/releases/v0.4.22.md

夭夭 AI v0.4.22

本次发布 Web、macOS Apple Silicon 桌面版及 Docker Web 双架构镜像，不提供 APK。v0.4.21 为此前的本地构建，正式版本提升到 v0.4.22，便于已有安装正常升级。

更新内容

• 独立 Bot 设置，集中管理项目、用户记忆和本地虚拟机；“我的设置”保留账号资料、安全、外观、连接及系统管理。统一弹窗、分类导航、主题预览和窄屏布局。
• 统一虚拟机 Bot 的基础会话、模型、视觉路由、技能与授权管理，保留虚拟机模式和本机协作模式各自的执行边界。
• 新增工具桥插件的检查、安装、启用、更新与重新安装入口。区分已安装版本和实际加载版本，显示未启用、需更新、待加载和已就绪等状态，并保留安装备份与失败恢复。
• 桌面安装包和执行节点安装包补齐工具桥、安装器及技能相关资源。Docker 镜像提供安装器依赖，并支持可选目录映射配置。
• Bot 可在回合结束后独立复盘并沉淀可复用技能，继续保留记忆隔离；关闭基础会话的原始记忆和上下文文件自动加载，避免自动混入 Bot 上下文。
• 修复会话创建的记忆参数兼容问题，以及刷新期间用量更新与检查点保存交错导致运行状态、待审批提示未恢复的问题。

升级说明

• 建议同步更新配套执行节点，并在“我的设置 → 连接”中检查工具桥。插件写入完成后，根据界面提示使目标服务加载新版本；“已安装”不等于“已加载”。
• Docker 可按部署文档使用 compose.hermes-bridge.yaml 映射目标配置目录，目录需允许容器用户写入。仅在已配置的映射范围内执行安装。
• 升级前备份整个 .yaoyao 数据目录，包括数据库、附件、项目与文件记忆。普通聊天继续使用 v2 协议，客户端需保持配套版本。
• 本次不构建、不上传 APK，已有 Android 发布附件保留。
• 主项目采用 Apache-2.0，第三方组件保留各自许可与署名。

下载

• Yaoyao-0.4.22-arm64.dmg：macOS Apple Silicon，Apple Development 开发签名，未公证。
• Yaoyao-0.4.22-source.tar.gz：Web/桌面源码及部署配置。
• SHA256SUMS.txt：以上两个附件的 SHA-256 校验值。

Docker Hub

镜像	架构
samienluo/yaoyao:v0.4.22-amd	linux/amd64
samienluo/yaoyao:v0.4.22	linux/amd64、linux/arm64
samienluo/yaoyao:latest	验证后指向同一通用镜像

docker pull samienluo/yaoyao:v0.4.22
docker compose --env-file docker.env pull web
docker compose --env-file docker.env up -d --no-build web

Compose 中设置 HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.22。旧版本标签和附件保留，镜像发布到 Docker Hub，GitHub 不上传镜像归档。

附件摘要、镜像摘要和验证记录见 GitHub 发布页。