From e3f3d4f9801e020b6bd977d91b4ba021231f97d6 Mon Sep 17 00:00:00 2001
From: twwu <twwu@dify.ai>
Date: Tue, 16 Sep 2025 19:53:19 +0800
Subject: [PATCH 1/2] fix: Rename hybridSearchMode to reranking_mode in
 KnowledgeBase components for consistency

---
 .../retrieval-setting/search-method-option.tsx       | 12 +++++-------
 .../nodes/knowledge-base/hooks/use-config.ts         |  2 +-
 .../workflow/nodes/knowledge-base/panel.tsx          |  2 +-
 .../workflow/nodes/knowledge-base/types.ts           |  2 +-
 4 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/search-method-option.tsx b/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/search-method-option.tsx
index 40d44f3135..74629f47ae 100644
--- a/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/search-method-option.tsx
+++ b/web/app/components/workflow/nodes/knowledge-base/components/retrieval-setting/search-method-option.tsx
@@ -178,13 +178,11 @@ const SearchMethodOption = ({
                   </div>
                 )
               }
-              {rerankingModelEnabled && (
-                <RerankingModelSelector
-                  rerankingModel={rerankingModel}
-                  onRerankingModelChange={onRerankingModelChange}
-                  readonly={readonly}
-                />
-              )}
+              <RerankingModelSelector
+                rerankingModel={rerankingModel}
+                onRerankingModelChange={onRerankingModelChange}
+                readonly={readonly}
+              />
             </div>
           )
         }
diff --git a/web/app/components/workflow/nodes/knowledge-base/hooks/use-config.ts b/web/app/components/workflow/nodes/knowledge-base/hooks/use-config.ts
index d5c810cbc4..c61fe0fab4 100644
--- a/web/app/components/workflow/nodes/knowledge-base/hooks/use-config.ts
+++ b/web/app/components/workflow/nodes/knowledge-base/hooks/use-config.ts
@@ -109,7 +109,7 @@ export const useConfig = (id: string) => {
     handleNodeDataUpdate({
       retrieval_model: {
         ...nodeData?.data.retrieval_model,
-        hybridSearchMode,
+        reranking_mode: hybridSearchMode,
       },
     })
   }, [getNodeData, handleNodeDataUpdate])
diff --git a/web/app/components/workflow/nodes/knowledge-base/panel.tsx b/web/app/components/workflow/nodes/knowledge-base/panel.tsx
index 9eaf4ef39f..35d52cd359 100644
--- a/web/app/components/workflow/nodes/knowledge-base/panel.tsx
+++ b/web/app/components/workflow/nodes/knowledge-base/panel.tsx
@@ -147,7 +147,7 @@ const Panel: FC<NodePanelProps<KnowledgeBaseNodeType>> = ({
                   indexMethod={data.indexing_technique}
                   searchMethod={data.retrieval_model.search_method}
                   onRetrievalSearchMethodChange={handleRetrievalSearchMethodChange}
-                  hybridSearchMode={data.retrieval_model.hybridSearchMode}
+                  hybridSearchMode={data.retrieval_model.reranking_mode}
                   onHybridSearchModeChange={handleHybridSearchModeChange}
                   weightedScore={data.retrieval_model.weights}
                   onWeightedScoreChange={handleWeighedScoreChange}
diff --git a/web/app/components/workflow/nodes/knowledge-base/types.ts b/web/app/components/workflow/nodes/knowledge-base/types.ts
index 87a8b30d91..a8a0811c54 100644
--- a/web/app/components/workflow/nodes/knowledge-base/types.ts
+++ b/web/app/components/workflow/nodes/knowledge-base/types.ts
@@ -39,7 +39,7 @@ export type RetrievalSetting = {
   top_k: number
   score_threshold_enabled: boolean
   score_threshold: number
-  hybridSearchMode?: RerankingModeEnum
+  reranking_mode?: RerankingModeEnum
 }
 export type KnowledgeBaseNodeType = CommonNodeType & {
   index_chunk_variable_selector: string[]

From 926ae7320a2312f765842b6d7d0c55e7d0e757d6 Mon Sep 17 00:00:00 2001
From: twwu <twwu@dify.ai>
Date: Tue, 16 Sep 2025 21:08:05 +0800
Subject: [PATCH 2/2] feat: Add useDatasetApiAccessUrl hook and update API
 links in various components for localization support

---
 .../create/embedding-process/index.tsx        | 23 +++++++++++--------
 .../processing/embedding-process/index.tsx    | 23 +++++++++++--------
 .../datasets/extra-info/service-api/card.tsx  |  5 +++-
 .../rag-pipeline-header/publisher/popup.tsx   | 10 ++++++--
 web/hooks/use-api-access-url.ts               | 16 +++++++++++++
 5 files changed, 56 insertions(+), 21 deletions(-)
 create mode 100644 web/hooks/use-api-access-url.ts

diff --git a/web/app/components/datasets/create/embedding-process/index.tsx b/web/app/components/datasets/create/embedding-process/index.tsx
index 406a2a803d..df64f26ab9 100644
--- a/web/app/components/datasets/create/embedding-process/index.tsx
+++ b/web/app/components/datasets/create/embedding-process/index.tsx
@@ -32,6 +32,8 @@ import { RETRIEVE_METHOD } from '@/types/app'
 import Tooltip from '@/app/components/base/tooltip'
 import { useInvalidDocumentList } from '@/service/knowledge/use-document'
 import Divider from '@/app/components/base/divider'
+import { useDatasetApiAccessUrl } from '@/hooks/use-api-access-url'
+import Link from 'next/link'
 
 type Props = {
   datasetId: string
@@ -212,9 +214,7 @@ const EmbeddingProcess: FC<Props> = ({ datasetId, batchId, documents = [], index
     invalidDocumentList()
     router.push(`/datasets/${datasetId}/documents`)
   }
-  const navToApiDocs = () => {
-    router.push('/datasets?category=api')
-  }
+  const apiReferenceUrl = useDatasetApiAccessUrl()
 
   const isEmbedding = useMemo(() => {
     return indexingStatusBatchDetail.some(indexingStatusDetail => ['indexing', 'splitting', 'parsing', 'cleaning'].includes(indexingStatusDetail?.indexing_status || ''))
@@ -344,13 +344,18 @@ const EmbeddingProcess: FC<Props> = ({ datasetId, batchId, documents = [], index
         />
       </div>
       <div className='mt-6 flex items-center gap-x-2 py-2'>
-        <Button
-          className='w-fit gap-x-0.5 px-3'
-          onClick={navToApiDocs}
+        <Link
+          href={apiReferenceUrl}
+          target='_blank'
+          rel='noopener noreferrer'
         >
-          <RiTerminalBoxLine className='size-4' />
-          <span className='px-0.5'>Access the API</span>
-        </Button>
+          <Button
+            className='w-fit gap-x-0.5 px-3'
+          >
+            <RiTerminalBoxLine className='size-4' />
+            <span className='px-0.5'>Access the API</span>
+          </Button>
+        </Link>
         <Button
           className='w-fit gap-x-0.5 px-3'
           variant='primary'
diff --git a/web/app/components/datasets/documents/create-from-pipeline/processing/embedding-process/index.tsx b/web/app/components/datasets/documents/create-from-pipeline/processing/embedding-process/index.tsx
index d86cd266d0..9572933a0a 100644
--- a/web/app/components/datasets/documents/create-from-pipeline/processing/embedding-process/index.tsx
+++ b/web/app/components/datasets/documents/create-from-pipeline/processing/embedding-process/index.tsx
@@ -26,6 +26,8 @@ import type { RETRIEVE_METHOD } from '@/types/app'
 import { DatasourceType, type InitialDocumentDetail } from '@/models/pipeline'
 import { useIndexingStatusBatch, useProcessRule } from '@/service/knowledge/use-dataset'
 import Divider from '@/app/components/base/divider'
+import { useDatasetApiAccessUrl } from '@/hooks/use-api-access-url'
+import Link from 'next/link'
 
 type EmbeddingProcessProps = {
   datasetId: string
@@ -84,9 +86,7 @@ const EmbeddingProcess = ({
     invalidDocumentList()
     router.push(`/datasets/${datasetId}/documents`)
   }
-  const navToApiDocs = () => {
-    router.push('/datasets?category=api')
-  }
+  const apiReferenceUrl = useDatasetApiAccessUrl()
 
   const isEmbeddingWaiting = useMemo(() => {
     if (!indexingStatusBatchDetail.length) return false
@@ -223,13 +223,18 @@ const EmbeddingProcess = ({
         />
       </div>
       <div className='mt-6 flex items-center gap-x-2 py-2'>
-        <Button
-          className='w-fit gap-x-0.5 px-3'
-          onClick={navToApiDocs}
+        <Link
+          href={apiReferenceUrl}
+          target='_blank'
+          rel='noopener noreferrer'
         >
-          <RiTerminalBoxLine className='size-4' />
-          <span className='px-0.5'>Access the API</span>
-        </Button>
+          <Button
+            className='w-fit gap-x-0.5 px-3'
+          >
+            <RiTerminalBoxLine className='size-4' />
+            <span className='px-0.5'>Access the API</span>
+          </Button>
+        </Link>
         <Button
           className='w-fit gap-x-0.5 px-3'
           variant='primary'
diff --git a/web/app/components/datasets/extra-info/service-api/card.tsx b/web/app/components/datasets/extra-info/service-api/card.tsx
index 8ea3473e1a..e6444d995e 100644
--- a/web/app/components/datasets/extra-info/service-api/card.tsx
+++ b/web/app/components/datasets/extra-info/service-api/card.tsx
@@ -12,6 +12,7 @@ import { useDisableDatasetServiceApi, useEnableDatasetServiceApi } from '@/servi
 import { useDatasetDetailContextWithSelector } from '@/context/dataset-detail'
 import Link from 'next/link'
 import SecretKeyModal from '@/app/components/develop/secret-key/secret-key-modal'
+import { useDatasetApiAccessUrl } from '@/hooks/use-api-access-url'
 
 type CardProps = {
   apiEnabled: boolean
@@ -31,6 +32,8 @@ const Card = ({
 
   const isCurrentWorkspaceManager = useAppContextSelector(state => state.isCurrentWorkspaceManager)
 
+  const apiReferenceUrl = useDatasetApiAccessUrl()
+
   const onToggle = useCallback(async (state: boolean) => {
     let result: 'success' | 'fail'
     if (state)
@@ -113,7 +116,7 @@ const Card = ({
           </span>
         </Button>
         <Link
-          href={'https://docs.dify.ai/api-reference/datasets'}
+          href={apiReferenceUrl}
           target='_blank'
           rel='noopener noreferrer'
         >
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 f246d5e849..c8ef6c3601 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
@@ -45,6 +45,7 @@ import PremiumBadge from '@/app/components/base/premium-badge'
 import { SparklesSoft } from '@/app/components/base/icons/src/public/common'
 import { useModalContextSelector } from '@/context/modal-context'
 import Link from 'next/link'
+import { useDatasetApiAccessUrl } from '@/hooks/use-api-access-url'
 
 const PUBLISH_SHORTCUT = ['ctrl', '⇧', 'P']
 
@@ -64,6 +65,7 @@ const Popup = () => {
   const workflowStore = useWorkflowStore()
   const { isAllowPublishAsCustomKnowledgePipelineTemplate } = useProviderContext()
   const setShowPricingModal = useModalContextSelector(s => s.setShowPricingModal)
+  const apiReferenceUrl = useDatasetApiAccessUrl()
 
   const [confirmVisible, {
     setFalse: hideConfirm,
@@ -273,7 +275,11 @@ const Popup = () => {
           </div>
           <RiArrowRightUpLine className='ml-2 h-4 w-4 shrink-0' />
         </Button>
-        <a href='/datasets?category=api' target='_blank'>
+        <Link
+          href={apiReferenceUrl}
+          target='_blank'
+          rel='noopener noreferrer'
+        >
           <Button
             className='w-full hover:bg-state-accent-hover hover:text-text-accent'
             variant='tertiary'
@@ -285,7 +291,7 @@ const Popup = () => {
             </div>
             <RiArrowRightUpLine className='ml-2 h-4 w-4 shrink-0' />
           </Button>
-        </a>
+        </Link>
         <Divider className='my-2' />
         <Button
           className='w-full hover:bg-state-accent-hover hover:text-text-accent'
diff --git a/web/hooks/use-api-access-url.ts b/web/hooks/use-api-access-url.ts
new file mode 100644
index 0000000000..93639ae036
--- /dev/null
+++ b/web/hooks/use-api-access-url.ts
@@ -0,0 +1,16 @@
+import { useMemo } from 'react'
+import { useGetLanguage } from '@/context/i18n'
+
+export const useDatasetApiAccessUrl = () => {
+  const locale = useGetLanguage()
+
+  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
+}