diff --git a/docs/SOAK_M3.md b/docs/SOAK_M3.md
new file mode 100644
index 0000000..9ee43a0
--- /dev/null
+++ b/docs/SOAK_M3.md
@@ -0,0 +1,36 @@
+# 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