From b03431b51121e7ab398ad8439b7f7a67675ab1de Mon Sep 17 00:00:00 2001
From: chenjw28 <792430652@qq.com>
Date: Thu, 24 Sep 2026 17:05:01 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(deploy):=20=E6=98=8E?=
 =?UTF-8?q?=E7=A1=AE=E8=A3=B8=20up=20=E4=B8=8D=E9=87=8D=E5=BB=BA=E5=B7=B2?=
 =?UTF-8?q?=E6=9C=89=E9=95=9C=E5=83=8F=20+=20=E4=BF=AE=E6=AD=A3=20build.sh?=
 =?UTF-8?q?=20=E4=B8=89=E6=AD=A5=E6=8F=8F=E8=BF=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- DEPLOYMENT §1.2 / LINUX_SETUP §11 / README / OPERATIONS 补充：
  docker compose up -d 对本地已有同名镜像不会自动重建，更新代码后
  需 up -d --build 或先 build（部署机实测复用旧镜像后澄清）
- build.sh 描述由四步修正为 base → backend → frontend 三步（celery
  复用 backend 镜像，随 Dockerfile.celery 移除的文档收尾）

Co-Authored-By: Claude Code <noreply@anthropic.com>
---
 README.md                      |  2 +-
 docs/DEPLOYMENT.md             | 10 +++++++++-
 docs/OPERATIONS.md             |  2 +-
 docs/deployment/LINUX_SETUP.md |  4 +++-
 4 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 71177c1..a64829d 100644
--- a/README.md
+++ b/README.md
@@ -76,7 +76,7 @@ docker compose -f docker-compose.moldinsight.yml up -d
 docker compose -f docker-compose.inventory.yml up -d
 ```
 
-> 镜像首次构建：`bash deploy/build.sh`（build base → backend → celery → frontend 4 个 tag）。
+> 镜像首次构建：`bash deploy/build.sh`（build base → backend → frontend 3 个 tag，celery 复用 backend）；更新代码后用 `docker compose up -d --build` 重建（裸 `up -d` 不会重建已有镜像）。
 
 如需直接运行：
 
diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md
index 1c7aa86..a799c74 100644
--- a/docs/DEPLOYMENT.md
+++ b/docs/DEPLOYMENT.md
@@ -33,9 +33,17 @@
 首次部署或更新代码后先构建，再 `up`：
 
 ```bash
-bash deploy/build.sh        # 显式构建 base / backend / celery / frontend 4 个镜像
+bash deploy/build.sh        # 显式构建 base / backend / frontend 3 个镜像（celery 复用 backend）
 ```
 
+或让 compose 构建：
+
+```bash
+docker compose up -d --build
+```
+
+> **注意**：`docker compose up -d` 在本地已有同名镜像（如 `gemold-backend:latest`）时**不会自动重建**，会直接复用旧镜像启动。更新代码或 Dockerfile 后，必须 `docker compose build` 或 `docker compose up -d --build` 才会生效。
+
 详细 Linux 部署步骤：
 - [deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md)
 
diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md
index 59ac224..3085c66 100644
--- a/docs/OPERATIONS.md
+++ b/docs/OPERATIONS.md
@@ -93,7 +93,7 @@ docker compose -f docker-compose.inventory.yml up -d
 
 > 旧 `--profile` 写法已失效（服务不再声明 profiles）；模式切换唯一入口是 `-f` 文件名。
 
-- 镜像构建：`bash deploy/build.sh`（base → backend → celery → frontend 4 个 tag）；首次部署或更新代码后必须先 build 再 `up`。
+- 镜像构建：`bash deploy/build.sh`（base → backend → frontend 3 个 tag，celery 复用 backend 镜像）；首次部署或更新代码后必须先 build（或 `docker compose up -d --build`）——裸 `up` 对本地已有同名镜像**不会自动重建**。
 - PostgreSQL / Redis / RustFS 通常**复用服务器已有服务**，不由项目 compose 自带；容器只注入连接配置。
 
 ## 5. 运行时硬性要求
diff --git a/docs/deployment/LINUX_SETUP.md b/docs/deployment/LINUX_SETUP.md
index 5e1c40c..8bf9a11 100644
--- a/docs/deployment/LINUX_SETUP.md
+++ b/docs/deployment/LINUX_SETUP.md
@@ -427,7 +427,9 @@ curl http://127.0.0.1:8000/health
 镜像构建：
 
 ```bash
-bash deploy/build.sh        # base → backend → celery → frontend
+bash deploy/build.sh        # base → backend → frontend（celery 复用 backend 镜像）
+# 或让 compose 构建：docker compose up -d --build
+# 注意：docker compose up -d 对本地已有同名镜像不会自动重建，更新代码后需 --build
 ```
 
 ---