docs(openai): document force HTTP fallback

deploy/.env.example

@@ -285,6 +285,11 @@ GATEWAY_FORCE_CODEX_CLI=false
 GATEWAY_OPENAI_COMPACT_MODEL=gpt-5.4
 # OpenAI/Codex 等待上游响应头超时（秒）；0 表示不使用本地响应头超时截断。
 GATEWAY_OPENAI_RESPONSE_HEADER_TIMEOUT=0
+# 全局强制 OpenAI Responses 上游使用 HTTP/SSE，不使用 WebSocket。
+# 当代理或网络导致上游 WebSocket 反复重连时可设为 true；这不会禁用 HTTP/2。
+# 如需回退 HTTP/1.1，请另行设置 GATEWAY_OPENAI_HTTP2_ENABLED=false。
+# 将此项保存在持久化 .env 中，镜像更新或容器重建后会在启动时重新读取。
+GATEWAY_OPENAI_WS_FORCE_HTTP=false
 # OpenAI HTTP 上游默认启用 HTTP/2；如需紧急回滚可设为 false。
 GATEWAY_OPENAI_HTTP2_ENABLED=true
 GATEWAY_OPENAI_HTTP2_ALLOW_PROXY_FALLBACK_TO_HTTP1=true

deploy/config.example.yaml

@@ -329,7 +329,8 @@ gateway:
     # 按账号类型细分开关
     oauth_enabled: true
     apikey_enabled: true
-    # 全局强制 HTTP（紧急回滚开关）
+    # 全局强制 OpenAI Responses 上游使用 HTTP/SSE，不使用 WebSocket（紧急回滚开关）。
+    # 此开关不强制 HTTP/1.1；HTTP/2 由 gateway.openai_http2 单独控制。
     force_http: false
     # 允许在 WSv2 下按策略恢复 store=true（默认 false）
     allow_store_recovery: false