# 2026-06-09 — 接续方案：生产终验 + 部署 sync + Agent upgrade 对齐

## 变更摘要

1. **生产探针**：`prod_probe.py` 增加时区验收（日期 422、cron next_run、SPA bundle 可加载）。
2. **部署加固**：新增 `sync_webapp_to_container.sh`，挂接 `nexus-1panel.sh upgrade` 与 `deploy-production.sh`；`deploy-frontend.sh` 修复 `sudo docker` 探测。
3. **D-01**：`server/utils/agent_deploy.py` 统一单台/批量 upgrade 与 `web/agent/install.sh`（路径、pip 版本、agent_port）。
4. **文档**：`AI-HANDOFF-2026-06-09.md`；更新时区 verification 报告 §生产。

## 动机

接续方案 Path A～D：闭环时区生产验收、消除 Docker vite 缓存导致的前端 hash 漂移、消除 upgrade 命令三处重复与批量硬编码 8601 端口。

## 涉及文件

- `scripts/prod_probe.py`
- `deploy/sync_webapp_to_container.sh`（新）
- `deploy/nexus-1panel.sh` · `deploy/deploy-production.sh` · `deploy/deploy-frontend.sh`
- `server/utils/agent_deploy.py`（新）
- `server/api/servers.py` · `server/application/services/server_batch_service.py`
- `tests/test_agent_deploy.py`
- `docs/project/AI-HANDOFF-2026-06-09.md`
- `docs/reports/2026-06-09-operator-timezone-beijing-verification.md`

## 迁移 / 重启

- 无 DB 迁移。
- `sync_webapp_to_container.sh` 在下次 `upgrade` / `deploy-production` 时自动执行；可手动：`NEXUS_ROOT=/opt/nexus bash deploy/sync_webapp_to_container.sh`。

## 验证

```bash
NEXUS_PROBE_MODE=origin bash scripts/prod_health_check.sh
pytest tests/test_agent_deploy.py tests/test_operator_tz.py -q
bash deploy/pre_deploy_check.sh
```
