# 直接覆盖源码并重启(最简单方式) 当前部署已经把前后台代码作为宿主机目录挂载到容器。日常修改源码时不需要重新打镜像,也不需要重新加载离线镜像。 ## 需要替换的目录 在 DeerFlow 部署目录中只替换以下内容: ```text source/ ├── backend/ │ ├── app/ # 替换为 offline-backend-20260512/backend/app │ ├── packages/ # 替换为 offline-backend-20260512/backend/packages │ └── tests/ # 替换为 offline-backend-20260512/backend/tests ├── frontend/ │ └── dist/ # 替换为 frontend-web 执行 pnpm build 后的 dist └── wheelhouse/ # 离线 Python wheel 与 requirements.txt;日常源码替换不要删除 ``` 注意:后端目录名是 `tests`,不是 `test`。 ## 前端怎么生成 dist 在开发或构建机器执行: ```bash cd frontend-web pnpm install pnpm build ``` 只把生成的 `frontend-web/dist/` 内容上传到部署目录的 `source/frontend/dist/`。服务器不需要 Node.js,也不会在启动时安装 npm 依赖。 ## 替换完成后重启 进入服务器当前 DeerFlow 部署目录: ```bash sudo ./OFFLINE_INSTALL.sh --restart ``` 该脚本只执行以下操作: 1. 检查四个代码目录和前端 `index.html`; 2. 从 `deploy.env` 重新生成数据库、模型和前端运行配置; 3. 检查 `source/wheelhouse`,仅在内容变化时离线安装依赖; 4. 使用一次性容器检查后端 Python 导入; 5. 依次重建并重启后端、前端容器; 6. 等待两个服务健康。 它不会执行数据库预检,不会 `docker load`,不会构建、拉取或删除镜像,也不会修改 `config/deploy.env`、数据库业务数据、技能、智能体或知识文件。容器会重建以应用新增的挂载和环境变量,但数据库卷、用户数据卷、浏览器上下文卷和 Python 依赖卷均保留。 ## 哪些修改不能这样更新 如果修改了以下内容,不能只覆盖源码: - 后端 `pyproject.toml`、`uv.lock`、`requirements-offline.txt` 中涉及无法通过纯 Python wheel 提供的依赖; - 系统软件、Python/Office/浏览器依赖; - Nginx 镜像运行环境; - Dockerfile 或容器启动命令。 这些修改涉及系统运行环境,需要重新制作基础镜像包。新增普通纯 Python/C-extension wheel 时,可按 `docs/13-wheelhouse离线新增依赖与多模型.md` 操作,无需重做镜像;单纯修改后端 `app/packages/tests` 和前端页面代码可以直接覆盖。 ## 建议的安全替换方式 上传时先放到临时目录,确认完整后再改名覆盖,避免服务运行期间读到上传一半的文件。替换之前可复制一份旧目录作为备份;若新代码有问题,恢复旧目录后再次运行 `OFFLINE_INSTALL.sh --restart`。