From 14646a69fca96ec3afe0d535b61b57cce4a7e19e Mon Sep 17 00:00:00 2001
From: paisley <8197966+su8su@users.noreply.github.com>
Date: Wed, 11 Mar 2026 16:01:04 +0800
Subject: [PATCH] feat: add documentation links for custom AI model providers
 (#412)

---
 src/components/settings/ProvidersSettings.tsx | 35 +++++++++++++++++--
 src/i18n/locales/en/settings.json             |  1 +
 src/i18n/locales/ja/settings.json             |  3 +-
 src/i18n/locales/zh/settings.json             |  1 +
 4 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/src/components/settings/ProvidersSettings.tsx b/src/components/settings/ProvidersSettings.tsx
index 9f66a415d..1719d590e 100644
--- a/src/components/settings/ProvidersSettings.tsx
+++ b/src/components/settings/ProvidersSettings.tsx
@@ -291,7 +291,7 @@ function ProviderCard({
   onValidateKey,
   devModeUnlocked,
 }: ProviderCardProps) {
-  const { t } = useTranslation('settings');
+  const { t, i18n } = useTranslation('settings');
   const { account, vendor, status } = item;
   const [newKey, setNewKey] = useState('');
   const [baseUrl, setBaseUrl] = useState(account.baseUrl || '');
@@ -513,6 +513,21 @@ function ProviderCard({
 
       {isEditing && (
         <div className="space-y-6 mt-4 pt-4 border-t border-black/5 dark:border-white/5">
+          {account.vendorId === 'custom' && (
+            <div className="flex justify-end -mt-2 mb-2">
+              <a
+                href={i18n.language.startsWith('zh')
+                  ? 'https://icnnp7d0dymg.feishu.cn/wiki/BmiLwGBcEiloZDkdYnGc8RWnn6d#IWQCdfe5fobGU3xf3UGcgbLynGh'
+                  : 'https://icnnp7d0dymg.feishu.cn/wiki/BmiLwGBcEiloZDkdYnGc8RWnn6d#Ee1ldfvKJoVGvfxc32mcILwenth'}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-[12px] text-blue-500 hover:text-blue-600 font-medium inline-flex items-center gap-1"
+              >
+                {t('aiProviders.dialog.customDoc')}
+                <ExternalLink className="h-3 w-3" />
+              </a>
+            </div>
+          )}
           {canEditModelConfig && (
             <div className="space-y-3">
               <p className={currentSectionLabelClasses}>{t('aiProviders.sections.model')}</p>
@@ -738,7 +753,7 @@ function AddProviderDialog({
   onValidateKey,
   devModeUnlocked,
 }: AddProviderDialogProps) {
-  const { t } = useTranslation('settings');
+  const { t, i18n } = useTranslation('settings');
   const [selectedType, setSelectedType] = useState<ProviderType | null>(null);
   const [name, setName] = useState('');
   const [apiKey, setApiKey] = useState('');
@@ -1061,6 +1076,22 @@ function AddProviderDialog({
                   >
                     {t('aiProviders.dialog.change')}
                   </button>
+                  {selectedType === 'custom' && (
+                    <>
+                      <span className="mx-2 text-foreground/20">|</span>
+                      <a
+                        href={i18n.language.startsWith('zh')
+                          ? 'https://icnnp7d0dymg.feishu.cn/wiki/BmiLwGBcEiloZDkdYnGc8RWnn6d#IWQCdfe5fobGU3xf3UGcgbLynGh'
+                          : 'https://icnnp7d0dymg.feishu.cn/wiki/BmiLwGBcEiloZDkdYnGc8RWnn6d#Ee1ldfvKJoVGvfxc32mcILwenth'}
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="text-[13px] text-blue-500 hover:text-blue-600 font-medium inline-flex items-center gap-1"
+                      >
+                        {t('aiProviders.dialog.customDoc')}
+                        <ExternalLink className="h-3 w-3" />
+                      </a>
+                    </>
+                  )}
                 </div>
               </div>
 
diff --git a/src/i18n/locales/en/settings.json b/src/i18n/locales/en/settings.json
index 8227013bb..7e2ca27e2 100644
--- a/src/i18n/locales/en/settings.json
+++ b/src/i18n/locales/en/settings.json
@@ -61,6 +61,7 @@
       "change": "Change provider",
       "add": "Add Provider",
       "save": "Save",
+      "customDoc": "Documentation",
       "validate": "Validate"
     },
     "card": {
diff --git a/src/i18n/locales/ja/settings.json b/src/i18n/locales/ja/settings.json
index 9d8884daa..4ea25c863 100644
--- a/src/i18n/locales/ja/settings.json
+++ b/src/i18n/locales/ja/settings.json
@@ -60,6 +60,7 @@
       "change": "プロバイダーを変更",
       "add": "プロバイダーを追加",
       "save": "保存",
+      "customDoc": "ドキュメント",
       "validate": "検証"
     },
     "card": {
@@ -234,4 +235,4 @@
     "docs": "公式サイト",
     "github": "GitHub"
   }
-}
+}
\ No newline at end of file
diff --git a/src/i18n/locales/zh/settings.json b/src/i18n/locales/zh/settings.json
index 015404a0e..a66586df3 100644
--- a/src/i18n/locales/zh/settings.json
+++ b/src/i18n/locales/zh/settings.json
@@ -61,6 +61,7 @@
       "change": "更换提供商",
       "add": "添加提供商",
       "save": "保存",
+      "customDoc": "查看文档",
       "validate": "验证"
     },
     "card": {