发布 v0.4.12：增加 Cursor 桌面部署与镜像发布配置

README.md

@@ -1,6 +1,6 @@
 # 夭夭 AI
 
-当前 Web 与 macOS 桌面发布版本：**v0.4.11**。桌面版提供 Apple Silicon（arm64）DMG，详见 [发布说明](docs/releases/v0.4.11.md)。
+当前 Web 与 macOS 桌面发布版本：**v0.4.12**。桌面版提供 Apple Silicon（arm64）DMG，详见 [发布说明](docs/releases/v0.4.12.md)。
 
 夭夭 AI 为网页、iOS 和安卓提供统一的 Agent、群聊、文件库及语音配置服务。Hermes 通过标准 9119 HTTP/WebSocket 接口执行任务。
 
@@ -38,7 +38,7 @@ Web 数据默认保存在 `~/.yaoyao`，可用 `YAOYAO_HOME` 指定（兼容 `HE
 
 ## macOS 桌面版
 
-在 [v0.4.11 发布页](https://github.com/Lsamien/yaoyao/releases/tag/v0.4.11) 下载 `Yaoyao-0.4.11-arm64.dmg`，将“夭夭”拖到应用程序后打开。首次启动会核对并同步配套本机 Web 服务；普通退出保留后台运行，“停止后台服务并退出”可完整停止本应用管理的后台。详细说明见 [macOS App](docs/macos-app.md)。
+在 [v0.4.12 发布页](https://github.com/Lsamien/yaoyao/releases/tag/v0.4.12) 下载 `Yaoyao-0.4.12-arm64.dmg`，将“夭夭”拖到应用程序后打开。首次启动会核对并同步配套本机 Web 服务；普通退出保留后台运行，“停止后台服务并退出”可完整停止本应用管理的后台。详细说明见 [macOS App](docs/macos-app.md)。
 
 此 DMG 使用 Apple Development 开发签名，未做 Apple 公证。
 
@@ -48,11 +48,11 @@ Web 数据默认保存在 `~/.yaoyao`，可用 `YAOYAO_HOME` 指定（兼容 `HE
 
 | 镜像 | 架构 |
 | --- | --- |
-| `samienluo/yaoyao:v0.4.11-amd` | AMD64 |
-| `samienluo/yaoyao:v0.4.11` | 自动匹配 AMD64 / ARM64 |
-| `samienluo/yaoyao:latest` | 最新稳定版通用镜像，当前与 `v0.4.11` 相同 |
+| `samienluo/yaoyao:v0.4.12-amd` | AMD64 |
+| `samienluo/yaoyao:v0.4.12` | 自动匹配 AMD64 / ARM64 |
+| `samienluo/yaoyao:latest` | 最新稳定版通用镜像，当前与 `v0.4.12` 相同 |
 
-准备好 Docker Engine/Compose 和容器可访问的 Hermes 9119 服务，在仓库目录将 `docker.env.example` 复制为 `docker.env`。配置上游地址，并设置 `HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.11`（或 `samienluo/yaoyao:latest`），即可使用远程镜像：
+准备好 Docker Engine/Compose 和容器可访问的 Hermes 9119 服务，在仓库目录将 `docker.env.example` 复制为 `docker.env`。配置上游地址，并设置 `HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.12`（或 `samienluo/yaoyao:latest`），即可使用远程镜像：
 
 ```sh
 docker compose --env-file docker.env pull web

docker.env.example

@@ -3,13 +3,15 @@ HERMES_YAOYAO_BIND_ADDRESS=127.0.0.1
 HERMES_YAOYAO_PUBLISHED_PORT=15300
 # 远程通用镜像支持 AMD64 / ARM64；每次发布更新 latest 并保留旧版本标签。
 # HERMES_YAOYAO_IMAGE=samienluo/yaoyao:latest
-# 固定版本：samienluo/yaoyao:v0.4.11；仅 AMD64：samienluo/yaoyao:v0.4.11-amd。
+# 固定版本：samienluo/yaoyao:v0.4.12；仅 AMD64：samienluo/yaoyao:v0.4.12-amd。
 # 留空时使用本地构建名称 yaoyao:local。
 # YAOYAO_DESKTOP_IMAGE=hermes-yaoyao-desktop:0.4.0
 # Cursor Universal 兼容桌面的本地构建名称；基础镜像在 deploy/computer/Dockerfile.cursor 中固定。
 # 使用 compose.desktops.cursor.yaml 部署 Web + 一台 Cursor 桌面（linux/amd64）。
 # 不要填写上游原始镜像地址，此变量指向已加入夭夭桥接层的运行镜像。
 # YAOYAO_CURSOR_DESKTOP_IMAGE=yaoyao-desktop:cursor
+# 发布版可直接拉取：
+# YAOYAO_CURSOR_DESKTOP_IMAGE=samienluo/yaoyao-desktop:v0.4.12-cursor-amd
 
 # 部署步骤见 docs/docker-install.md；使用 docker compose --env-file docker.env 启动。
 # 填写容器可访问的 Hermes Dashboard/Gateway 地址。

docs/docker-install.md

@@ -12,14 +12,14 @@
 
 | 标签 | 架构 |
 | --- | --- |
-| `v0.4.11-amd` | `linux/amd64` |
-| `v0.4.11` | `linux/amd64`、`linux/arm64`，拉取时自动匹配 |
-| `latest` | 最新稳定通用镜像，当前指向与 `v0.4.11` 相同的镜像 |
+| `v0.4.12-amd` | `linux/amd64` |
+| `v0.4.12` | `linux/amd64`、`linux/arm64`，拉取时自动匹配 |
+| `latest` | 最新稳定通用镜像，当前指向与 `v0.4.12` 相同的镜像 |
 
 ```sh
-docker pull samienluo/yaoyao:v0.4.11
+docker pull samienluo/yaoyao:v0.4.12
 # 需要固定 AMD64 时：
-docker pull samienluo/yaoyao:v0.4.11-amd
+docker pull samienluo/yaoyao:v0.4.12-amd
 ```
 
 每次新版本发布都会更新 `latest`，旧版本标签继续保留。需要固定部署版本时使用具体版本标签。
@@ -34,7 +34,7 @@ cp docker.env.example docker.env
 
 | 配置 | 用途 |
 | --- | --- |
-| `HERMES_YAOYAO_IMAGE` | 远程镜像可设为 `samienluo/yaoyao:v0.4.11` 或 `samienluo/yaoyao:latest`；未设置时使用本地构建名称 |
+| `HERMES_YAOYAO_IMAGE` | 远程镜像可设为 `samienluo/yaoyao:v0.4.12` 或 `samienluo/yaoyao:latest`；未设置时使用本地构建名称 |
 | `HERMES_YAOYAO_UPSTREAM` | Hermes 上游地址，默认 `http://host.docker.internal:9119` |
 | `HERMES_YAOYAO_BIND_ADDRESS` | Web 的宿主机发布地址，默认 `127.0.0.1`；局域网访问可设为 `0.0.0.0` |
 | `HERMES_YAOYAO_PUBLISHED_PORT` | 宿主机 Web 端口，默认 `15300` |
@@ -114,6 +114,7 @@ docker compose --env-file docker.env -f compose.desktops.yaml up -d --build
 | 上游基础镜像 | `public.ecr.aws/k0i0n2g5/cursorenvironments/universal:sand-box-latest` |
 | 构建固定版本 | `sha256:858b6df5d0aeffd5db0e20c81553e98f84b07e9c700a13fcd1febac0e8c54830` |
 | 兼容镜像 | `yaoyao-desktop:cursor`，通过 `deploy/computer/Dockerfile.cursor` 在本地构建 |
+| 已发布兼容镜像 | `samienluo/yaoyao-desktop:v0.4.12-cursor-amd` |
 | 架构 | `linux/amd64`；ARM64 宿主需要 Docker 的 amd64 模拟支持 |
 | 桌面资源 | 2 CPU、4 GB 内存、512 MB 共享内存、512 个进程 |
 | 持久工作目录 | `desktop-cursor-workspace` 卷 → `/home/cua/workspace`，含浏览器资料 |
@@ -148,7 +149,21 @@ docker compose --env-file docker.env -f compose.desktops.cursor.yaml ps
 curl --fail http://127.0.0.1:15300/healthz
 ```
 
-如果使用已包含 Cursor 桌面支持的预构建 Web 镜像，将 `HERMES_YAOYAO_IMAGE` 设为相应版本，先 `pull web`，再单独 `build desktop-cursor`，最后执行上述 `up -d --no-build`。兼容桌面镜像需自行构建，本文不假定它已发布到远程仓库。
+使用 Docker Hub 发布镜像时，在 `docker.env` 设置：
+
+```dotenv
+HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.12
+YAOYAO_CURSOR_DESKTOP_IMAGE=samienluo/yaoyao-desktop:v0.4.12-cursor-amd
+```
+
+直接拉取并启动，无需本地编译：
+
+```sh
+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
+```
+
+Web 镜像自动匹配 AMD64 / ARM64；Cursor 桌面为 AMD64。已有标准桌面仍沿用其镜像配置。
 
 随后按下方“[Hermes 执行连接](#hermes-执行连接)”注册或连接执行节点，再在 Agent 聊天的 **电脑 → 此 Agent 使用的电脑** 中选择“Cursor 开发桌面”。
 

docs/releases/v0.4.12.md

@@ -0,0 +1,51 @@
+# 夭夭 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 地址，并设置：
+
+```dotenv
+HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.12
+YAOYAO_CURSOR_DESKTOP_IMAGE=samienluo/yaoyao-desktop:v0.4.12-cursor-amd
+```
+
+```sh
+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 部署说明](../docker-install.md#hermes-执行连接) 注册执行节点。
+
+镜像 digest、远端架构、运行方式和发布附件核验结果记录在 [本版本 GitHub 发布页](https://github.com/Lsamien/yaoyao/releases/tag/v0.4.12)。Web 固定标签验证通过后更新 `latest`，旧版本标签与附件保留。
+
+## 升级
+
+升级前备份数据目录和密钥；Docker 更新通过拉取镜像并重建容器完成，保留命名卷，不使用 `down --volumes`。已有固定桌面切换镜像时保留 ID、service 和数据卷，并先结束正在执行的任务。
+
+本机 App 首次启动仍只同步较旧的本机 Web；默认数据目录为 `~/.yaoyao`。

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "yaoyao",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "yaoyao",
-      "version": "0.4.11",
+      "version": "0.4.12",
       "license": "Apache-2.0",
       "dependencies": {
         "@koa/bodyparser": "^5.0.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaoyao",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "private": true,
   "license": "Apache-2.0",
   "description": "夭夭 AI：聊天、多 Agent 团队、文件库与电脑工作空间",

release.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.4.11",
-  "webVersion": "0.4.11",
-  "gitTag": "v0.4.11"
+  "releaseVersion": "0.4.12",
+  "webVersion": "0.4.12",
+  "gitTag": "v0.4.12"
 }