发布 v0.4.71：修复断线恢复并提供 Windows 测试客户端

README.md

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

docker.env.example

@@ -3,7 +3,7 @@ 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.70；仅 AMD64：samienluo/yaoyao:v0.4.70-amd。
+# 固定版本：samienluo/yaoyao:v0.4.71；仅 AMD64：samienluo/yaoyao:v0.4.71-amd。
 # 留空时使用本地构建名称 yaoyao:local。
 # YAOYAO_DESKTOP_IMAGE=hermes-yaoyao-desktop:0.4.0
 # Cursor Universal 兼容桌面的本地构建名称；基础镜像在 deploy/computer/Dockerfile.cursor 中固定。

docs/docker-install.md

@@ -12,14 +12,14 @@
 
 | 标签 | 架构 |
 | --- | --- |
-| `v0.4.70-amd` | `linux/amd64` |
-| `v0.4.70` | `linux/amd64`、`linux/arm64`，拉取时自动匹配 |
-| `latest` | 最新稳定通用镜像，当前指向与 `v0.4.70` 相同的镜像 |
+| `v0.4.71-amd` | `linux/amd64` |
+| `v0.4.71` | `linux/amd64`、`linux/arm64`，拉取时自动匹配 |
+| `latest` | 最新稳定通用镜像，当前指向与 `v0.4.71` 相同的镜像 |
 
 ```sh
-docker pull samienluo/yaoyao:v0.4.70
+docker pull samienluo/yaoyao:v0.4.71
 # 需要固定 AMD64 时：
-docker pull samienluo/yaoyao:v0.4.70-amd
+docker pull samienluo/yaoyao:v0.4.71-amd
 ```
 
 每次新版本发布都会更新 `latest`，旧版本标签继续保留。需要固定部署版本时使用具体版本标签。
@@ -34,7 +34,7 @@ cp docker.env.example docker.env
 
 | 配置 | 用途 |
 | --- | --- |
-| `HERMES_YAOYAO_IMAGE` | 远程镜像可设为 `samienluo/yaoyao:v0.4.70` 或 `samienluo/yaoyao:latest`；未设置时使用本地构建名称 |
+| `HERMES_YAOYAO_IMAGE` | 远程镜像可设为 `samienluo/yaoyao:v0.4.71` 或 `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` |
@@ -211,7 +211,7 @@ curl --fail http://127.0.0.1:15300/healthz
 使用 Docker Hub 发布镜像时，在 `docker.env` 设置：
 
 ```dotenv
-HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.70
+HERMES_YAOYAO_IMAGE=samienluo/yaoyao:v0.4.71
 YAOYAO_CURSOR_DESKTOP_IMAGE=samienluo/yaoyao-desktop:v0.4.12-cursor-amd
 ```
 

docs/release-process.md

@@ -29,6 +29,10 @@ macOS 新版本默认使用 Developer ID Application 正式分发签名、Apple
 
 既有手动安装版客户端需先手动安装一次正式包，之后才能使用“下载更新 → 重启更新”。发布前应使用同一签名身份的两个版本，在隔离机器上验证实际替换与重新启动；单元测试或未签名包的打包成功不能代替这项验收。
 
+### Windows 测试安装包
+
+Windows 原生助手和安装包在 Windows x64 环境从同一发布提交构建，并验证安装、启动和升级。未配置正式证书时须标为未签名测试版；经用户选择交付后，Release 可提供 EXE 与独立测试元数据 ZIP，但不在 Release 根目录上传 Windows `latest.yml`。元数据包含同次构建的更新清单、blockmap、校验值和构建身份。Windows Server CI 与 Windows 10/11 真机验收结果分别说明。
+
 ## Docker Hub 远程镜像
 
 固定仓库为 `samienluo/yaoyao`。以每次发布的 `vX.Y.Z` 为版本标签：

docs/releases/v0.4.71.md

@@ -0,0 +1,47 @@
+# 夭夭 AI v0.4.71
+
+本次发布 Web、macOS Apple Silicon 正式桌面版、Windows x64 未签名测试客户端和 Docker 双架构镜像，不提供 APK。
+
+## 更新内容
+
+- 改善断网、页面切回前台和服务器短暂不可达后的自动恢复，重新同步会话、运行状态与待审批内容，避免重复发送消息。
+- 修复实时事件重连后的补发与游标处理，检测遗漏消息并恢复完整记录，避免界面停留在过期状态。
+- 改善工具授权续期和上游连接恢复：临时网络故障在原授权有效期内重试，明确失效或撤销的授权仍会终止。
+- 新增 Windows 10/11 x64 客户端，可连接已有夭夭服务器，支持聊天、电脑授权、主屏截图与键鼠控制、独立浏览器，以及授权后的文件和命令操作。
+- 完善跨平台设备识别、路径边界、命令取消与子进程清理，以及登录、托盘、退出和更新行为。
+
+## 升级说明
+
+- 升级前备份完整 `.yaoyao` 数据目录，建议先更新服务端，再更新桌面客户端。
+- macOS 桌面使用 Developer ID Application 正式分发签名及 Apple 公证，提供完整自动更新附件；已安装正式签名版的用户可使用“下载更新 → 重启更新”，历史开发签名版请先手动安装正式 DMG。
+- Windows 为未签名测试客户端，可能提示未知发布者；安装到当前用户目录，连接已有服务器，不托管本机服务。Windows 电脑操作需要本次配套服务端支持。
+- Windows 测试更新清单随独立元数据压缩包提供，不写入正式自动更新源。Windows Server CI 验证结果与尚未完成的 Windows 10/11 真机项目分别列出，详见 [客户端说明](../windows-client.md)。
+- 本次不构建、不上传 APK，旧版本标签和附件继续保留。
+- 主项目采用 Apache-2.0，第三方组件保留各自许可与署名。
+
+## 下载
+
+- `Yaoyao-0.4.71-arm64.dmg`：macOS Apple Silicon 首次安装或手动更新。
+- `Yaoyao-0.4.71-arm64.zip`、DMG 与 ZIP 对应的 `.blockmap`、`latest-mac.yml`：macOS 自动更新载荷与清单。
+- `Yaoyao-0.4.71-win-x64-setup.exe`：Windows x64 未签名测试安装包。
+- `Yaoyao-0.4.71-windows-test-metadata.zip`：Windows 测试更新清单、差分文件、构建身份、说明及校验值；解压后与安装包放在同一目录使用。
+- `Yaoyao-0.4.71-source.tar.gz`：Web/桌面源码及部署配置。
+- `SHA256SUMS.txt`：发布附件的 SHA-256 校验值。
+
+## Docker Hub
+
+| 镜像 | 架构 |
+| --- | --- |
+| `samienluo/yaoyao:v0.4.71-amd` | `linux/amd64` |
+| `samienluo/yaoyao:v0.4.71` | `linux/amd64`、`linux/arm64` |
+| `samienluo/yaoyao:latest` | 验证后更新为同一通用镜像 |
+
+```sh
+docker pull samienluo/yaoyao:v0.4.71
+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.71`。镜像发布到 Docker Hub，GitHub 提供安装及更新附件、源码和校验文件。
+
+附件摘要、镜像摘要与实际验证结果见 [GitHub 发布页](https://github.com/Lsamien/yaoyao/releases/tag/v0.4.71)。

docs/windows-client.md

@@ -15,6 +15,8 @@ Windows 首版支持 Windows 10/11 x64，安装后连接已有夭夭服务器。
 
 ## 构建与安装包
 
+v0.4.71 发布页提供未签名测试 EXE 与独立的测试更新元数据压缩包。元数据包包含 `latest.yml`、blockmap、构建身份与校验值，解压后与 EXE 放在同一目录使用；GitHub Release 根目录不提供 Windows `latest.yml`，测试包不进入正式自动更新源。
+
 日常可以在 Mac 修改共享代码；原生助手和 EXE 安装包在 Windows x64 上构建。需要 Node 24、CMake、Visual Studio 2022 C++ 工具链和 Windows SDK；GitHub Actions `windows-2022` 提供该构建环境。
 
 ```powershell

package-lock.json

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

package.json

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

release.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.4.70",
-  "webVersion": "0.4.70",
-  "gitTag": "v0.4.70"
+  "releaseVersion": "0.4.71",
+  "webVersion": "0.4.71",
+  "gitTag": "v0.4.71"
 }