fix: format version install statistics

package.json

@@ -1,6 +1,6 @@
 {
   "name": "moviepilot",
-  "version": "2.13.1-1",
+  "version": "2.13.2",
   "private": true,
   "type": "module",
   "bin": "dist/service.js",

src/api/types.ts

@@ -1292,7 +1292,7 @@ export interface TransferForm {
   // 目标存储
   target_storage: string
   // 目标路径
-  target_path: string
+  target_path: string | null
   // TMDB ID
   tmdbid?: number
   // 豆瓣 ID
@@ -1335,6 +1335,22 @@ export interface ManualTransferPayload extends Omit<TransferForm, 'fileitem'> {
   fileitems?: FileItem[]
 }
 
+// 手动整理目的路径匹配结果
+export interface ManualTransferTargetPathData {
+  // 目标存储
+  target_storage?: string | null
+  // 目标路径
+  target_path?: string | null
+  // 整理方式
+  transfer_type?: string | null
+  // 刮削
+  scrape?: boolean
+  // 媒体库类型子目录
+  library_type_folder?: boolean
+  // 媒体库类别子目录
+  library_category_folder?: boolean
+}
+
 // 手动整理预览统计
 export interface ManualTransferPreviewSummary {
   // 总数
@@ -1369,6 +1385,14 @@ export interface ManualTransferPreviewItem {
   episode_end?: number | string
   // Part
   part?: string
+  // 原始识别字符串
+  org_string?: string
+  // 应用的自定义识别词
+  apply_words?: string[]
+  // 制作组/字幕组
+  resource_team?: string
+  // 自定义占位符
+  customization?: string
 }
 
 // 手动整理预览数据

src/components/dialog/AboutDialog.vue

@@ -102,6 +102,15 @@ const frontendVersionStatistics = computed(() => versionStatistic.value?.fronten
 // 活跃用户统计
 const activeUsers = computed(() => versionStatistic.value?.active_users ?? {})
 
+/** 格式化版本安装统计数字为千分位展示。 */
+function formatVersionStatisticNumber(value: unknown) {
+  const numberValue = Number(value ?? 0)
+
+  if (!Number.isFinite(numberValue)) return '0'
+
+  return numberValue.toLocaleString()
+}
+
 // 打开日志对话框
 function showReleaseDialog(title: string, body: string) {
   releaseDialogTitle.value = title
@@ -473,19 +482,19 @@ onMounted(() => {
           <div class="version-stat-summary">
             <div>
               <div class="text-caption text-medium-emphasis">{{ t('setting.about.totalInstallUsers') }}</div>
-              <div class="version-stat-number">{{ versionStatistic.total_users ?? 0 }}</div>
+              <div class="version-stat-number">{{ formatVersionStatisticNumber(versionStatistic.total_users) }}</div>
             </div>
             <div>
               <div class="text-caption text-medium-emphasis">{{ t('setting.about.activeToday') }}</div>
-              <div class="version-stat-number">{{ activeUsers.today ?? 0 }}</div>
+              <div class="version-stat-number">{{ formatVersionStatisticNumber(activeUsers.today) }}</div>
             </div>
             <div>
               <div class="text-caption text-medium-emphasis">{{ t('setting.about.active7Days') }}</div>
-              <div class="version-stat-number">{{ activeUsers.last_7_days ?? 0 }}</div>
+              <div class="version-stat-number">{{ formatVersionStatisticNumber(activeUsers.last_7_days) }}</div>
             </div>
             <div>
               <div class="text-caption text-medium-emphasis">{{ t('setting.about.active30Days') }}</div>
-              <div class="version-stat-number">{{ activeUsers.last_30_days ?? 0 }}</div>
+              <div class="version-stat-number">{{ formatVersionStatisticNumber(activeUsers.last_30_days) }}</div>
             </div>
           </div>
           <div class="mt-5">
@@ -502,7 +511,7 @@ onMounted(() => {
                   <td>
                     <code>{{ item.version }}</code>
                   </td>
-                  <td class="text-end">{{ item.count }}</td>
+                  <td class="text-end">{{ formatVersionStatisticNumber(item.count) }}</td>
                 </tr>
                 <tr v-if="!backendVersionStatistics.length">
                   <td colspan="2" class="text-medium-emphasis">{{ t('setting.about.noVersionStatisticData') }}</td>
@@ -524,7 +533,7 @@ onMounted(() => {
                   <td>
                     <code>{{ item.version }}</code>
                   </td>
-                  <td class="text-end">{{ item.count }}</td>
+                  <td class="text-end">{{ formatVersionStatisticNumber(item.count) }}</td>
                 </tr>
                 <tr v-if="!frontendVersionStatistics.length">
                   <td colspan="2" class="text-medium-emphasis">{{ t('setting.about.noVersionStatisticData') }}</td>

src/components/dialog/ReorganizeDialog.vue

@@ -10,6 +10,7 @@ import {
   ManualTransferPayload,
   ManualTransferPreviewData,
   ManualTransferPreviewItem,
+  ManualTransferTargetPathData,
   StorageConf,
   TransferDirectoryConf,
   TransferForm,
@@ -113,6 +114,14 @@ const episodeFormatRecommendState = reactive<{
 
 const episodeFormatRuleConfigured = ref<boolean | undefined>(undefined)
 
+interface ManualTransferTargetPathRequest {
+  fileitem?: FileItem
+  fileitems?: FileItem[]
+  logid?: number
+  logids?: number[]
+  target_storage?: string | null
+}
+
 // 生成文件项稳定键，用于去重和状态同步。
 function getFileItemKey(item?: FileItem) {
   return [item?.storage ?? '', item?.type ?? '', item?.path ?? ''].join('|')
@@ -265,7 +274,7 @@ const transferForm = reactive<TransferForm>({
   fileitem: {} as FileItem,
   logid: 0,
   target_storage: props.target_storage ?? 'local',
-  target_path: props.target_path ?? '',
+  target_path: normalizeTargetPath(props.target_path),
   transfer_type: '',
   min_filesize: 0,
   scrape: false,
@@ -292,6 +301,79 @@ const targetDirectories = computed(() => {
   return [...new Set(libraryDirectories)]
 })
 
+// 构造目的路径自动匹配请求，只传用户真实上下文，避免用默认存储误导后端匹配。
+function createTargetPathMatchRequest(): ManualTransferTargetPathRequest | undefined {
+  const payload: ManualTransferTargetPathRequest = {}
+
+  if (props.target_storage) {
+    payload.target_storage = props.target_storage
+  }
+
+  if (normalizedItems.value.length === 1) {
+    payload.fileitem = normalizedItems.value[0]
+    return payload
+  }
+
+  if (normalizedItems.value.length > 1) {
+    payload.fileitems = normalizedItems.value
+    return payload
+  }
+
+  if (props.logids?.length) {
+    if (props.logids.length > 1) {
+      payload.logids = props.logids
+      return payload
+    }
+
+    payload.logid = props.logids[0]
+    return payload
+  }
+}
+
+// 应用后端匹配到的目的路径配置，未匹配时保持 null 等待用户手工选择。
+function applyMatchedTargetPath(data?: ManualTransferTargetPathData) {
+  const matchedTargetPath = normalizeTargetPath(data?.target_path)
+  if (!matchedTargetPath) {
+    transferForm.target_path = null
+    return
+  }
+
+  transferForm.target_storage = data?.target_storage || transferForm.target_storage || 'local'
+  transferForm.transfer_type = data?.transfer_type || transferForm.transfer_type
+  transferForm.scrape = data?.scrape ?? false
+  transferForm.library_type_folder = data?.library_type_folder ?? false
+  transferForm.library_category_folder = data?.library_category_folder ?? false
+  transferForm.target_path = matchedTargetPath
+}
+
+// 请求后端按源目录匹配最合适的手动整理目的路径。
+async function autoSelectTargetPath() {
+  if (normalizeTargetPath(props.target_path) || transferForm.target_path) return
+
+  const payload = createTargetPathMatchRequest()
+  if (!payload) {
+    transferForm.target_path = null
+    return
+  }
+
+  try {
+    const result = await api.post<ApiResponse<ManualTransferTargetPathData>, ApiResponse<ManualTransferTargetPathData>>(
+      'transfer/manual/target-path',
+      payload,
+    )
+
+    if (!result.success) {
+      transferForm.target_path = null
+      return
+    }
+
+    applyMatchedTargetPath(result.data)
+  } catch (error) {
+    console.log(error)
+    transferForm.target_path = null
+  }
+}
+
 // 监听目的路径变化，配置默认值
 watch(
   () => transferForm.target_path,
@@ -397,6 +479,12 @@ function getUniqueValues(values: (string | undefined)[]) {
   return [...new Set(values.map(item => item?.trim()).filter(Boolean) as string[])]
 }
 
+// 归一化可选目的路径，保证未指定时向接口传递 null 而不是空字符串。
+function normalizeTargetPath(path?: string | null) {
+  const normalizedPath = path?.trim()
+  return normalizedPath || null
+}
+
 // 统一解析接口返回的数字字段，兼容 string/number
 function toPreviewNumber(value: unknown) {
   if (value === undefined || value === null || value === '') return undefined
@@ -511,6 +599,22 @@ const previewFileRows = computed(() => {
   })
 })
 
+// 标准化预览项中的识别词命中详情
+function getPreviewApplyWords(item: ManualTransferPreviewItem) {
+  return (item.apply_words ?? []).filter(Boolean)
+}
+
+// 手动整理识别词应用详情
+const previewCustomWordDetails = computed(() => {
+  return filteredPreviewItems.value
+    .map(item => ({
+      sourceName: getFileName(item.source),
+      orgString: item.org_string,
+      applyWords: getPreviewApplyWords(item),
+    }))
+    .filter(item => item.applyWords.length > 0)
+})
+
 // 是否需要拓宽窗口
 const previewNeedsWideLayout = computed(() => {
   const candidates = [...previewFileRows.value.map(item => `${item.sourceName}${item.targetName}`)]
@@ -620,6 +724,7 @@ function createTransferPayload(options: { item?: FileItem; items?: FileItem[]; l
     ...transferForm,
     fileitem: sourceItem,
     logid: options.logid ?? 0,
+    target_path: normalizeTargetPath(transferForm.target_path),
     episode_group: transferForm.episode_group?.trim() || null,
   }
 
@@ -1099,8 +1204,9 @@ async function transfer(background: boolean = false) {
   emit('done')
 }
 
-onMounted(() => {
-  loadDirectories()
+onMounted(async () => {
+  await loadDirectories()
+  await autoSelectTargetPath()
   loadStorages()
   loadEpisodeFormatRuleConfiguration()
 })
@@ -1439,6 +1545,36 @@ onUnmounted(() => {
                         <span class="preview-overview-card__value">{{ previewEpisodeCountText }}</span>
                       </div>
                     </div>
+                    <div v-if="previewCustomWordDetails.length" class="preview-custom-words">
+                      <div class="preview-custom-words__title">
+                        <VIcon icon="mdi-tag-text-outline" size="16" />
+                        <span>{{ t('dialog.reorganize.customWordsApplied') }}</span>
+                      </div>
+                      <div class="preview-custom-words__items">
+                        <div
+                          v-for="(detail, index) in previewCustomWordDetails"
+                          :key="`${detail.sourceName}-${index}`"
+                          class="preview-custom-words__item"
+                        >
+                          <div class="preview-custom-words__source">{{ detail.sourceName }}</div>
+                          <div v-if="detail.orgString" class="preview-custom-words__original">
+                            {{ detail.orgString }}
+                          </div>
+                          <div class="preview-custom-words__chips">
+                            <VChip
+                              v-for="(word, wordIndex) in detail.applyWords"
+                              :key="`${word}-${wordIndex}`"
+                              variant="outlined"
+                              color="info"
+                              size="small"
+                              class="preview-custom-words__chip"
+                            >
+                              {{ word }}
+                            </VChip>
+                          </div>
+                        </div>
+                      </div>
+                    </div>
                   </div>
                   <div class="reorganize-preview-list">
                     <div v-if="pagedPreviewRows.length" ref="previewFileBodyRef" class="preview-file-body">
@@ -1698,6 +1834,66 @@ onUnmounted(() => {
   white-space: nowrap;
 }
 
+.preview-custom-words {
+  display: flex;
+  flex-direction: column;
+  border: 1px solid rgba(var(--v-border-color), var(--v-border-opacity));
+  border-radius: 0.75rem;
+  gap: 0.75rem;
+  padding-block: 0.875rem;
+  padding-inline: 1rem;
+}
+
+.preview-custom-words__title {
+  display: inline-flex;
+  align-items: center;
+  color: rgb(var(--v-theme-info));
+  font-size: 0.875rem;
+  font-weight: 600;
+  gap: 0.375rem;
+}
+
+.preview-custom-words__items {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  min-inline-size: 0;
+}
+
+.preview-custom-words__item {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+  min-inline-size: 0;
+}
+
+.preview-custom-words__source {
+  overflow-wrap: anywhere;
+  color: rgb(var(--v-theme-on-surface));
+  font-size: 0.8125rem;
+  font-weight: 600;
+  line-height: 1.4;
+}
+
+.preview-custom-words__original {
+  overflow-wrap: anywhere;
+  color: rgba(var(--v-theme-on-surface), var(--v-medium-emphasis-opacity));
+  font-size: 0.75rem;
+  line-height: 1.4;
+}
+
+.preview-custom-words__chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.375rem;
+  min-inline-size: 0;
+}
+
+.preview-custom-words__chip {
+  max-inline-size: 100%;
+  white-space: normal;
+}
+
 .reorganize-preview-pane__scroll {
   display: flex;
   overflow: hidden auto;
@@ -1797,11 +1993,13 @@ onUnmounted(() => {
 }
 
 .preview-file-row__path {
-  overflow: hidden;
+  overflow: visible;
+  overflow-wrap: anywhere;
   color: rgba(var(--v-theme-on-surface), var(--v-medium-emphasis-opacity));
   font-size: 0.8125rem;
-  text-overflow: ellipsis;
-  white-space: nowrap;
+  line-height: 1.4;
+  white-space: normal;
+  word-break: break-all;
 }
 
 .preview-file-row__card--target .preview-file-row__name {

src/components/dialog/SearchSiteDialog.vue

@@ -10,7 +10,7 @@ const props = defineProps({
     type: Array as PropType<Site[]>,
     required: true,
   },
-  selected: Array as PropType<Number[]>,
+  selected: Array as PropType<number[]>,
 })
 
 // 定义事件
@@ -20,38 +20,66 @@ const emit = defineEmits(['close', 'search', 'reload'])
 const siteFilter = ref('')
 
 // 已选择站点
-const selectedSites = ref<any[]>(props.selected || [])
+const selectedSites = ref<number[]>([])
+
+// 根据当前可用站点清理选中项，避免停用或已删除站点参与计数。
+function normalizeSelectedSites(selectedSiteIds: number[] = []) {
+  const availableSiteIds = new Set(props.sites.map((site: Site) => site.id))
+  const normalizedSiteIds: number[] = []
+
+  selectedSiteIds.forEach(siteId => {
+    if (availableSiteIds.has(siteId) && !normalizedSiteIds.includes(siteId)) {
+      normalizedSiteIds.push(siteId)
+    }
+  })
+
+  return normalizedSiteIds
+}
 
 watch(
-  () => props.selected,
-  value => {
-    if (selectedSites.value.length == 0 && value) {
-      selectedSites.value = value
-    }
+  [() => props.selected, () => props.sites],
+  ([value]) => {
+    selectedSites.value = normalizeSelectedSites(value || [])
   },
+  { immediate: true },
 )
 
 // 全选/全不选按钮文字
 const checkAllText = computed(() => {
-  return selectedSites.value.length < props.sites?.length
+  return selectedSites.value.length < props.sites.length
     ? t('dialog.searchSite.selectAll')
     : t('dialog.searchSite.deselectAll')
 })
 
 // 全选/全不选
 const checkAllSitesorNot = () => {
-  if (selectedSites.value.length < props.sites?.length) {
-    selectedSites.value = props.sites?.map((item: Site) => item.id)
+  if (selectedSites.value.length < props.sites.length) {
+    selectedSites.value = props.sites.map((item: Site) => item.id)
   } else {
     selectedSites.value = []
   }
 }
 
+// 切换单个站点的选择状态。
+function toggleSiteSelection(siteId: number) {
+  const index = selectedSites.value.indexOf(siteId)
+  if (index === -1) {
+    selectedSites.value.push(siteId)
+  } else {
+    selectedSites.value.splice(index, 1)
+  }
+}
+
+// 确认搜索时只提交当前可用站点。
+function confirmSearch() {
+  emit('search', normalizeSelectedSites(selectedSites.value))
+}
+
 // 根据筛选条件过滤站点
 const filteredSites = computed(() => {
   if (!siteFilter.value) return props.sites
   const filter = siteFilter.value.toLowerCase()
-  return props.sites?.filter((site: Site) => site.name.toLowerCase().includes(filter))
+  return props.sites.filter((site: Site) => site.name.toLowerCase().includes(filter))
 })
 </script>
 <template>
@@ -107,16 +135,7 @@ const filteredSites = computed(() => {
                       'site-hover': isHovering && !selectedSites.includes(site.id),
                     },
                   ]"
-                  @click="
-                    () => {
-                      const index = selectedSites.indexOf(site.id)
-                      if (index === -1) {
-                        selectedSites.push(site.id)
-                      } else {
-                        selectedSites.splice(index, 1)
-                      }
-                    }
-                  "
+                  @click="toggleSiteSelection(site.id)"
                 >
                   <VIcon
                     :icon="selectedSites.includes(site.id) ? 'mdi-check-circle' : 'mdi-checkbox-blank-circle-outline'"
@@ -161,7 +180,7 @@ const filteredSites = computed(() => {
         <VBtn
           color="primary"
           :disabled="selectedSites.length === 0"
-          @click="emit('search', selectedSites)"
+          @click="confirmSearch"
           prepend-icon="mdi-magnify"
           class="d-flex align-center justify-center px-5"
         >

src/composables/useLlmProviderDirectory.ts

@@ -83,6 +83,7 @@ interface UseLlmProviderDirectoryOptions {
   apiKey: Ref<string>
   baseUrl: Ref<string>
   baseUrlPreset?: Ref<string>
+  useProxy?: Ref<boolean>
   userAgent?: Ref<string>
   model: Ref<string>
   maxContextTokens?: Ref<number>
@@ -254,6 +255,7 @@ export function useLlmProviderDirectory(options: UseLlmProviderDirectoryOptions)
           api_key: normalizeValue(options.apiKey.value) || undefined,
           base_url: normalizeValue(options.baseUrl.value) || undefined,
           base_url_preset: normalizeValue(options.baseUrlPreset?.value) || undefined,
+          use_proxy: options.useProxy?.value,
           user_agent: normalizeValue(options.userAgent?.value) || undefined,
           force_refresh: forceRefresh,
         },

src/composables/useSetupWizard.ts

@@ -61,6 +61,7 @@ export interface WizardData {
     supportAudioOutput: boolean
     apiKey: string
     baseUrl: string
+    useProxy: boolean
     baseUrlPreset: string
     maxContextTokens: number
     userAgent: string
@@ -248,6 +249,7 @@ const wizardData = ref<WizardData>({
     supportAudioOutput: false,
     apiKey: '',
     baseUrl: 'https://api.deepseek.com',
+    useProxy: true,
     baseUrlPreset: '',
     maxContextTokens: 64,
     userAgent: '',
@@ -1446,6 +1448,7 @@ export function useSetupWizard() {
         LLM_SUPPORT_AUDIO_OUTPUT: wizardData.value.agent.supportAudioOutput,
         LLM_API_KEY: wizardData.value.agent.apiKey,
         LLM_BASE_URL: wizardData.value.agent.baseUrl || null,
+        LLM_USE_PROXY: wizardData.value.agent.useProxy,
         LLM_BASE_URL_PRESET: wizardData.value.agent.baseUrlPreset || null,
         LLM_MAX_CONTEXT_TOKENS: wizardData.value.agent.maxContextTokens,
         LLM_USER_AGENT: wizardData.value.agent.userAgent || null,
@@ -1560,6 +1563,7 @@ export function useSetupWizard() {
         wizardData.value.agent.supportAudioOutput = Boolean(result.data.LLM_SUPPORT_AUDIO_OUTPUT)
         wizardData.value.agent.apiKey = result.data.LLM_API_KEY || ''
         wizardData.value.agent.baseUrl = result.data.LLM_BASE_URL || ''
+        wizardData.value.agent.useProxy = result.data.LLM_USE_PROXY ?? true
         wizardData.value.agent.baseUrlPreset = result.data.LLM_BASE_URL_PRESET || ''
         wizardData.value.agent.maxContextTokens = result.data.LLM_MAX_CONTEXT_TOKENS || 64
         wizardData.value.agent.userAgent = result.data.LLM_USER_AGENT || ''

src/locales/en-US.ts

@@ -1456,6 +1456,9 @@ export default {
       llmApiKeyPlaceholder: 'Please enter API key',
       llmBaseUrl: 'LLM Base URL',
       llmBaseUrlHint: 'Base URL for LLM API, used for custom API endpoints',
+      llmUseProxy: 'Use System Proxy',
+      llmUseProxyHint:
+        'When enabled, Agent connections to the current LLM provider use the system proxy from advanced settings.',
       llmUserAgent: 'User-Agent',
       llmUserAgentHint: 'User-Agent sent to OpenAI-compatible APIs. Leave empty to use the SDK default.',
       llmProviderAuth: 'Provider Authorization',
@@ -2640,6 +2643,7 @@ export default {
       previewSeasonInfo: 'Season',
       previewSeasonLabel: 'Season',
       previewEpisodeCount: 'Episodes',
+      customWordsApplied: 'Recognition Word Details',
       previewAfterColumn: 'After',
       previewBeforeColumn: 'Before',
       previewFileNameColumn: 'Filename',

src/locales/zh-CN.ts

@@ -1448,6 +1448,8 @@ export default {
       llmApiKeyPlaceholder: '请输入API密钥',
       llmBaseUrl: 'LLM基础URL',
       llmBaseUrlHint: 'LLM API的基础URL地址，用于自定义API端点',
+      llmUseProxy: '使用系统代理',
+      llmUseProxyHint: '启用后，Agent 连接当前 LLM 提供商时会应用高级设置中的系统代理',
       llmUserAgent: 'User-Agent',
       llmUserAgentHint: 'OpenAI 兼容接口请求使用的 User-Agent，留空则使用 SDK 默认值',
       llmProviderAuth: '提供商授权',
@@ -2594,6 +2596,7 @@ export default {
       previewSeasonInfo: '季信息',
       previewSeasonLabel: '季',
       previewEpisodeCount: '总集数',
+      customWordsApplied: '识别词应用详情',
       previewAfterColumn: '整理后',
       previewBeforeColumn: '整理前',
       previewFileNameColumn: '文件名',

src/locales/zh-TW.ts

@@ -1449,6 +1449,8 @@ export default {
       llmApiKeyPlaceholder: '請輸入API密鑰',
       llmBaseUrl: 'LLM基礎URL',
       llmBaseUrlHint: 'LLM API的基礎URL地址，用於自定義API端點',
+      llmUseProxy: '使用系統代理',
+      llmUseProxyHint: '啟用後，Agent 連接目前 LLM 提供商時會套用進階設定中的系統代理',
       llmUserAgent: 'User-Agent',
       llmUserAgentHint: 'OpenAI 兼容接口請求使用的 User-Agent，留空則使用 SDK 預設值',
       llmProviderAuth: '提供商授權',
@@ -2595,6 +2597,7 @@ export default {
       previewSeasonInfo: '季資訊',
       previewSeasonLabel: '季',
       previewEpisodeCount: '總集數',
+      customWordsApplied: '識別詞應用詳情',
       previewAfterColumn: '整理後',
       previewBeforeColumn: '整理前',
       previewFileNameColumn: '文件名',

src/views/setting/AccountSettingSystem.vue

@@ -57,6 +57,7 @@ const SystemSettings = ref<any>({
     LLM_SUPPORT_AUDIO_OUTPUT: false,
     LLM_API_KEY: null,
     LLM_BASE_URL: 'https://api.deepseek.com',
+    LLM_USE_PROXY: true,
     LLM_BASE_URL_PRESET: null,
     LLM_MAX_CONTEXT_TOKENS: 64,
     LLM_USER_AGENT: null,
@@ -214,6 +215,7 @@ type LlmSettingsSnapshot = {
   LLM_THINKING_LEVEL: string
   LLM_API_KEY: string
   LLM_BASE_URL: string
+  LLM_USE_PROXY: boolean
   LLM_BASE_URL_PRESET: string
   LLM_USER_AGENT: string
 }
@@ -249,6 +251,13 @@ const llmBaseUrlPresetRef = computed({
   },
 })
 
+const llmUseProxyRef = computed({
+  get: () => Boolean(SystemSettings.value.Basic.LLM_USE_PROXY),
+  set: value => {
+    SystemSettings.value.Basic.LLM_USE_PROXY = Boolean(value)
+  },
+})
+
 const llmUserAgentRef = computed({
   get: () => String(SystemSettings.value.Basic.LLM_USER_AGENT ?? ''),
   set: value => {
@@ -301,6 +310,7 @@ const {
   apiKey: llmApiKeyRef,
   baseUrl: llmBaseUrlRef,
   baseUrlPreset: llmBaseUrlPresetRef,
+  useProxy: llmUseProxyRef,
   userAgent: llmUserAgentRef,
   model: llmModelRef,
   maxContextTokens: llmMaxContextRef,
@@ -362,6 +372,7 @@ function buildLlmSnapshot(): LlmSettingsSnapshot {
     LLM_THINKING_LEVEL: String(SystemSettings.value.Basic.LLM_THINKING_LEVEL ?? 'off'),
     LLM_API_KEY: String(SystemSettings.value.Basic.LLM_API_KEY ?? ''),
     LLM_BASE_URL: String(SystemSettings.value.Basic.LLM_BASE_URL ?? ''),
+    LLM_USE_PROXY: Boolean(SystemSettings.value.Basic.LLM_USE_PROXY),
     LLM_BASE_URL_PRESET: String(SystemSettings.value.Basic.LLM_BASE_URL_PRESET ?? ''),
     LLM_USER_AGENT: String(SystemSettings.value.Basic.LLM_USER_AGENT ?? ''),
   }
@@ -379,6 +390,7 @@ function buildLlmTestPayload(snapshot: LlmSettingsSnapshot) {
     thinking_level: snapshot.LLM_THINKING_LEVEL.trim(),
     api_key: snapshot.LLM_API_KEY.trim(),
     base_url: snapshot.LLM_BASE_URL.trim(),
+    use_proxy: snapshot.LLM_USE_PROXY,
     base_url_preset: snapshot.LLM_BASE_URL_PRESET.trim(),
     user_agent: snapshot.LLM_USER_AGENT.trim(),
   }
@@ -1206,6 +1218,14 @@ watch(currentLlmSnapshotKey, (snapshotKey, previousSnapshotKey) => {
                         </template>
                       </VCombobox>
                     </VCol>
+                    <VCol v-if="SystemSettings.Basic.AI_AGENT_ENABLE && showBaseUrlField" cols="12">
+                      <VSwitch
+                        v-model="SystemSettings.Basic.LLM_USE_PROXY"
+                        :label="t('setting.system.llmUseProxy')"
+                        :hint="t('setting.system.llmUseProxyHint')"
+                        persistent-hint
+                      />
+                    </VCol>
                     <VCol v-if="SystemSettings.Basic.AI_AGENT_ENABLE && showApiKeyField" cols="12" md="6">
                       <VTextField
                         v-model="SystemSettings.Basic.LLM_API_KEY"

src/views/setup/AgentSettingsStep.vue

@@ -40,6 +40,13 @@ const baseUrlPresetRef = computed({
   },
 })
 
+const useProxyRef = computed({
+  get: () => wizardData.value.agent.useProxy,
+  set: value => {
+    wizardData.value.agent.useProxy = Boolean(value)
+  },
+})
+
 const userAgentRef = computed({
   get: () => wizardData.value.agent.userAgent,
   set: value => {
@@ -99,6 +106,7 @@ const {
   apiKey: apiKeyRef,
   baseUrl: baseUrlRef,
   baseUrlPreset: baseUrlPresetRef,
+  useProxy: useProxyRef,
   userAgent: userAgentRef,
   model: modelRef,
   maxContextTokens: maxContextTokensRef,
@@ -341,6 +349,16 @@ onMounted(async () => {
             </VCombobox>
           </VCol>
 
+          <VCol v-if="showBaseUrlField" cols="12">
+            <VSwitch
+              v-model="wizardData.agent.useProxy"
+              :label="t('setting.system.llmUseProxy')"
+              :hint="t('setting.system.llmUseProxyHint')"
+              persistent-hint
+              color="primary"
+            />
+          </VCol>
+
           <VCol v-if="showApiKeyField" cols="12" md="6">
             <VTextField
               v-model="wizardData.agent.apiKey"