From ebd053c87ea752fa1845944c303ed09ea6b181be Mon Sep 17 00:00:00 2001
From: IanShaw027 <ianshaw027@gmail.com>
Date: Tue, 21 Apr 2026 13:07:40 +0800
Subject: [PATCH] docs: clarify openai scheduler flag semantics

---
 frontend/src/views/admin/SettingsView.vue              |  6 +++---
 .../src/views/admin/__tests__/SettingsView.spec.ts     | 10 ++++++++++
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/frontend/src/views/admin/SettingsView.vue b/frontend/src/views/admin/SettingsView.vue
index 9fb8da41..e56afe5f 100644
--- a/frontend/src/views/admin/SettingsView.vue
+++ b/frontend/src/views/admin/SettingsView.vue
@@ -1877,13 +1877,13 @@
               <div class="flex items-center justify-between rounded border border-gray-200 px-4 py-3 dark:border-dark-700">
                 <div>
                   <label class="text-sm font-medium text-gray-700 dark:text-gray-300">
-                    {{ localText('OpenAI 高级调度器', 'OpenAI advanced scheduler') }}
+                    {{ localText('OpenAI 实验调度策略', 'OpenAI experimental scheduler policy') }}
                   </label>
                   <p class="mt-0.5 text-xs text-gray-500 dark:text-gray-400">
                     {{
                       localText(
-                        '切换 OpenAI 侧新增的高级调度开关，供当前分支实验性调度逻辑使用。',
-                        'Toggles the new OpenAI advanced scheduler flag for the experimental routing logic on this branch.'
+                        '默认关闭。开启后仅影响本网关在 OpenAI 账号间的实验性调度选择逻辑，不代表上游 OpenAI 官方能力。',
+                        'Disabled by default. When enabled, this only changes the gateway\'s experimental account-selection policy for OpenAI traffic; it does not indicate an upstream OpenAI capability.'
                       )
                     }}
                   </p>
diff --git a/frontend/src/views/admin/__tests__/SettingsView.spec.ts b/frontend/src/views/admin/__tests__/SettingsView.spec.ts
index b6f8ab17..3541d994 100644
--- a/frontend/src/views/admin/__tests__/SettingsView.spec.ts
+++ b/frontend/src/views/admin/__tests__/SettingsView.spec.ts
@@ -472,4 +472,14 @@ describe('admin SettingsView payment visible method controls', () => {
     expect(showError).toHaveBeenCalled()
     expect(String(showError.mock.calls.at(-1)?.[0] ?? '')).toContain('支付来源')
   })
+
+  it('renders advanced scheduler copy as local experimental gateway policy', async () => {
+    const wrapper = mountView()
+
+    await flushPromises()
+
+    expect(wrapper.text()).toContain('OpenAI 实验调度策略')
+    expect(wrapper.text()).toContain('默认关闭。开启后仅影响本网关在 OpenAI 账号间的实验性调度选择逻辑')
+    expect(wrapper.text()).not.toContain('OpenAI 高级调度器')
+  })
 })