From bba7ecae6ea4fbae1bf2e4d27be81b25dba4a487 Mon Sep 17 00:00:00 2001
From: Phantom <eurfelux@gmail.com>
Date: Mon, 8 Dec 2025 10:58:56 +0800
Subject: [PATCH] feat(agent): add tooltip for model selection and improve i18n
 (#11738)

* refactor(settings): rename actions prop to contentAfter for clarity

The prop name 'actions' was misleading as it could imply functionality rather than layout. 'contentAfter' better describes its purpose of displaying content after the title.

* feat(agent): add tooltip for model selection in agent settings

Add tooltip to explain that only Anthropic endpoint models are supported for agents

* feat(i18n): add model tooltip and translate upload strings

Add tooltip message about Anthropic endpoint model requirement for Agent feature
Translate previously untranslated upload-related strings in multiple languages
---
 .../src/components/Popups/agent/AgentModal.tsx         | 10 +++++++---
 src/renderer/src/i18n/locales/en-us.json               |  3 +++
 src/renderer/src/i18n/locales/zh-cn.json               |  3 +++
 src/renderer/src/i18n/locales/zh-tw.json               |  7 +++++--
 src/renderer/src/i18n/translate/de-de.json             |  9 ++++++---
 src/renderer/src/i18n/translate/el-gr.json             |  9 ++++++---
 src/renderer/src/i18n/translate/es-es.json             |  9 ++++++---
 src/renderer/src/i18n/translate/fr-fr.json             |  9 ++++++---
 src/renderer/src/i18n/translate/ja-jp.json             |  9 ++++++---
 src/renderer/src/i18n/translate/pt-pt.json             |  9 ++++++---
 src/renderer/src/i18n/translate/ru-ru.json             |  9 ++++++---
 .../settings/AgentSettings/AccessibleDirsSetting.tsx   |  2 +-
 .../pages/settings/AgentSettings/AdvancedSettings.tsx  |  2 +-
 .../src/pages/settings/AgentSettings/ModelSetting.tsx  |  5 ++++-
 .../src/pages/settings/AgentSettings/shared.tsx        |  8 ++++----
 15 files changed, 70 insertions(+), 33 deletions(-)

diff --git a/src/renderer/src/components/Popups/agent/AgentModal.tsx b/src/renderer/src/components/Popups/agent/AgentModal.tsx
index e72433e88a..0d3ce94731 100644
--- a/src/renderer/src/components/Popups/agent/AgentModal.tsx
+++ b/src/renderer/src/components/Popups/agent/AgentModal.tsx
@@ -1,5 +1,6 @@
 import { loggerService } from '@logger'
 import { ErrorBoundary } from '@renderer/components/ErrorBoundary'
+import { HelpTooltip } from '@renderer/components/TooltipIcons'
 import { TopView } from '@renderer/components/TopView'
 import { permissionModeCards } from '@renderer/config/agent'
 import { useAgents } from '@renderer/hooks/agents/useAgents'
@@ -340,9 +341,12 @@ const PopupContainer: React.FC<Props> = ({ agent, afterSubmit, resolve }) => {
             </FormRow>
 
             <FormItem>
-              <Label>
-                {t('common.model')} <RequiredMark>*</RequiredMark>
-              </Label>
+              <div className="flex items-center gap-2">
+                <Label>
+                  {t('common.model')} <RequiredMark>*</RequiredMark>
+                </Label>
+                <HelpTooltip title={t('agent.add.model.tooltip')} />
+              </div>
               <SelectAgentBaseModelButton
                 agentBase={tempAgentBase}
                 onSelect={handleModelSelect}
diff --git a/src/renderer/src/i18n/locales/en-us.json b/src/renderer/src/i18n/locales/en-us.json
index e8fdad0afb..dd1d5cb728 100644
--- a/src/renderer/src/i18n/locales/en-us.json
+++ b/src/renderer/src/i18n/locales/en-us.json
@@ -6,6 +6,9 @@
         "failed": "Failed to add a agent",
         "invalid_agent": "Invalid Agent"
       },
+      "model": {
+        "tooltip": "Currently, only models that support Anthropic endpoints are available for the Agent feature."
+      },
       "title": "Add Agent",
       "type": {
         "placeholder": "Select an agent type"
diff --git a/src/renderer/src/i18n/locales/zh-cn.json b/src/renderer/src/i18n/locales/zh-cn.json
index 0ce7627392..05f39d0919 100644
--- a/src/renderer/src/i18n/locales/zh-cn.json
+++ b/src/renderer/src/i18n/locales/zh-cn.json
@@ -6,6 +6,9 @@
         "failed": "添加 Agent 失败",
         "invalid_agent": "无效的 Agent"
       },
+      "model": {
+        "tooltip": "目前，只有支持 Anthropic 端点的模型可用于 Agent 功能。"
+      },
       "title": "添加 Agent",
       "type": {
         "placeholder": "选择 Agent 类型"
diff --git a/src/renderer/src/i18n/locales/zh-tw.json b/src/renderer/src/i18n/locales/zh-tw.json
index 20a3d84df2..0d4481e6be 100644
--- a/src/renderer/src/i18n/locales/zh-tw.json
+++ b/src/renderer/src/i18n/locales/zh-tw.json
@@ -6,6 +6,9 @@
         "failed": "無法新增代理人",
         "invalid_agent": "無效的 Agent"
       },
+      "model": {
+        "tooltip": "目前，僅支援 Anthropic 端點的模型可供代理功能使用。"
+      },
       "title": "新增代理",
       "type": {
         "placeholder": "選擇 Agent 類型"
@@ -2220,8 +2223,8 @@
     "untitled_folder": "新資料夾",
     "untitled_note": "無標題筆記",
     "upload_failed": "筆記上傳失敗",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "上傳檔案",
+    "upload_folder": "上傳資料夾",
     "upload_success": "筆記上傳成功",
     "uploading_files": "正在上傳 {{count}} 個檔案..."
   },
diff --git a/src/renderer/src/i18n/translate/de-de.json b/src/renderer/src/i18n/translate/de-de.json
index aaed5b498e..49f3535b77 100644
--- a/src/renderer/src/i18n/translate/de-de.json
+++ b/src/renderer/src/i18n/translate/de-de.json
@@ -6,6 +6,9 @@
         "failed": "Agent hinzufügen fehlgeschlagen",
         "invalid_agent": "Ungültiger Agent"
       },
+      "model": {
+        "tooltip": "Derzeit sind für die Agent-Funktion nur Modelle verfügbar, die Anthropic-Endpunkte unterstützen."
+      },
       "title": "Agent hinzufügen",
       "type": {
         "placeholder": "Agent-Typ auswählen"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "Neuer Ordner",
     "untitled_note": "Unbenannte Notiz",
     "upload_failed": "Notizen-Upload fehlgeschlagen",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "Dateien hochladen",
+    "upload_folder": "Ordner hochladen",
     "upload_success": "Notizen erfolgreich hochgeladen",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "Lade {{count}} Dateien hoch..."
   },
   "notification": {
     "assistant": "Assistenten-Antwort",
diff --git a/src/renderer/src/i18n/translate/el-gr.json b/src/renderer/src/i18n/translate/el-gr.json
index f8125631a9..160fa31f95 100644
--- a/src/renderer/src/i18n/translate/el-gr.json
+++ b/src/renderer/src/i18n/translate/el-gr.json
@@ -6,6 +6,9 @@
         "failed": "Αποτυχία προσθήκης πράκτορα",
         "invalid_agent": "Μη έγκυρος Agent"
       },
+      "model": {
+        "tooltip": "Προς το παρόν, μόνο μοντέλα που υποστηρίζουν τελικά σημεία Anthropic είναι διαθέσιμα για τη λειτουργία Agent."
+      },
       "title": "Προσθήκη Agent",
       "type": {
         "placeholder": "Επιλέξτε τύπο Agent"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "Νέος φάκελος",
     "untitled_note": "σημείωση χωρίς τίτλο",
     "upload_failed": "Η σημείωση δεν ανέβηκε",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "Ανέβασμα Αρχείων",
+    "upload_folder": "Ανέβασμα Φακέλου",
     "upload_success": "Οι σημειώσεις μεταφορτώθηκαν με επιτυχία",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "Ανεβάζονται {{count}} αρχεία..."
   },
   "notification": {
     "assistant": "Απάντηση Βοηθού",
diff --git a/src/renderer/src/i18n/translate/es-es.json b/src/renderer/src/i18n/translate/es-es.json
index 2a5874f6b6..43ea778b6d 100644
--- a/src/renderer/src/i18n/translate/es-es.json
+++ b/src/renderer/src/i18n/translate/es-es.json
@@ -6,6 +6,9 @@
         "failed": "Error al añadir agente",
         "invalid_agent": "Agent inválido"
       },
+      "model": {
+        "tooltip": "Actualmente, solo los modelos que admiten puntos finales de Anthropic están disponibles para la función Agente."
+      },
       "title": "Agregar Agente",
       "type": {
         "placeholder": "Seleccionar tipo de Agente"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "Nueva carpeta",
     "untitled_note": "Nota sin título",
     "upload_failed": "Error al cargar la nota",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "Subir archivos",
+    "upload_folder": "Carpeta de subida",
     "upload_success": "Nota cargada con éxito",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "Subiendo {{count}} archivos..."
   },
   "notification": {
     "assistant": "Respuesta del asistente",
diff --git a/src/renderer/src/i18n/translate/fr-fr.json b/src/renderer/src/i18n/translate/fr-fr.json
index bc884c8c69..bd5f471e2a 100644
--- a/src/renderer/src/i18n/translate/fr-fr.json
+++ b/src/renderer/src/i18n/translate/fr-fr.json
@@ -6,6 +6,9 @@
         "failed": "Échec de l'ajout de l'agent",
         "invalid_agent": "Agent invalide"
       },
+      "model": {
+        "tooltip": "Actuellement, seuls les modèles qui prennent en charge les points de terminaison Anthropic sont disponibles pour la fonctionnalité Agent."
+      },
       "title": "Ajouter un agent",
       "type": {
         "placeholder": "Sélectionner le type d'Agent"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "nouveau dossier",
     "untitled_note": "Note sans titre",
     "upload_failed": "Échec du téléchargement de la note",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "Télécharger des fichiers",
+    "upload_folder": "Puis dossier de téléchargement",
     "upload_success": "Note téléchargée avec succès",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "Téléchargement de {{count}} fichiers..."
   },
   "notification": {
     "assistant": "Réponse de l'assistant",
diff --git a/src/renderer/src/i18n/translate/ja-jp.json b/src/renderer/src/i18n/translate/ja-jp.json
index f1c0fe575d..48dee61b8b 100644
--- a/src/renderer/src/i18n/translate/ja-jp.json
+++ b/src/renderer/src/i18n/translate/ja-jp.json
@@ -6,6 +6,9 @@
         "failed": "エージェントの追加に失敗しました",
         "invalid_agent": "無効なエージェント"
       },
+      "model": {
+        "tooltip": "現在、エージェント機能では、Anthropicエンドポイントをサポートするモデルのみが利用可能です。"
+      },
       "title": "エージェントを追加",
       "type": {
         "placeholder": "エージェントタイプを選択"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "新ファイル夹",
     "untitled_note": "無題のメモ",
     "upload_failed": "ノートのアップロードに失敗しました",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "ファイルをアップロード",
+    "upload_folder": "アップロードフォルダ",
     "upload_success": "ノートのアップロードが成功しました",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "{{count}} 個のファイルをアップロード中..."
   },
   "notification": {
     "assistant": "助手回應",
diff --git a/src/renderer/src/i18n/translate/pt-pt.json b/src/renderer/src/i18n/translate/pt-pt.json
index 33976b2e1f..ffb665b7a5 100644
--- a/src/renderer/src/i18n/translate/pt-pt.json
+++ b/src/renderer/src/i18n/translate/pt-pt.json
@@ -6,6 +6,9 @@
         "failed": "Falha ao adicionar agente",
         "invalid_agent": "Agent inválido"
       },
+      "model": {
+        "tooltip": "Atualmente, apenas modelos que suportam endpoints da Anthropic estão disponíveis para o recurso Agente."
+      },
       "title": "Adicionar Agente",
       "type": {
         "placeholder": "Selecionar tipo de Agente"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "Nova pasta",
     "untitled_note": "Nota sem título",
     "upload_failed": "Falha ao carregar a nota",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "Carregar Ficheiros",
+    "upload_folder": "Carregar Pasta",
     "upload_success": "Nota carregada com sucesso",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "A enviar {{count}} ficheiros..."
   },
   "notification": {
     "assistant": "Resposta do assistente",
diff --git a/src/renderer/src/i18n/translate/ru-ru.json b/src/renderer/src/i18n/translate/ru-ru.json
index fbdffdb379..318162134c 100644
--- a/src/renderer/src/i18n/translate/ru-ru.json
+++ b/src/renderer/src/i18n/translate/ru-ru.json
@@ -6,6 +6,9 @@
         "failed": "Не удалось добавить агента",
         "invalid_agent": "Недействительный агент"
       },
+      "model": {
+        "tooltip": "В настоящее время для функции агента доступны только модели, поддерживающие конечные точки Anthropic."
+      },
       "title": "Добавить агента",
       "type": {
         "placeholder": "Выбор типа агента"
@@ -2220,10 +2223,10 @@
     "untitled_folder": "Новая папка",
     "untitled_note": "Незаглавленная заметка",
     "upload_failed": "Не удалось загрузить заметку",
-    "upload_files": "[to be translated]:Upload Files",
-    "upload_folder": "[to be translated]:Upload Folder",
+    "upload_files": "Загрузить файлы",
+    "upload_folder": "Загрузить папку",
     "upload_success": "Заметка успешно загружена",
-    "uploading_files": "[to be translated]:Uploading {{count}} files..."
+    "uploading_files": "Загрузка {{count}} файлов..."
   },
   "notification": {
     "assistant": "Ответ ассистента",
diff --git a/src/renderer/src/pages/settings/AgentSettings/AccessibleDirsSetting.tsx b/src/renderer/src/pages/settings/AgentSettings/AccessibleDirsSetting.tsx
index eeac1f4993..6a6c8e914c 100644
--- a/src/renderer/src/pages/settings/AgentSettings/AccessibleDirsSetting.tsx
+++ b/src/renderer/src/pages/settings/AgentSettings/AccessibleDirsSetting.tsx
@@ -64,7 +64,7 @@ export const AccessibleDirsSetting = ({ base, update }: AccessibleDirsSettingPro
   return (
     <SettingsItem>
       <SettingsTitle
-        actions={
+        contentAfter={
           <Tooltip title={t('agent.session.accessible_paths.add')}>
             <Button type="text" icon={<Plus size={16} />} shape="circle" onClick={addAccessiblePath} />
           </Tooltip>
diff --git a/src/renderer/src/pages/settings/AgentSettings/AdvancedSettings.tsx b/src/renderer/src/pages/settings/AgentSettings/AdvancedSettings.tsx
index 0e4b401f08..0cadff5912 100644
--- a/src/renderer/src/pages/settings/AgentSettings/AdvancedSettings.tsx
+++ b/src/renderer/src/pages/settings/AgentSettings/AdvancedSettings.tsx
@@ -69,7 +69,7 @@ export const AdvancedSettings: React.FC<AdvancedSettingsProps> = ({ agentBase, u
     <SettingsContainer>
       <SettingsItem divider={false}>
         <SettingsTitle
-          actions={
+          contentAfter={
             <Tooltip title={t('agent.settings.advance.maxTurns.description')} placement="left">
               <Info size={16} className="text-foreground-400" />
             </Tooltip>
diff --git a/src/renderer/src/pages/settings/AgentSettings/ModelSetting.tsx b/src/renderer/src/pages/settings/AgentSettings/ModelSetting.tsx
index 8bf32e76fb..ebe5b47003 100644
--- a/src/renderer/src/pages/settings/AgentSettings/ModelSetting.tsx
+++ b/src/renderer/src/pages/settings/AgentSettings/ModelSetting.tsx
@@ -1,3 +1,4 @@
+import { HelpTooltip } from '@renderer/components/TooltipIcons'
 import SelectAgentBaseModelButton from '@renderer/pages/home/components/SelectAgentBaseModelButton'
 import type { AgentBaseWithId, ApiModel, UpdateAgentFunctionUnion } from '@renderer/types'
 import { useTranslation } from 'react-i18next'
@@ -22,7 +23,9 @@ export const ModelSetting = ({ base, update, isDisabled }: ModelSettingProps) =>
 
   return (
     <SettingsItem inline>
-      <SettingsTitle id="model">{t('common.model')}</SettingsTitle>
+      <SettingsTitle id="model" contentAfter={<HelpTooltip title={t('agent.add.model.tooltip')} />}>
+        {t('common.model')}
+      </SettingsTitle>
       <SelectAgentBaseModelButton
         agentBase={base}
         onSelect={async (model) => {
diff --git a/src/renderer/src/pages/settings/AgentSettings/shared.tsx b/src/renderer/src/pages/settings/AgentSettings/shared.tsx
index 4a74c61a8b..cfac028bbb 100644
--- a/src/renderer/src/pages/settings/AgentSettings/shared.tsx
+++ b/src/renderer/src/pages/settings/AgentSettings/shared.tsx
@@ -10,14 +10,14 @@ import styled from 'styled-components'
 import { SettingDivider } from '..'
 
 export interface SettingsTitleProps extends React.ComponentPropsWithRef<'div'> {
-  actions?: ReactNode
+  contentAfter?: ReactNode
 }
 
-export const SettingsTitle: React.FC<SettingsTitleProps> = ({ children, actions }) => {
+export const SettingsTitle: React.FC<SettingsTitleProps> = ({ children, contentAfter }) => {
   return (
-    <div className={cn(actions ? 'justify-between' : undefined, 'mb-1 flex items-center gap-2')}>
+    <div className={cn(contentAfter ? 'justify-between' : undefined, 'mb-1 flex items-center gap-2')}>
       <span className="flex items-center gap-1 font-bold">{children}</span>
-      {actions !== undefined && actions}
+      {contentAfter !== undefined && contentAfter}
     </div>
   )
 }