yaoyao/docs/releases/v0.4.12.md

夭夭 AI v0.4.12

本次发布 Web、macOS Apple Silicon 桌面版、Docker Web 双架构镜像和 Cursor Universal 兼容桌面镜像。Android 沿用已签名且源码未变的 1.3（165）安装包。

更新内容

• 电脑环境可选择标准桌面或 Cursor Universal 桌面，各环境保留独立镜像选择、工作文件和浏览器资料；共享成员使用同一桌面的镜像。
• Docker Web 新增 compose.desktops.cursor.yaml，一次部署 Web 和一台 Cursor 开发桌面。镜像加入 CUA 驱动及私有 Unix socket 桥接层，固定已验证的上游 digest。
• Compose 继续管理固定桌面数量和生命周期，Agent 在电脑面板选择已有桌面。提供两种镜像混合部署和可选联网配置。
• 群聊可直接创建，按需启用交付目标；任务面板按运行情况展示状态，并补齐协调、调度与工具调用检查。
• 侧栏工具入口统一为交叉工具图标。

下载

• Yaoyao-0.4.12-arm64.dmg：macOS Apple Silicon，Apple Development 开发签名，未做 Apple 公证。
• Yaoyao-1.3-165-android.apk：Android 12 及以上，与 v0.4.11 的正式签名附件相同。
• Yaoyao-0.4.12-source.tar.gz：Web、桌面端源码及 Docker Compose 配置。
• SHA256SUMS.txt：发布附件 SHA-256 校验文件。

Docker Hub 镜像

镜像	架构与用途
samienluo/yaoyao:v0.4.12-amd	Web，linux/amd64
samienluo/yaoyao:v0.4.12	Web，linux/amd64 / linux/arm64
samienluo/yaoyao:latest	验证后指向本次 Web 通用镜像
samienluo/yaoyao-desktop:v0.4.12-cursor-amd	Cursor Universal 兼容桌面，linux/amd64

Cursor 基础镜像为 public.ecr.aws/k0i0n2g5/cursorenvironments/universal:sand-box-latest@sha256:858b6df5d0aeffd5db0e20c81553e98f84b07e9c700a13fcd1febac0e8c54830。ARM64 宿主运行该桌面需要 amd64 模拟支持。

在源码包目录复制 docker.env.example 为 docker.env，配置可访问的 Hermes 9119 地址，并设置：

HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.12
YAOYAO_CURSOR_DESKTOP_IMAGE=samienluo/yaoyao-desktop:v0.4.12-cursor-amd

docker compose --env-file docker.env -f compose.desktops.cursor.yaml pull web desktop-cursor
docker compose --env-file docker.env -f compose.desktops.cursor.yaml up -d --no-build

默认桌面为 2 CPU、4 GB 内存、512 MB 共享内存，无外网且不发布桌面控制端口。工作文件与浏览器资料保存在命名卷。首次使用按 Docker 部署说明 注册执行节点。

镜像 digest、远端架构、运行方式和发布附件核验结果记录在 本版本 GitHub 发布页。Web 固定标签验证通过后更新 latest，旧版本标签与附件保留。

升级

升级前备份数据目录和密钥；Docker 更新通过拉取镜像并重建容器完成，保留命名卷，不使用 down --volumes。已有固定桌面切换镜像时保留 ID、service 和数据卷，并先结束正在执行的任务。

本机 App 首次启动仍只同步较旧的本机 Web；默认数据目录为 ~/.yaoyao。