# P4/M5 浸泡切换记录(2026-08-31)

## 当前拓扑(四上游全切编译树,生产全程存活)
```
浏览器 → BFF 8090 (sdk/, plantai-bff)
           ├─ qa     → 7921 agent/qa 编译树(45 .so)         [生产容器 7920 存活]
           ├─ rag    → 8001 agent/methodology 编译树(28 .so)  [宿主进程 8000 存活]
           ├─ ragAlt → 7900 (protected 容器,未动)
           ├─ legacy → 7911 agent/legacy-rag 编译树(463 .so)  [7900 容器存活,新键]
           └─ neo4j  → 18788 直连
```

## SDK 变更
- config.py +rag_legacy_base_url(默认 7910)
- upstream.py +legacy 健康键(probe_all 五上游)
- 新增 routers/legacy.py:13 族前缀白名单代理(/rag /kg /kg-rag /kb-qa /v15-* /advanced /raptor /temporal /species /reasoning /case /analysis),阻塞调用走线程池

## 验证
| 项 | 结果 |
|---|---|
| BFF /api/health | 五上游全绿(含新 legacy 键) ✓ |
| 经 BFF 代理 kg/stats | 200(3.9s) 数据与 7900 同源(normalized 后端) ✓ |
| 经 BFF 代理 kg/families | 200 ✓ |
| 非白名单路径 | 404 信封,不代理 ✓ |
| sdk pytest | 125 通过 ✓ |
| 编译树 audit | 463 .so,0 错误,3 白名单模块登记理由 ✓ |

## 回滚
- 每键一行:sdk/.env 删 QA_BASE_URL / RAG_BASE_URL / RAG_LEGACY_BASE_URL → bff_restart
- 7900 容器与 QA 容器、Methodology 宿主进程均存活(30 天窗)

## 端口终态修订(2026-08-31)
legacy 终态端口 8093(浸泡期 7911 不变);extraction 回退终态 8093。