# P2/M3 浸泡切换记录(2026-08-31)

## 当前拓扑
```
浏览器 → BFF 8090 (sdk/, plantai-bff)
           ├─ qa → 127.0.0.1:7921  agent/qa 编译树(45 个 .so,部署目录 plantai-rag-new-deploy/qa)
           ├─ rag → 8000 (Methodology 宿主进程,未动)
           ├─ ragAlt → 7900 (旧容器,未动)
           └─ neo4j → 18788 (直连,未动)
生产容器 qa-normalized-formal-20260828 (7920) 仍在运行 —— 30 天回滚窗
```

## 切换动作
1. 编译树部署到 `/home/xzq/5090/teamWorkspace/zh/plantai-rag-new-deploy/qa/`
2. `sdk/.env` 追加 `QA_BASE_URL=http://127.0.0.1:7921`
3. `deploy/bff_restart.sh 0.0.0.0` 重启 BFF

## 验证结果
| 项 | 结果 |
|---|---|
| 7921 /health | version=1.1.73-assertion-anchored, entities=6316654 ✓ |
| BFF qa 依赖证明 | 停 7921 → BFF qa.ok=false;恢复 → true ✓ |
| /api/qa/chat 非流式 | 真实回答(136s,完整引文) ✓ |
| /api/qa/chat/stream SSE | progress 帧正常(planning 相位) ✓ |
| 会话落库 | soak-m3-1/2 写入,历史 2 会话保留 ✓ |

## 回滚方法(一行)
```
# 删除 sdk/.env 中 QA_BASE_URL 行后:
bash deploy/bff_restart.sh 0.0.0.0   # QA 回到默认 7920(容器)
```

## 浸泡计划
- 浸泡 1–2 天(生产容器全程存活)
- 期间验证:前端问答/检索/KG/figures 四流
- 浸泡通过后:stop(不删)容器 qa-normalized-formal-20260828,7921 端口互换至 7920

## 附注:KG /overview 慢查询(既有问题,非本次引入)
- /api/kg/overview 对 1644 万边 COUNT 聚合,直连 Neo4j 18788 基准 >100s(服务端聚合冷缓存)
- 08-25 已设 OVERVIEW_QUERY_TIMEOUT=60 → 超时返回 503 信封
- /api/kg/status 快路径正常(3820996 实体/8246875 断言),前端 KG 浏览不受影响
- 待办:Neo4j 预热或聚合物化(不属本次重构范围)

## 端口终态修订(2026-08-31 用户决定)
最终端口统一 8090 段:BFF 8090 / QA 8091 / Methodology 8092 / legacy 8093。
当前浸泡端口 7921 不变,浸泡期满后影子 restart 到 8091 并删 .env 覆盖。