Merge pull request #853 from AAEE86/feat/codex-fingerprint-help

feat(frontend): improve Codex fingerprint setting guidance

frontend/src/features/providers/components/ProviderFormDialog.vue

@@ -250,12 +250,18 @@
           data-testid="codex-fingerprint-convergence-setting"
         >
           <div class="space-y-0.5">
-            <Label
-              for="codex-fingerprint-convergence"
-              class="text-sm font-medium"
-            >
-              {{ legacyT('Codex 指纹收敛') }}
-            </Label>
+            <div class="flex items-center gap-1">
+              <Label
+                for="codex-fingerprint-convergence"
+                class="text-sm font-medium"
+              >
+                {{ legacyT('Codex 指纹收敛（推荐开启）') }}
+              </Label>
+              <HelpHint
+                :label="legacyT('Codex 指纹收敛（推荐开启）')"
+                :text="legacyT('开启后，Aether 会根据当前账号身份为出站请求统一生成并写入以下标识，使同一 Codex 账号在上游看来始终是同一设备与会话：\n\n• 请求头：installation_id、session_id、thread_id、window_id、turn_id 等\n• 请求体（Responses 格式）：client_metadata 与 prompt_cache_key 中的对应字段\n\n关闭时保持客户端原始透传，不做任何改写。建议开启以提升上游指纹稳定性与会话连续性。')"
+              />
+            </div>
             <p class="text-xs text-muted-foreground leading-relaxed">
               {{ legacyT('统一同一 Codex 身份的设备与会话标识；关闭时保持现有透传行为。') }}
             </p>
@@ -263,7 +269,7 @@
           <Switch
             id="codex-fingerprint-convergence"
             :model-value="form.codex_fingerprint_convergence_enabled"
-            :aria-label="legacyT('Codex 指纹收敛')"
+            :aria-label="legacyT('Codex 指纹收敛（推荐开启）')"
             @update:model-value="(v: boolean) => form.codex_fingerprint_convergence_enabled = v"
           />
         </div>
@@ -280,7 +286,7 @@
               {{ legacyT('Responses WebSocket 模式') }}
             </Label>
             <p class="text-xs text-muted-foreground leading-relaxed">
-              {{ legacyT('允许此提供商处理标准 Responses API WebSocket 请求。仅在已验证兼容性后启用。') }}
+              {{ legacyT('允许此提供商处理标准 Responses API WebSocket 请求。') }}
             </p>
           </div>
           <Switch
@@ -336,6 +342,7 @@ import {
   Switch,
 } from '@/components/ui'
 import { Server, SquarePen } from 'lucide-vue-next'
+import HelpHint from '@/components/common/HelpHint.vue'
 import { useToast } from '@/composables/useToast'
 import { useFormDialog } from '@/composables/useFormDialog'
 import { useI18n } from '@/i18n'