yaoyao/docs/releases/v0.4.9.md

夭夭 AI v0.4.9

本次发布 Web、macOS Apple Silicon 桌面版和 Android 1.3（164），包含此前尚未正式发布的 v0.4.8 改动。

更新内容

• 修复普通聊天用户消息重复回显，统一发送回执、实时事件与历史记录的消息身份；保留连续发送相同文字的独立消息。
• 修复工具调用重复累计及结束后仍显示运行中的问题。进度通知与真实调用分开处理，真实调用按 ID 合并；失败和未确认结果保留准确状态。
• 改进历史与实时消息合并，保护仍在执行的回合和排队输入，避免迟到历史覆盖当前对话。
• 新增服务端“文件访问”设置，由管理员配置额外允许目录或全局授权；当前 Profile 的实际工作目录始终允许，Web 与移动端统一走服务端权限校验。
• 服务器文件预览统一携带 Profile。预览失败显示文件名、具体原因与重试入口；上传和归档附件保留原有权限规则。
• 修复服务器图片切换新文件接口后无法打开大图的问题，保持图库顺序、文件名及重试后的预览关联。
• 安卓同步修复工具状态、历史合并和服务器文件预览。

下载

• Yaoyao-0.4.9-arm64.dmg：macOS Apple Silicon，Apple Development 开发签名，未做 Apple 公证。
• Yaoyao-1.3-164-android.apk：Android 12 及以上，沿用原正式发布密钥。
• Yaoyao-0.4.9-source.tar.gz：Web 与桌面端源码。
• SHA256SUMS.txt：发布附件的 SHA-256 校验文件。

Docker Hub 远程镜像

镜像仓库：samienluo/yaoyao。

镜像标签	架构
samienluo/yaoyao:v0.4.9-amd	AMD64
samienluo/yaoyao:v0.4.9	自动匹配 AMD64 / ARM64
samienluo/yaoyao:latest	当前指向与 v0.4.9 相同的通用镜像

docker pull samienluo/yaoyao:v0.4.9
# 仅使用 AMD64：
docker pull samienluo/yaoyao:v0.4.9-amd

远端镜像清单已核对：通用版本包含 linux/amd64 与 linux/arm64，v0.4.9-amd 与通用版本中的 AMD64 清单一致。v0.4.9 与 latest 的 index digest 均为 sha256:402031da41ddf9031e4bd29d797ae763b24bf982343fe73f3d03daea300106b5。

后续发布同时提供本地构建和远程镜像，新版本验证通过后更新 latest，保留旧版本标签。

Compose 用户在 docker.env 设置 HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.9 或 samienluo/yaoyao:latest，然后执行：

docker compose --env-file docker.env pull web
docker compose --env-file docker.env up -d --no-build web

升级与文件权限

官方发布地址为 https://github.com/Lsamien/yaoyao/releases/tag/v0.4.9 。App 首次启动继续只同步较旧的本机 Web，保留已有更新的独立 Web；默认数据目录为 ~/.yaoyao。

文件访问默认只允许当前 Profile 工作目录及其子目录，管理员可在“设置 → 文件访问”中添加目录或开启全局授权。规则在服务器即时生效，仍受 Hermes 自身认证、敏感文件与宿主权限限制。配置随服务端数据目录备份，详见 服务端文件访问权限。

升级前备份完整数据目录及加密密钥。源码部署更新版本后重新构建；Docker 部署拉取对应远程镜像或自行构建，再重建容器，保留原数据目录或命名卷。