Merge refactor/4.0-final into docs/4.0-site

.github/workflows/build.yml

@@ -325,17 +325,21 @@ jobs:
         run: |
           cd skills && zip -r "../autobangumi-plugin-skill-${{ needs.version-info.outputs.version }}.zip" autobangumi-plugin
 
-      # 在线自动更新 bundle：module 源码树 + pyproject/uv.lock + 前端 dist + manifest。
-      # 同时产出 .sha256（客户端下载后据此校验完整性）。min_image_version 是能应用
-      # 此 bundle 布局的最低镜像版本（引入在线更新的首个版本）。
+      # 在线自动更新 bundle：module 与 ab_sdk 源码树 + pyproject/uv.lock + 前端 dist +
+      # manifest。同时产出 .sha256（客户端下载后据此校验完整性）。min_image_version
+      # 是能应用此 bundle 布局的最低镜像版本。4.x 的 module 依赖同版本的 ab_sdk 与新
+      # 依赖，只有 4.0 起的镜像（boot_overlay 会替换 /app/ab_sdk）能应用；已发布的
+      # 3.3 镜像在 beta 通道会选中最新的预发布，必须靠这个下限拒绝。本分支只发 4.x，
+      # 下一个大版本若再改 bundle 布局，在这里提高下限。
       - name: Build update bundle
         run: |
           VERSION="${{ needs.version-info.outputs.version }}"
-          MIN_IMAGE_VERSION="3.3.0-beta.1"
+          MIN_IMAGE_VERSION="4.0.0-beta.1"
           STAGE="bundle_stage"
           rm -rf "$STAGE"
           mkdir -p "$STAGE/backend/src" "$STAGE/webui-dist"
           cp -r backend/src/module "$STAGE/backend/src/module"
+          cp -r backend/src/ab_sdk "$STAGE/backend/src/ab_sdk"
           cp backend/pyproject.toml backend/uv.lock "$STAGE/backend/"
           cp -r webui/dist/. "$STAGE/webui-dist/"
           LOCK_SHA=$(sha256sum backend/uv.lock | awk '{print $1}')

.github/workflows/docs.yml

@@ -2,9 +2,9 @@ name: Deploy Docs
 
 on:
   push:
-    # 只从开发分支部署：main 仍是 3.3 文档，两边都部署会互相覆盖。4.0 正式版后改为 main。
+    # 只从 4.0-dev 部署：main 与 3.3-dev 仍是 3.3 文档，多分支部署会互相覆盖。4.0 正式版后改为 main。
     branches:
-      - "*-dev"
+      - 4.0-dev
     paths:
       - "docs/**"
       - ".github/workflows/docs.yml"