端口终态修订:BFF 8090 / QA 8091 / Methodology 8092 / legacy 8093

- config.py 默认值改终态(浸泡期 .env 覆盖 7921/8001/7911 继续生效)
- extraction _DEFAULT_ALT=8093;三个 start.sh 默认端口改终态
- 运行中服务零触碰:浸泡端口不变,BFF 未重启,旧服务不动
- 验证:sdk pytest 125 绿,BFF 五上游仍绿(env 覆盖优先)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

agent/README.md

@@ -2,9 +2,9 @@
 
 | 目录 | 服务 | 端口 | 入口(白名单明文) | conda |
 |---|---|---|---|---|
-| qa/ | QA V1.1.73 断言锚定检索 | 7920(影子 7921) | scripts/qa_v1_1_73_server.py | gfpy312 |
-| methodology/ | Methodology 提取 | 8000(影子 8001) | scripts/methodology_server.py | gfpy312 |
-| legacy-rag/ | 旧路由族(11 路由) | 7910(影子 7911) | api/main.py | test4py311 |
+| qa/ | QA V1.1.73 断言锚定检索 | 8091(浸泡影子 7921) | scripts/qa_v1_1_73_server.py | gfpy312 |
+| methodology/ | Methodology 提取 | 8092(浸泡影子 8001) | scripts/methodology_server.py | gfpy312 |
+| legacy-rag/ | 旧路由族(app 3 路由/main 11 族) | 8093(浸泡影子 7911) | api/app.py | plantai-bff |
 | vendor/ | 共享源码池(非服务) | — | — | — |
 
 约束：仅 shell 启动(`scripts/{start,stop,status,restart}.sh`)；编译产物 `.so` 隐藏源码；`compile.manifest` 记录模块级白名单。vendor 为源码单份，编译时复制进各 agent 暂存目录。

agent/legacy-rag/scripts/start.sh

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
 # agent/legacy-rag/scripts/start.sh —— 旧路由族服务唯一启动接口
-# 用法：bash scripts/start.sh [port] [app|main]
+main]|main]
 #   app  = 3 路由(生产 7900 同源,默认) / main = 11 路由裁剪版
 set -euo pipefail
 AGENT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-PORT="${1:-7910}"
+PORT="${1:-8093}"  # 终态端口(浸泡期显式传 7911)
 ENTRY="${2:-app}"
 ENV_FILE="${LEGACY_ENV_FILE:-$AGENT_ROOT/env/prod.env}"
 LOG_FILE="${LEGACY_LOG_FILE:-/tmp/plantai-agent-legacy-$PORT.log}"

agent/methodology/scripts/start.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 # agent/methodology/scripts/start.sh —— Methodology 服务唯一启动接口
-# 用法：bash scripts/start.sh [port]   （默认 8000；影子冒烟用 8001）
+# 用法：bash scripts/start.sh [port]   （默认 8092 终态；浸泡期影子用 8001）
 set -euo pipefail
 AGENT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-PORT="${1:-8000}"
+PORT="${1:-8092}"  # 终态端口(浸泡期显式传 8001)
 ENV_FILE="${METHODOLOGY_ENV_FILE:-$AGENT_ROOT/env/prod.env}"
 LOG_FILE="${METHODOLOGY_LOG_FILE:-/tmp/plantai-agent-methodology-$PORT.log}"
 PID_FILE="$AGENT_ROOT/run/methodology-$PORT.pid"

agent/qa/scripts/start.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 # agent/qa/scripts/start.sh —— QA V1.1.73 服务唯一启动接口
-# 用法：bash scripts/start.sh [port]   （默认 7920；影子冒烟用 7921）
+# 用法：bash scripts/start.sh [port]   （默认 8091 终态；浸泡期影子用 7921）
 set -euo pipefail
 AGENT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-PORT="${1:-7920}"
+PORT="${1:-8091}"  # 终态端口(浸泡期显式传 7921)
 ENV_FILE="${QA_ENV_FILE:-$AGENT_ROOT/env/prod.env}"
 LOG_FILE="${QA_LOG_FILE:-/tmp/plantai-agent-qa-$PORT.log}"
 PID_FILE="$AGENT_ROOT/run/qa-$PORT.pid"

docs/SOAK_M3.md

@@ -40,3 +40,7 @@ bash deploy/bff_restart.sh 0.0.0.0   # QA 回到默认 7920(容器)
 - 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 覆盖。

docs/SOAK_M4.md

@@ -25,3 +25,6 @@
 ## 待办(端口互换后)
 - 浸泡通过后:停宿主进程 8000(脚本/env 留作回滚),部署树绑 8000
 - 数据根迁移:methodology_upload_jobs(560M)快照复制到新数据根(零软链)
+
+## 端口终态修订(2026-08-31)
+Methodology 终态端口 8092(浸泡期 8001 不变)。

docs/SOAK_M5.md

@@ -28,3 +28,6 @@
 ## 回滚
 - 每键一行: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。

sdk/app/config.py

@@ -28,11 +28,11 @@ class Settings(BaseSettings):
     version: str = "0.1.0"
 
     # ---- 上游地址（只读消费，见 ARCHITECTURE.md §2）----
-    qa_base_url: str = "http://127.0.0.1:7920"
+    qa_base_url: str = "http://127.0.0.1:8091"  # 终态端口(浸泡期由 .env 覆盖 7921)
     qa_api_path: str = "/api/v1/qa-v1-1-73"
-    rag_base_url: str = "http://127.0.0.1:8000"
-    rag_alt_base_url: str = "http://127.0.0.1:7900"
-    rag_legacy_base_url: str = "http://127.0.0.1:7910"
+    rag_base_url: str = "http://127.0.0.1:8092"  # 终态端口(浸泡期由 .env 覆盖 8001)
+    rag_alt_base_url: str = "http://127.0.0.1:8093"  # 终态端口(浸泡期由 .env 覆盖 7911)
+    rag_legacy_base_url: str = "http://127.0.0.1:8093"
 
     # ---- Neo4j 候选（顺序即回退顺序，首选 18788；凭据见 DISCOVERY §2.1）----
     neo4j_bolt_uris: str = (

sdk/app/services/extraction.py

@@ -21,7 +21,7 @@ logger = logging.getLogger(__name__)
 
 _UPSTREAM_PREFIX = "/api/v1/methodology"
 _DEFAULT_PRIMARY = "http://127.0.0.1:8000"
-_DEFAULT_ALT = "http://127.0.0.1:7911"  # 2026-08-31:7900 退役,回落 agent/legacy-rag
+_DEFAULT_ALT = "http://127.0.0.1:8093"  # 终态(浸泡期由 RAG_ALT_BASE_URL env 覆盖 7911)
 
 PRIMARY_BASE_URL = os.environ.get("RAG_BASE_URL", _DEFAULT_PRIMARY)
 ALT_BASE_URL = os.environ.get("RAG_ALT_BASE_URL", _DEFAULT_ALT)