Merge pull request #4522 from wucm667/docs/issue-4518-http-bridge-prerequisite

docs: clarify OpenAI WS mode router prerequisite

frontend/src/i18n/__tests__/wsModeLocaleDesc.spec.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+
+import en from '../locales/en/admin/accounts'
+import zh from '../locales/zh/admin/accounts'
+
+describe('OpenAI WS mode locale descriptions', () => {
+  it('documents the global v2 router requirement for account WS modes', () => {
+    expect(zh.accounts.openai.wsModeDesc).toContain('mode_router_v2_enabled')
+    expect(zh.accounts.openai.wsModeDesc).toContain('http_bridge')
+    expect(en.accounts.openai.wsModeDesc).toContain('mode_router_v2_enabled')
+    expect(en.accounts.openai.wsModeDesc).toContain('http_bridge')
+  })
+})

frontend/src/i18n/locales/en/admin/accounts.ts

@@ -439,7 +439,8 @@ export default {
         responsesWebsocketsV2Desc:
           'Disabled by default. Enable to allow responses_websockets_v2 capability (still gated by global and account-type switches).',
         wsMode: 'WS mode',
-        wsModeDesc: 'Only applies to the current OpenAI account type.',
+        wsModeDesc:
+          'Only applies to the current OpenAI account type; account WS modes, including http_bridge, take effect only when the global gateway.openai_ws.mode_router_v2_enabled=true.',
         wsModeOff: 'Off (off)',
         wsModeCtxPool: 'Context Pool (ctx_pool)',
         wsModePassthrough: 'Passthrough (passthrough)',

frontend/src/i18n/locales/zh/admin/accounts.ts

@@ -543,7 +543,8 @@ export default {
         responsesWebsocketsV2Desc:
           '默认关闭。开启后可启用 responses_websockets_v2 协议能力（受网关全局开关与账号类型开关约束）。',
         wsMode: 'WS mode',
-        wsModeDesc: '仅对当前 OpenAI 账号类型生效。',
+        wsModeDesc:
+          '仅对当前 OpenAI 账号类型生效；包括 http_bridge 在内的账号 WS mode 仅在全局 gateway.openai_ws.mode_router_v2_enabled=true 时生效。',
         wsModeOff: '关闭（off）',
         wsModeCtxPool: '上下文池（ctx_pool）',
         wsModePassthrough: '透传（passthrough）',