fix: harden file download flow

README.md

@@ -9,7 +9,7 @@ SVN 日志抓取与 AI 工作量分析工具，统一使用 Web 工作台入口
 ## 常用命令
 
 ```bash
-# 一键启动（Docker）
+# 一键启动（Docker，每次会重新构建镜像并打包最新代码）
 make up
 
 # 查看状态
@@ -28,6 +28,12 @@ mvn clean package -DskipTests
 mvn spring-boot:run -Dspring-boot.run.mainClass=com.svnlog.web.WebApplication
 ```
 
+## Docker 构建缓存说明
+
+- `make up` 会始终执行 `docker compose up -d --build`，因此每次都会重新打包最新代码。
+- Docker 构建默认启用 BuildKit；首次构建会下载 Maven 依赖，后续在 `pom.xml` 未变化时会复用 `/root/.m2` 构建缓存，通常不会重复大规模下载。
+- 以下情况会触发依赖重新解析或重新下载：修改 `pom.xml`、执行 `docker builder prune` 清理构建缓存、切换到另一套 Docker Builder / Docker 环境。
+
 ## 代码结构
 
 - `com.svnlog.web`：Web 入口、控制器、DTO、服务