From 6890f7d09cc687f1712a301d65281e324c2ebe8f Mon Sep 17 00:00:00 2001
From: Stephen Zhou <38493346+hyoban@users.noreply.github.com>
Date: Mon, 12 Jan 2026 15:51:44 +0800
Subject: [PATCH] calls

---
 .../plugins/plugin-page/debug-info.tsx        |  7 +++----
 .../components/plugins/plugin-page/index.tsx  |  7 +++----
 web/app/components/plugins/utils.ts           | 13 -------------
 .../rag-pipeline-header/publisher/popup.tsx   |  4 +++-
 .../hooks/use-available-nodes-meta-data.ts    | 19 +++++++++----------
 web/app/components/tools/mcp/create-card.tsx  | 14 +++-----------
 .../components/retrieval-setting/index.tsx    |  4 +++-
 .../workflow/variable-inspect/empty.tsx       |  4 +++-
 web/hooks/use-api-access-url.ts               | 18 ++++++------------
 9 files changed, 33 insertions(+), 57 deletions(-)

diff --git a/web/app/components/plugins/plugin-page/debug-info.tsx b/web/app/components/plugins/plugin-page/debug-info.tsx
index f62f8a4134..dd7d21f3a1 100644
--- a/web/app/components/plugins/plugin-page/debug-info.tsx
+++ b/web/app/components/plugins/plugin-page/debug-info.tsx
@@ -8,8 +8,7 @@ import * as React from 'react'
 import { useTranslation } from 'react-i18next'
 import Button from '@/app/components/base/button'
 import Tooltip from '@/app/components/base/tooltip'
-import { getDocsUrl } from '@/app/components/plugins/utils'
-import { useLocale } from '@/context/i18n'
+import { useDocLink } from '@/context/i18n'
 import { useDebugKey } from '@/service/use-plugins'
 import KeyValueItem from '../base/key-value-item'
 
@@ -17,7 +16,7 @@ const i18nPrefix = 'debugInfo'
 
 const DebugInfo: FC = () => {
   const { t } = useTranslation()
-  const locale = useLocale()
+  const docLink = useDocLink()
   const { data: info, isLoading } = useDebugKey()
 
   // info.key likes 4580bdb7-b878-471c-a8a4-bfd760263a53 mask the middle part using *.
@@ -34,7 +33,7 @@ const DebugInfo: FC = () => {
         <>
           <div className="flex items-center gap-1 self-stretch">
             <span className="system-sm-semibold flex shrink-0 grow basis-0 flex-col items-start justify-center text-text-secondary">{t(`${i18nPrefix}.title`, { ns: 'plugin' })}</span>
-            <a href={getDocsUrl(locale, '/plugins/quick-start/debug-plugin')} target="_blank" className="flex cursor-pointer items-center gap-0.5 text-text-accent-light-mode-only">
+            <a href={docLink('/plugins/quick-start/debug-plugin')} target="_blank" className="flex cursor-pointer items-center gap-0.5 text-text-accent-light-mode-only">
               <span className="system-xs-medium">{t(`${i18nPrefix}.viewDocs`, { ns: 'plugin' })}</span>
               <RiArrowRightUpLine className="h-3 w-3" />
             </a>
diff --git a/web/app/components/plugins/plugin-page/index.tsx b/web/app/components/plugins/plugin-page/index.tsx
index 1f88f691ef..b39e7ebd15 100644
--- a/web/app/components/plugins/plugin-page/index.tsx
+++ b/web/app/components/plugins/plugin-page/index.tsx
@@ -15,10 +15,9 @@ import Button from '@/app/components/base/button'
 import TabSlider from '@/app/components/base/tab-slider'
 import Tooltip from '@/app/components/base/tooltip'
 import ReferenceSettingModal from '@/app/components/plugins/reference-setting-modal'
-import { getDocsUrl } from '@/app/components/plugins/utils'
 import { MARKETPLACE_API_PREFIX, SUPPORT_INSTALL_LOCAL_FILE_EXTENSIONS } from '@/config'
 import { useGlobalPublicStore } from '@/context/global-public-context'
-import { useLocale } from '@/context/i18n'
+import { useDocLink } from '@/context/i18n'
 import useDocumentTitle from '@/hooks/use-document-title'
 import { usePluginInstallation } from '@/hooks/use-query-params'
 import { fetchBundleInfoFromMarketPlace, fetchManifestFromMarketPlace } from '@/service/plugins'
@@ -47,7 +46,7 @@ const PluginPage = ({
   marketplace,
 }: PluginPageProps) => {
   const { t } = useTranslation()
-  const locale = useLocale()
+  const docLink = useDocLink()
   useDocumentTitle(t('metadata.title', { ns: 'plugin' }))
 
   // Use nuqs hook for installation state
@@ -175,7 +174,7 @@ const PluginPage = ({
                     </Button>
                   </Link>
                   <Link
-                    href={getDocsUrl(locale, '/plugins/publish-plugins/publish-to-dify-marketplace/README')}
+                    href={docLink('/plugins/publish-plugins/publish-to-dify-marketplace/README')}
                     target="_blank"
                   >
                     <Button
diff --git a/web/app/components/plugins/utils.ts b/web/app/components/plugins/utils.ts
index 5d663b2134..e68ad0d959 100644
--- a/web/app/components/plugins/utils.ts
+++ b/web/app/components/plugins/utils.ts
@@ -2,7 +2,6 @@ import type {
   TagKey,
 } from './constants'
 
-import { LanguagesSupported } from '@/i18n-config/language'
 import {
   categoryKeys,
   tagKeys,
@@ -15,15 +14,3 @@ export const getValidTagKeys = (tags: TagKey[]) => {
 export const getValidCategoryKeys = (category?: string) => {
   return categoryKeys.find(key => key === category)
 }
-
-export const getDocsUrl = (locale: string, path: string) => {
-  let localePath = 'en'
-
-  if (locale === LanguagesSupported[1])
-    localePath = 'zh-hans'
-
-  else if (locale === LanguagesSupported[7])
-    localePath = 'ja-jp'
-
-  return `https://docs.dify.ai/${localePath}${path}`
-}
diff --git a/web/app/components/rag-pipeline/components/rag-pipeline-header/publisher/popup.tsx b/web/app/components/rag-pipeline/components/rag-pipeline-header/publisher/popup.tsx
index b006c9acfb..0cdc9a0327 100644
--- a/web/app/components/rag-pipeline/components/rag-pipeline-header/publisher/popup.tsx
+++ b/web/app/components/rag-pipeline/components/rag-pipeline-header/publisher/popup.tsx
@@ -34,6 +34,7 @@ import {
 } from '@/app/components/workflow/store'
 import { getKeyboardKeyCodeBySystem, getKeyboardKeyNameBySystem } from '@/app/components/workflow/utils'
 import { useDatasetDetailContextWithSelector } from '@/context/dataset-detail'
+import { useDocLink } from '@/context/i18n'
 import { useModalContextSelector } from '@/context/modal-context'
 import { useProviderContext } from '@/context/provider-context'
 import { useDatasetApiAccessUrl } from '@/hooks/use-api-access-url'
@@ -55,6 +56,7 @@ const Popup = () => {
   const { t } = useTranslation()
   const { datasetId } = useParams()
   const { push } = useRouter()
+  const docLink = useDocLink()
   const publishedAt = useStore(s => s.publishedAt)
   const draftUpdatedAt = useStore(s => s.draftUpdatedAt)
   const pipelineId = useStore(s => s.pipelineId)
@@ -186,7 +188,7 @@ const Popup = () => {
               {t('publishTemplate.success.tip', { ns: 'datasetPipeline' })}
             </span>
             <Link
-              href="https://docs.dify.ai"
+              href={docLink()}
               target="_blank"
               className="system-xs-medium-uppercase inline-block text-text-accent"
             >
diff --git a/web/app/components/rag-pipeline/hooks/use-available-nodes-meta-data.ts b/web/app/components/rag-pipeline/hooks/use-available-nodes-meta-data.ts
index 0b574145b4..dd7cd7bc30 100644
--- a/web/app/components/rag-pipeline/hooks/use-available-nodes-meta-data.ts
+++ b/web/app/components/rag-pipeline/hooks/use-available-nodes-meta-data.ts
@@ -6,11 +6,11 @@ import dataSourceEmptyDefault from '@/app/components/workflow/nodes/data-source-
 import dataSourceDefault from '@/app/components/workflow/nodes/data-source/default'
 import knowledgeBaseDefault from '@/app/components/workflow/nodes/knowledge-base/default'
 import { BlockEnum } from '@/app/components/workflow/types'
-import { useGetLanguage } from '@/context/i18n'
+import { useDocLink } from '@/context/i18n'
 
 export const useAvailableNodesMetaData = () => {
   const { t } = useTranslation()
-  const language = useGetLanguage()
+  const docLink = useDocLink()
 
   const mergedNodesMetaData = useMemo(() => [
     ...WORKFLOW_COMMON_NODES,
@@ -25,14 +25,13 @@ export const useAvailableNodesMetaData = () => {
     dataSourceEmptyDefault,
   ], [])
 
-  const helpLinkUri = useMemo(() => {
-    if (language === 'zh_Hans')
-      return 'https://docs.dify.ai/zh-hans/guides/knowledge-base/knowledge-pipeline/knowledge-pipeline-orchestration#%E6%AD%A5%E9%AA%A4%E4%B8%80%EF%BC%9A%E6%95%B0%E6%8D%AE%E6%BA%90%E9%85%8D%E7%BD%AE'
-    if (language === 'ja_JP')
-      return 'https://docs.dify.ai/ja-jp/guides/knowledge-base/knowledge-pipeline/knowledge-pipeline-orchestration#%E3%82%B9%E3%83%86%E3%83%83%E3%83%971%EF%BC%9A%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BD%E3%83%BC%E3%82%B9%E3%81%AE%E8%A8%AD%E5%AE%9A'
-
-    return 'https://docs.dify.ai/en/guides/knowledge-base/knowledge-pipeline/knowledge-pipeline-orchestration#step-1%3A-data-source'
-  }, [language])
+  const helpLinkUri = useMemo(() => docLink(
+    '/guides/knowledge-base/knowledge-pipeline/knowledge-pipeline-orchestration#step-1%3A-data-source',
+    {
+      'zh-Hans': '/guides/knowledge-base/knowledge-pipeline/knowledge-pipeline-orchestration#%E6%AD%A5%E9%AA%A4%E4%B8%80%EF%BC%9A%E6%95%B0%E6%8D%AE%E6%BA%90%E9%85%8D%E7%BD%AE',
+      'ja-JP': '/guides/knowledge-base/knowledge-pipeline/knowledge-pipeline-orchestration#%E3%82%B9%E3%83%86%E3%83%83%E3%83%971%EF%BC%9A%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BD%E3%83%BC%E3%82%B9%E3%81%AE%E8%A8%AD%E5%AE%9A',
+    },
+  ), [docLink])
 
   const availableNodesMetaData = useMemo(() => mergedNodesMetaData.map((node) => {
     const { metaData } = node
diff --git a/web/app/components/tools/mcp/create-card.tsx b/web/app/components/tools/mcp/create-card.tsx
index 7a0496d7c3..03eee39d69 100644
--- a/web/app/components/tools/mcp/create-card.tsx
+++ b/web/app/components/tools/mcp/create-card.tsx
@@ -8,8 +8,7 @@ import {
 import { useMemo, useState } from 'react'
 import { useTranslation } from 'react-i18next'
 import { useAppContext } from '@/context/app-context'
-import { useLocale } from '@/context/i18n'
-import { getLanguage } from '@/i18n-config/language'
+import { useDocLink } from '@/context/i18n'
 import { useCreateMCP } from '@/service/use-tools'
 import MCPModal from './modal'
 
@@ -19,8 +18,7 @@ type Props = {
 
 const NewMCPCard = ({ handleCreate }: Props) => {
   const { t } = useTranslation()
-  const locale = useLocale()
-  const language = getLanguage(locale)
+  const docLink = useDocLink()
   const { isCurrentWorkspaceManager } = useAppContext()
 
   const { mutateAsync: createMCP } = useCreateMCP()
@@ -30,13 +28,7 @@ const NewMCPCard = ({ handleCreate }: Props) => {
     handleCreate(provider)
   }
 
-  const linkUrl = useMemo(() => {
-    if (language.startsWith('zh_'))
-      return 'https://docs.dify.ai/zh-hans/guides/tools/mcp'
-    if (language.startsWith('ja_jp'))
-      return 'https://docs.dify.ai/ja_jp/guides/tools/mcp'
-    return 'https://docs.dify.ai/en/guides/tools/mcp'
-  }, [language])
+  const linkUrl = useMemo(() => docLink('/guides/tools/mcp'), [docLink])
 
   const [showModal, setShowModal] = useState(false)
 
diff --git a/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/index.tsx b/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/index.tsx
index c053a45bd3..6d1ff708dd 100644
--- a/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/index.tsx
+++ b/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/index.tsx
@@ -11,6 +11,7 @@ import {
 } from 'react'
 import { useTranslation } from 'react-i18next'
 import { Field } from '@/app/components/workflow/nodes/_base/components/layout'
+import { useDocLink } from '@/context/i18n'
 import { useRetrievalSetting } from './hooks'
 import SearchMethodOption from './search-method-option'
 
@@ -50,6 +51,7 @@ const RetrievalSetting = ({
   showMultiModalTip,
 }: RetrievalSettingProps) => {
   const { t } = useTranslation()
+  const docLink = useDocLink()
   const {
     options,
     hybridSearchModeOptions,
@@ -61,7 +63,7 @@ const RetrievalSetting = ({
         title: t('form.retrievalSetting.title', { ns: 'datasetSettings' }),
         subTitle: (
           <div className="body-xs-regular flex items-center text-text-tertiary">
-            <a target="_blank" rel="noopener noreferrer" href="https://docs.dify.ai/guides/knowledge-base/create-knowledge-and-upload-documents#id-4-retrieval-settings" className="text-text-accent">{t('form.retrievalSetting.learnMore', { ns: 'datasetSettings' })}</a>
+            <a target="_blank" rel="noopener noreferrer" href={docLink('guides/knowledge-base/create-knowledge-and-upload-documents#id-4-retrieval-settings')} className="text-text-accent">{t('form.retrievalSetting.learnMore', { ns: 'datasetSettings' })}</a>
             &nbsp;
             {t('nodes.knowledgeBase.aboutRetrieval', { ns: 'workflow' })}
           </div>
diff --git a/web/app/components/workflow/variable-inspect/empty.tsx b/web/app/components/workflow/variable-inspect/empty.tsx
index 86af8556d9..07ece14d7e 100644
--- a/web/app/components/workflow/variable-inspect/empty.tsx
+++ b/web/app/components/workflow/variable-inspect/empty.tsx
@@ -1,9 +1,11 @@
 import type { FC } from 'react'
 import { useTranslation } from 'react-i18next'
 import { Variable02 } from '@/app/components/base/icons/src/vender/solid/development'
+import { useDocLink } from '@/context/i18n'
 
 const Empty: FC = () => {
   const { t } = useTranslation()
+  const docLink = useDocLink()
 
   return (
     <div className="flex h-full flex-col gap-3 rounded-xl bg-background-section p-8">
@@ -15,7 +17,7 @@ const Empty: FC = () => {
         <div className="system-xs-regular text-text-tertiary">{t('debug.variableInspect.emptyTip', { ns: 'workflow' })}</div>
         <a
           className="system-xs-regular cursor-pointer text-text-accent"
-          href="https://docs.dify.ai/en/guides/workflow/debug-and-preview/variable-inspect"
+          href={docLink('/guides/workflow/debug-and-preview/variable-inspect')}
           target="_blank"
           rel="noopener noreferrer"
         >
diff --git a/web/hooks/use-api-access-url.ts b/web/hooks/use-api-access-url.ts
index 93639ae036..bf653185ce 100644
--- a/web/hooks/use-api-access-url.ts
+++ b/web/hooks/use-api-access-url.ts
@@ -1,16 +1,10 @@
-import { useMemo } from 'react'
-import { useGetLanguage } from '@/context/i18n'
+import { useDocLink } from '@/context/i18n'
 
 export const useDatasetApiAccessUrl = () => {
-  const locale = useGetLanguage()
+  const docLink = useDocLink()
 
-  const apiReferenceUrl = useMemo(() => {
-    if (locale === 'zh_Hans')
-      return 'https://docs.dify.ai/api-reference/%E6%95%B0%E6%8D%AE%E9%9B%86'
-    if (locale === 'ja_JP')
-      return 'https://docs.dify.ai/api-reference/%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BB%E3%83%83%E3%83%88'
-    return 'https://docs.dify.ai/api-reference/datasets'
-  }, [locale])
-
-  return apiReferenceUrl
+  return docLink('/api-reference/datasets', {
+    'zh-Hans': '/api-reference/%E6%95%B0%E6%8D%AE%E9%9B%86',
+    'ja-JP': '/api-reference/%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BB%E3%83%83%E3%83%88',
+  })
 }