From 2e6dcd98d7a9ac49e066bb000cd3a682ea078d0c Mon Sep 17 00:00:00 2001
From: jerry <jerry@team.local>
Date: Mon, 31 Aug 2026 13:37:49 +0800
Subject: [PATCH] =?UTF-8?q?P2/M3:=20=E6=B5=B8=E6=B3=A1=E5=88=87=E6=8D=A2?=
 =?UTF-8?q?=E9=83=A8=E7=BD=B2=E5=AE=8C=E6=88=90(BFF=E2=86=92agent/qa=20?=
 =?UTF-8?q?=E7=BC=96=E8=AF=91=E6=A0=91=207921,=E5=9B=9E=E6=BB=9A=E7=AA=97?=
 =?UTF-8?q?=E5=8F=A3=E5=BC=80=E5=90=AF)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs/SOAK_M3.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 docs/SOAK_M3.md

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