Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
Python agentagentic-aiagentic-frameworkagentic-workflowaiautomationclaudedeepseekgenaigptllmlow-codemcpnextjsno-codeopenaipythonskillsworkflow
fix(web): route enterprise documentation links (#40957)
Stephen Zhou3d08b2f89a75
diff --git a/web/app/components/datasets/list/__tests__/index.spec.tsx b/web/app/components/datasets/list/__tests__/index.spec.tsxindex 9ad61c02c00..6505d8b04f5 100644--- a/web/app/components/datasets/list/__tests__/index.spec.tsx+++ b/web/app/components/datasets/list/__tests__/index.spec.tsx@@ -2,6 +2,7 @@ import type { ReactElement, ReactNode } from 'react'import { act, fireEvent, screen, waitFor, within } from '@testing-library/react'import userEvent from '@testing-library/user-event'import { createStore, Provider } from 'jotai'+import { queryClientAtom } from 'jotai-tanstack-query'import { hydrateRoot } from 'react-dom/client'import { renderToString } from 'react-dom/server'import { beforeEach, describe, expect, it, vi } from 'vite-plus/test'@@ -382,14 +383,15 @@ describe('List', () => {await user.click(within(guide).getByRole('button', { name: 'dataset.newKnowledge.gotIt' }))firstRender.unmount()- const store = createStore()- seedRegisteredConsoleStateFixture(store)const { wrapper: NuqsWrapper } = createNuqsTestWrapper()- const { wrapper: QueryWrapper } = createConsoleQueryWrapper({+ const { queryClient, wrapper: QueryWrapper } = createConsoleQueryWrapper({systemFeatures: {knowledge_fs_enabled: mockConsoleState.knowledgeFsEnabled,},})+ const store = createStore()+ store.set(queryClientAtom, queryClient)+ seedRegisteredConsoleStateFixture(store)const app = (<QueryWrapper><Provider store={store}>diff --git a/web/app/components/goto-anything/actions/commands/__tests__/direct-commands.spec.ts b/web/app/components/goto-anything/actions/commands/__tests__/direct-commands.spec.tsindex bb10791912b..1d9fab38609 100644--- a/web/app/components/goto-anything/actions/commands/__tests__/direct-commands.spec.ts+++ b/web/app/components/goto-anything/actions/commands/__tests__/direct-commands.spec.ts@@ -23,20 +23,15 @@ vi.mock('react-i18next', async () => {}})-vi.mock('@/context/i18n', () => ({- defaultDocBaseUrl: 'https://docs.dify.ai',- getDocHomePath: () => '/home',-}))--vi.mock('@/i18n-config/language', () => ({- getDocLanguage: (locale: string) => (locale === 'en' ? 'en' : locale),-}))-describe('docsCommand', () => {beforeEach(() => {vi.clearAllMocks()})+ afterEach(() => {+ docsCommand.unregister?.()+ })+it('has correct metadata', () => {expect(docsCommand.name).toBe('docs')expect(docsCommand.mode).toBe('direct')@@ -45,6 +40,7 @@ describe('docsCommand', () => {it('execute opens documentation in new tab', () => {const openSpy = vi.spyOn(window, 'open').mockImplementation(() => null)+ docsCommand.register?.({ getDocsHomeUrl: () => 'https://docs.dify.ai/en/home' })docsCommand.execute?.()@@ -56,6 +52,22 @@ describe('docsCommand', () => {openSpy.mockRestore()})+ it('execute uses the documentation URL registered by the provider', () => {+ const openSpy = vi.spyOn(window, 'open').mockImplementation(() => null)+ docsCommand.register?.({+ getDocsHomeUrl: () => 'https://enterprise-docs.dify.ai/en/',+ })++ docsCommand.execute?.()++ expect(openSpy).toHaveBeenCalledWith(+ 'https://enterprise-docs.dify.ai/en/',+ '_blank',+ 'noopener,noreferrer',+ )+ openSpy.mockRestore()+ })+it('search returns a single doc result', async () => {const results = await docsCommand.search('', 'en')@@ -77,18 +89,20 @@ describe('docsCommand', () => {})it('registers navigation.doc command', () => {- docsCommand.register?.({} as Record<string, never>)+ docsCommand.register?.({ getDocsHomeUrl: () => 'https://docs.dify.ai/en/home' })expect(registerCommands).toHaveBeenCalledWith({ 'navigation.doc': expect.any(Function) })})it('registered handler opens doc URL with correct locale', async () => {- docsCommand.register?.({} as Record<string, never>)+ docsCommand.register?.({+ getDocsHomeUrl: () => 'https://enterprise-docs.dify.ai/en/',+ })const openSpy = vi.spyOn(window, 'open').mockImplementation(() => null)const handlers = vi.mocked(registerCommands).mock.calls[0]![0]await handlers['navigation.doc']!()expect(openSpy).toHaveBeenCalledWith(- 'https://docs.dify.ai/en/home',+ 'https://enterprise-docs.dify.ai/en/','_blank','noopener,noreferrer',)diff --git a/web/app/components/goto-anything/actions/commands/__tests__/slash.spec.tsx b/web/app/components/goto-anything/actions/commands/__tests__/slash.spec.tsxindex 57cb861897b..bb6cd6a091e 100644--- a/web/app/components/goto-anything/actions/commands/__tests__/slash.spec.tsx+++ b/web/app/components/goto-anything/actions/commands/__tests__/slash.spec.tsx@@ -181,4 +181,15 @@ describe('SlashCommandProvider', () => {'refine',])})++ it('should register the enterprise documentation home URL', () => {+ const { unmount } = render(<SlashCommandProvider />, {+ systemFeatures: { deployment_edition: 'ENTERPRISE' },+ })+ const docsRegistration = mockRegister.mock.calls.find((call) => call[0].name === 'docs')++ expect(docsRegistration?.[1].getDocsHomeUrl()).toBe('https://enterprise-docs.dify.ai/en/')++ unmount()+ })})diff --git a/web/app/components/goto-anything/actions/commands/docs.tsx b/web/app/components/goto-anything/actions/commands/docs.tsxindex b234af8a7ca..83d19cdb866 100644--- a/web/app/components/goto-anything/actions/commands/docs.tsx+++ b/web/app/components/goto-anything/actions/commands/docs.tsx@@ -1,17 +1,16 @@import type { SlashCommandHandler } from './types'import { getI18n } from 'react-i18next'-import { defaultDocBaseUrl, getDocHomePath } from '@/context/i18n'-import { getDocLanguage } from '@/i18n-config/language'import { registerCommands, unregisterCommands } from './command-bus'-// Documentation command dependency types - no external dependencies needed-type DocDeps = Record<string, never>+type DocDeps = {+ getDocsHomeUrl: () => string+}++let getDocsHomeUrl: (() => string) | undefined-const getDocsHomeUrl = () => {- const i18n = getI18n()- const currentLocale = i18n.language- const docLanguage = getDocLanguage(currentLocale)- return `${defaultDocBaseUrl}/${docLanguage}${getDocHomePath()}`+const openDocsHome = () => {+ const url = getDocsHomeUrl?.()+ if (url) window.open(url, '_blank', 'noopener,noreferrer')}/**@@ -24,7 +23,7 @@ export const docsCommand: SlashCommandHandler<DocDeps> = {// Direct execution functionexecute: () => {- window.open(getDocsHomeUrl(), '_blank', 'noopener,noreferrer')+ openDocsHome()},search(args: string, locale: string = 'en') {@@ -47,15 +46,17 @@ export const docsCommand: SlashCommandHandler<DocDeps> = {]},- register(_deps: DocDeps) {+ register(deps: DocDeps) {+ getDocsHomeUrl = deps.getDocsHomeUrlregisterCommands({'navigation.doc': async (_args) => {- window.open(getDocsHomeUrl(), '_blank', 'noopener,noreferrer')+ openDocsHome()},})},unregister() {+ getDocsHomeUrl = undefinedunregisterCommands(['navigation.doc'])},}diff --git a/web/app/components/goto-anything/actions/commands/slash-provider.tsx b/web/app/components/goto-anything/actions/commands/slash-provider.tsxindex c4b50095384..1eeedf8fccc 100644--- a/web/app/components/goto-anything/actions/commands/slash-provider.tsx+++ b/web/app/components/goto-anything/actions/commands/slash-provider.tsx@@ -2,6 +2,7 @@import { useTheme } from 'next-themes'import { useEffect } from 'react'import { ENABLE_FEATURE_PREVIEW } from '@/config'+import { useDocLink } from '@/context/i18n'import { setLocaleOnClient } from '@/i18n-config'import { accountCommand } from './account'import { communityCommand } from './community'@@ -15,6 +16,7 @@ import { slashCommandRegistry } from './registry'import { themeCommand } from './theme'type SlashCommandDeps = {+ getDocsHomeUrl: () => stringsetTheme: (theme: string) => voidsetLocale: typeof setLocaleOnClient}@@ -25,7 +27,7 @@ const registerSlashCommands = (deps: SlashCommandDeps) => {setLocale: deps.setLocale as (locale: string) => Promise<void>,})slashCommandRegistry.register(forumCommand, {})- slashCommandRegistry.register(docsCommand, {})+ slashCommandRegistry.register(docsCommand, { getDocsHomeUrl: deps.getDocsHomeUrl })slashCommandRegistry.register(communityCommand, {})slashCommandRegistry.register(accountCommand, {})slashCommandRegistry.register(goCommand, {})@@ -49,13 +51,15 @@ const unregisterSlashCommands = () => {export const SlashCommandProvider = () => {const theme = useTheme()+ const getDocsHomeUrl = useDocLink()useEffect(() => {registerSlashCommands({+ getDocsHomeUrl,setTheme: theme.setTheme,setLocale: setLocaleOnClient,})return () => unregisterSlashCommands()- }, [theme.setTheme])+ }, [getDocsHomeUrl, theme.setTheme])return null}diff --git a/web/app/components/header/account-setting/access-rules-page/permission-set-modal/index.tsx b/web/app/components/header/account-setting/access-rules-page/permission-set-modal/index.tsxindex 93c3819e7d0..803573596fb 100644--- a/web/app/components/header/account-setting/access-rules-page/permission-set-modal/index.tsx+++ b/web/app/components/header/account-setting/access-rules-page/permission-set-modal/index.tsx@@ -13,7 +13,7 @@ import { Input } from '@langgenius/dify-ui/input'import { Textarea } from '@langgenius/dify-ui/textarea'import { useState } from 'react'import { useTranslation } from 'react-i18next'-import { useLocale } from '@/context/i18n'+import { getEnterpriseDocUrl, useLocale } from '@/context/i18n'import { getDocLanguage } from '@/i18n-config/language'import PermissionPicker from './permission-picker'@@ -136,7 +136,7 @@ const PermissionSetModalBody = ({<div className="flex shrink-0 items-center justify-between gap-3 border-t border-divider-subtle px-6 py-4"><a- href={`https://enterprise-docs.dify.ai/${docLanguage}/3.11.x/use/workspace/permission-reference`}+ href={getEnterpriseDocUrl('/use/workspace/permission-reference', docLanguage)}target="_blank"rel="noreferrer"className="inline-flex items-center gap-1 system-xs-medium text-text-accent hover:underline"diff --git a/web/app/components/header/account-setting/permissions-page/role-modal/index.tsx b/web/app/components/header/account-setting/permissions-page/role-modal/index.tsxindex 6950017f9ed..37254f87e4d 100644--- a/web/app/components/header/account-setting/permissions-page/role-modal/index.tsx+++ b/web/app/components/header/account-setting/permissions-page/role-modal/index.tsx@@ -13,7 +13,7 @@ import { Input } from '@langgenius/dify-ui/input'import { Textarea } from '@langgenius/dify-ui/textarea'import { useCallback, useState } from 'react'import { useTranslation } from 'react-i18next'-import { useLocale } from '@/context/i18n'+import { getEnterpriseDocUrl, useLocale } from '@/context/i18n'import { getDocLanguage } from '@/i18n-config/language'import PermissionField from './permission-field'@@ -113,7 +113,7 @@ const RoleModal = ({ mode, open, role, onClose, onSubmit }: RoleModalProps) => {</div><div className="flex shrink-0 items-center justify-between gap-3 border-t border-divider-subtle px-6 py-4"><a- href={`https://enterprise-docs.dify.ai/${docLanguage}/3.11.x/use/workspace/permission-reference`}+ href={getEnterpriseDocUrl('/use/workspace/permission-reference', docLanguage)}target="_blank"rel="noreferrer"className="inline-flex items-center gap-1 system-xs-medium text-text-accent hover:underline"diff --git a/web/context/i18n.spec.ts b/web/context/i18n.spec.tsindex 496ac82b17e..8a440ba2073 100644--- a/web/context/i18n.spec.ts+++ b/web/context/i18n.spec.ts@@ -3,7 +3,7 @@ import type { DocPathWithoutLang } from '@/types/doc-paths'import { renderHook } from '@testing-library/react'import { useTranslation } from '#i18n'import { getDocLanguage } from '@/i18n-config/language'-import { defaultDocBaseUrl, useDocLink } from './i18n'+import { defaultDocBaseUrl, enterpriseDocBaseUrl, useDocLink } from './i18n'const mockDeploymentEdition = vi.hoisted(() => ({value: 'CLOUD' as 'COMMUNITY' | 'ENTERPRISE' | 'CLOUD',@@ -215,6 +215,106 @@ describe('useDocLink', () => {})})+ describe('Enterprise documentation', () => {+ beforeEach(() => {+ mockDeploymentEdition.value = 'ENTERPRISE'+ })++ it('should route use documentation to the versioned enterprise documentation', () => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current('/use-dify/build/workflow-chatflow')).toBe(+ `${enterpriseDocBaseUrl}/en/use/build/workflow-chatflow`,+ )+ })++ it.each([+ ['/use-dify/getting-started/introduction', '/use/build/workflow-chatflow'],+ ['/cli/overview', '/develop/cli/introduction'],+ ['/cli/authenticate', '/develop/cli/account-users/authenticate'],+ ['/cli/common-tasks', '/develop/cli/account-users/common-tasks'],+ ['/cli/quick-start', '/develop/cli/account-users/quick-start'],+ ] as const)('should map the renamed %s page to %s', (communityPath, enterprisePath) => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current(communityPath)).toBe(`${enterpriseDocBaseUrl}/en${enterprisePath}`)+ })++ it('should convert API, plugin, and CLI documentation prefixes', () => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current('/api-reference/guides/knowledge')).toBe(+ `${enterpriseDocBaseUrl}/en/develop/api/guides/knowledge`,+ )+ expect(result.current('/develop-plugin/getting-started/getting-started-dify-plugin')).toBe(+ `${enterpriseDocBaseUrl}/en/develop/plugins/getting-started/getting-started-dify-plugin`,+ )+ expect(result.current('/cli/install')).toBe(`${enterpriseDocBaseUrl}/en/develop/cli/install`)+ })++ it('should remove public product prefixes and preserve anchors', () => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current('/self-host/use-dify/workspace/tools#mcp' as DocPathWithoutLang)).toBe(+ `${enterpriseDocBaseUrl}/en/use/workspace/tools#mcp`,+ )+ expect(result.current('/cloud/use-dify/nodes/start' as DocPathWithoutLang)).toBe(+ `${enterpriseDocBaseUrl}/en/use/nodes/start`,+ )+ })++ it.each(['/cloud', '/self-host'] as const)(+ 'should map the bare %s product prefix to the enterprise documentation home',+ (productPrefix) => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current(productPrefix as DocPathWithoutLang)).toBe(+ `${enterpriseDocBaseUrl}/en/`,+ )+ },+ )++ it.each([+ '/use-dify/knowledge/knowledge-request-rate-limit',+ '/cloud/use-dify/knowledge/knowledge-storage-limit',+ '/cloud/use-dify/workspace/subscription-management#dify-for-education',+ ] as const)('should fall back to the enterprise documentation home for %s', (communityPath) => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current(communityPath as DocPathWithoutLang)).toBe(+ `${enterpriseDocBaseUrl}/en/`,+ )+ })++ it('should open the enterprise documentation home when no path is provided', () => {+ const { result } = renderHook(() => useDocLink())++ expect(result.current()).toBe(`${enterpriseDocBaseUrl}/en/`)+ })++ it('should use Chinese and Japanese enterprise documentation languages', () => {+ vi.mocked(useTranslation).mockReturnValue({+ i18n: { language: 'zh-Hans' },+ } as ReturnType<typeof useTranslation>)+ vi.mocked(getDocLanguage).mockReturnValue('zh')++ const { result, rerender } = renderHook(() => useDocLink())+ expect(result.current('/use-dify/nodes/start')).toBe(+ `${enterpriseDocBaseUrl}/zh/use/nodes/start`,+ )++ vi.mocked(useTranslation).mockReturnValue({+ i18n: { language: 'ja-JP' },+ } as ReturnType<typeof useTranslation>)+ vi.mocked(getDocLanguage).mockReturnValue('ja')+ rerender()++ expect(result.current('/use-dify/nodes/start')).toBe(+ `${enterpriseDocBaseUrl}/ja/use/nodes/start`,+ )+ })+ })+describe('Language prefix handling', () => {it('should add /en prefix for English locale', () => {vi.mocked(useTranslation).mockReturnValue({diff --git a/web/context/i18n.ts b/web/context/i18n.tsindex 6470ed5a52d..6ab81000ca2 100644--- a/web/context/i18n.ts+++ b/web/context/i18n.ts@@ -1,6 +1,6 @@import type { DeploymentEdition } from '@dify/contracts/api/console/system-features/types.gen'import type { Locale } from '@/i18n-config/language'-import type { DocPathWithoutLang, DocsProduct } from '@/types/doc-paths'+import type { DocLanguage, DocPathWithoutLang, DocsProduct } from '@/types/doc-paths'import { useAtomValue } from 'jotai'import { useCallback } from 'react'import { useTranslation } from '#i18n'@@ -25,9 +25,10 @@ export const useGetPricingPageLanguage = () => {}export const defaultDocBaseUrl = 'https://docs.dify.ai'+export const enterpriseDocBaseUrl = 'https://enterprise-docs.dify.ai'export type DocPathMap = Partial<Record<Locale, DocPathWithoutLang>>-export const getDocHomePath = () => '/home'+const getDocHomePath = () => '/home'const getCurrentDocsProduct = (deploymentEdition: DeploymentEdition): DocsProduct => {if (deploymentEdition === 'CLOUD') return 'cloud'@@ -64,18 +65,69 @@ const getProductAwarePath = (path: string, deploymentEdition: DeploymentEdition)return `/${targetProduct}${pathname}${hash}`}+const replacePathPrefix = (path: string, sourcePrefix: string, targetPrefix: string): string => {+ if (path === sourcePrefix) return targetPrefix+ if (!path.startsWith(`${sourcePrefix}/`)) return path++ return `${targetPrefix}${path.slice(sourcePrefix.length)}`+}++const enterpriseDocPathOverrides: Readonly<Record<string, string>> = {+ '/use-dify/getting-started/introduction': '/use/build/workflow-chatflow',+ '/cli/overview': '/develop/cli/introduction',+ '/cli/authenticate': '/develop/cli/account-users/authenticate',+ '/cli/common-tasks': '/develop/cli/account-users/common-tasks',+ '/cli/quick-start': '/develop/cli/account-users/quick-start',+}++const unavailableEnterpriseDocPaths: ReadonlySet<string> = new Set([+ '/use/knowledge/knowledge-request-rate-limit',+ '/use/knowledge/knowledge-storage-limit',+ '/use/workspace/subscription-management',+])++const getEnterpriseDocPath = (path: string): string => {+ const { pathname, hash } = splitPathHash(path)+ let targetPath = replacePathPrefix(pathname, '/cloud', '')+ targetPath = replacePathPrefix(targetPath, '/self-host', '')++ if (!targetPath) return '/'++ const overriddenPath = enterpriseDocPathOverrides[targetPath]+ if (overriddenPath) return `${overriddenPath}${hash}`++ targetPath = replacePathPrefix(targetPath, '/use-dify', '/use')+ targetPath = replacePathPrefix(targetPath, '/api-reference', '/develop/api')+ targetPath = replacePathPrefix(targetPath, '/develop-plugin', '/develop/plugins')+ targetPath = replacePathPrefix(targetPath, '/cli', '/develop/cli')++ if (unavailableEnterpriseDocPaths.has(targetPath)) return '/'++ return `${targetPath}${hash}`+}++export const getEnterpriseDocUrl = (path: string, docLanguage: DocLanguage): string => {+ const targetPath = path ? getEnterpriseDocPath(path) : '/'++ return `${enterpriseDocBaseUrl}/${docLanguage}${targetPath}`+}+export const useDocLink = (baseUrl?: string,): ((path?: DocPathWithoutLang, pathMap?: DocPathMap) => string) => {- let baseDocUrl = baseUrl || defaultDocBaseUrl- baseDocUrl = baseDocUrl.endsWith('/') ? baseDocUrl.slice(0, -1) : baseDocUrlconst locale = useLocale()const deploymentEdition = useAtomValue(deploymentEditionAtom)+ const useEnterpriseDocs = deploymentEdition === 'ENTERPRISE' && !baseUrl+ let baseDocUrl = baseUrl || (useEnterpriseDocs ? enterpriseDocBaseUrl : defaultDocBaseUrl)+ baseDocUrl = baseDocUrl.endsWith('/') ? baseDocUrl.slice(0, -1) : baseDocUrlreturn useCallback((path?: DocPathWithoutLang, pathMap?: DocPathMap): string => {const docLanguage = getDocLanguage(locale)const pathUrl = path || ''let targetPath = pathMap ? pathMap[locale] || pathUrl : pathUrl++ if (useEnterpriseDocs) return getEnterpriseDocUrl(targetPath, docLanguage)+const languagePrefix = `/${docLanguage}`if (!targetPath) {@@ -86,6 +138,6 @@ export const useDocLink = (return `${baseDocUrl}${languagePrefix}${targetPath}`},- [baseDocUrl, deploymentEdition, locale],+ [baseDocUrl, deploymentEdition, locale, useEnterpriseDocs],)}diff --git a/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/__tests__/dialog.spec.tsx b/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/__tests__/dialog.spec.tsxindex 802ec3bb1bb..977e75e85eb 100644--- a/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/__tests__/dialog.spec.tsx+++ b/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/__tests__/dialog.spec.tsx@@ -10,6 +10,10 @@ vi.mock('@langgenius/dify-ui/toast', () => ({},}))+vi.mock('@/context/i18n', () => ({+ useDocLink: () => () => 'https://docs.example.com',+}))+type CliToolDialogProps = Parameters<typeof CliToolDialog>[0]function renderCliToolDialog(props?: Partial<CliToolDialogProps>) {@@ -129,6 +133,16 @@ describe('CliToolDialog', () => {})describe('Actions', () => {+ it('should link to documentation through the shared documentation URL', () => {+ renderCliToolDialog()++ expect(+ screen.getByRole('link', {+ name: /agentV2\.agentDetail\.configure\.tools\.cliDialog\.learnMore/,+ }),+ ).toHaveAttribute('href', 'https://docs.example.com')+ })+it('should keep the form open when the backdrop is clicked', async () => {const user = userEvent.setup()const { onOpenChange } = renderCliToolDialog()diff --git a/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/dialog.tsx b/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/dialog.tsxindex becb0eaa71a..da28d6ae7be 100644--- a/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/dialog.tsx+++ b/web/features/agent-v2/agent-detail/configure/components/orchestrate/tools/cli-tool/dialog.tsx@@ -19,6 +19,7 @@ import { Input } from '@langgenius/dify-ui/input'import { toast } from '@langgenius/dify-ui/toast'import { useCallback, useState } from 'react'import { useTranslation } from 'react-i18next'+import { useDocLink } from '@/context/i18n'import { EnvVariablesTable } from '../../advanced/env'type CliToolFormValues = {@@ -53,6 +54,7 @@ export function CliToolDialog({}) {const { t } = useTranslation('agentV2')const { t: tCommon } = useTranslation('common')+ const docLink = useDocLink()const [installCommand, setInstallCommand] = useState(tool?.installCommand ?? '')const [toolName, setToolName] = useState(tool?.name ?? '')const [envVariables, setEnvVariables] = useState<EnvVariable[]>(() =>@@ -236,7 +238,7 @@ export function CliToolDialog({</div><div className="flex items-center gap-3 py-8"><a- href="https://docs.dify.ai/"+ href={docLink()}target="_blank"rel="noreferrer"className="inline-flex min-w-0 flex-1 items-center gap-1 system-xs-regular text-text-accent hover:underline focus-visible:ring-2 focus-visible:ring-state-accent-solid focus-visible:outline-hidden"diff --git a/web/features/new-rag/__tests__/new-knowledge-list.spec.tsx b/web/features/new-rag/__tests__/new-knowledge-list.spec.tsxindex c3b008a063c..0ab12ddc07c 100644--- a/web/features/new-rag/__tests__/new-knowledge-list.spec.tsx+++ b/web/features/new-rag/__tests__/new-knowledge-list.spec.tsx@@ -85,6 +85,11 @@ vi.mock('@/context/permission-state', () => ({workspacePermissionKeysAtom: permissionStateMock.workspacePermissionKeysAtom,}))+vi.mock('@/context/i18n', () => ({+ useDocLink: () => (path?: string) => `https://docs.example.com${path ?? ''}`,+ useLocale: () => 'en-US',+}))+vi.mock('@/service/client', () => ({consoleQuery: {knowledgeFs: {@@ -141,6 +146,17 @@ describe('NewKnowledgeList', () => {expect(options?.getNextPageParam({ items: [] })).toBeUndefined()})+ it('links the guide through the shared documentation URL', () => {+ setResolvedPage()++ renderWithNuqs(<NewKnowledgeList view="new" onViewChange={vi.fn()} />)++ expect(screen.getByRole('link', { name: 'dataset.newKnowledge.learnMore' })).toHaveAttribute(+ 'href',+ 'https://docs.example.com/use-dify/knowledge/readme',+ )+ })+it('links real knowledge spaces to the new detail shell', () => {setResolvedPage([{diff --git a/web/features/new-rag/components/knowledge-view-switcher.tsx b/web/features/new-rag/components/knowledge-view-switcher.tsxindex e7691c49646..993582d4363 100644--- a/web/features/new-rag/components/knowledge-view-switcher.tsx+++ b/web/features/new-rag/components/knowledge-view-switcher.tsx@@ -9,6 +9,7 @@ import {import { SegmentedControl, SegmentedControlItem } from '@langgenius/dify-ui/segmented-control'import { useState } from 'react'import { useTranslation } from 'react-i18next'+import { useDocLink } from '@/context/i18n'import {useNewKnowledgeGuideDismissedValue,useSetNewKnowledgeGuideDismissed,@@ -21,6 +22,7 @@ export type KnowledgeViewSwitcherProps = {export function KnowledgeViewSwitcher({ value, onChange }: KnowledgeViewSwitcherProps) {const { t } = useTranslation('dataset')+ const docLink = useDocLink()const guideDismissed = useNewKnowledgeGuideDismissedValue()const setGuideDismissed = useSetNewKnowledgeGuideDismissed()const [guideOpenOverride, setGuideOpenOverride] = useState<boolean | null>(null)@@ -84,7 +86,7 @@ export function KnowledgeViewSwitcher({ value, onChange }: KnowledgeViewSwitcher</PopoverDescription><div className="mt-auto flex flex-wrap items-center justify-end gap-3 pt-3"><a- href="https://docs.dify.ai/en/guides/knowledge-base"+ href={docLink('/use-dify/knowledge/readme')}target="_blank"rel="noreferrer"className="rounded-sm system-xs-regular text-text-accent focus-visible:ring-2 focus-visible:ring-state-accent-solid focus-visible:outline-hidden"