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
 ```
 
 ---