修正取消实验功能后的桌面版本衔接并升级至 v0.4.21

README.md

@@ -2,6 +2,8 @@
 
 当前 Web 与 macOS 桌面发布版本：**v0.4.20**。桌面版提供 Apple Silicon（arm64）DMG，详见 [发布说明](docs/releases/v0.4.20.md)。
 
+当前源码与本地桌面构建为 **v0.4.21**，修正取消实验功能后的后台版本衔接，详见 [本地构建说明](docs/releases/v0.4.21.md)。该版本尚未发布到 GitHub 或 Docker Hub，下方下载和镜像链接仍指向已发布版本。
+
 夭夭 AI 为网页、iOS 和安卓提供统一的 Agent、群聊、文件库及语音配置服务。Hermes 通过标准 9119 HTTP/WebSocket 接口执行任务。
 
 ## 聊天与 Agent

docs/app-web-sync.md

@@ -16,6 +16,12 @@
 
 成功后在数据目录的 `updates/desktop-sync.json` 记录本次 App 服务包校验值。再次打开同一构建不会重新同步，允许 Web 继续自行升级或经兼容性检查后单独回滚。该记录属于数据目录，不是全局 App 偏好。失败不写成功记录，启动页可重试。
 
+### 取消已安装的实验构建
+
+回退 Git 源码不会回退已经安装的独立 Web。同一版本号下，若现有 Web 的提交包含回退后 App 的提交，自动同步仍会保留现有 Web；重新编译或复制相同源码的 App 不会移除其界面功能。
+
+需要让修正版自动替换实验构建时，应在恢复后的源码上增加补丁版本，再重新打包。例如 v0.4.21 会将仍运行实验功能的 v0.4.20 Web 正常升级为修正版。验收必须从实际旧服务包升级，核对后台的版本、提交、界面资源及数据保留，不能只验证新 App 在空数据目录中的首次启动。保持相同版本号时，使用下述一次性强制覆盖入口。
+
 ## 强制覆盖同版本 Web
 
 App 与 Web 的版本号相同，即使提交来自不同历史或属于工作区快照，也可以使用当前 App 的配套服务覆盖。启动页遇到构建关系不明时显示 **使用当前 App 覆盖同版本 Web**；进入 Web 后也可从 macOS 的 **夭夭** 菜单选择同名操作。

docs/releases/v0.4.21.md

@@ -0,0 +1,16 @@
+# 夭夭 AI v0.4.21 本地构建
+
+本次生成 macOS Apple Silicon 桌面安装包，尚未发布到 GitHub 或 Docker Hub。
+
+## 修复内容
+
+- 取消“跳过原始记忆”和“跳过后台复盘”两个本机协作实验开关，恢复取消实验前的本机协作行为。
+- 将修正版标为 v0.4.21，使 App 首次启动时能将仍运行实验功能的 v0.4.20 后台正常升级，避免回退源码后仍连接实验版界面。
+- 升级沿用现有事务流程：服务空闲后备份数据并切换程序，保留聊天、设置和文件，失败时恢复。
+- 保留 Bot 协作、三层文件记忆、技能共享及其他已完成功能。
+
+## 安装与验证
+
+安装后打开 App，等待本机 Web 同步完成。验收同时核对 App 与 15300 后台的版本、提交及服务包校验值，并从实际 v0.4.20 实验服务包验证升级和数据保留。服务忙碌时同步会延后，待任务完成后从夭夭菜单重试同步本机 Web。
+
+桌面产物使用 Apple Development 签名，未公证。

package-lock.json

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

package.json

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

release.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.4.20",
-  "webVersion": "0.4.20",
-  "gitTag": "v0.4.20"
+  "releaseVersion": "0.4.21",
+  "webVersion": "0.4.21",
+  "gitTag": "v0.4.21"
 }