From a38ddd9d02fa70e5af38d99edcd9d14d9817ff8e Mon Sep 17 00:00:00 2001
From: yyh <92089059+lyzno1@users.noreply.github.com>
Date: Thu, 27 Aug 2026 08:38:41 +0000
Subject: [PATCH] fix: align documentation links with stable anchors (#41384)

---
 docker/docker-compose-template.yaml                           | 2 +-
 docker/docker-compose.middleware.yaml                         | 2 +-
 docker/docker-compose.yaml                                    | 2 +-
 .../hooks/__tests__/use-available-nodes-meta-data.spec.ts     | 4 ++--
 .../workflow/nodes/agent-v2/__tests__/default.spec.ts         | 2 +-
 web/app/components/workflow/nodes/agent-v2/default.ts         | 2 +-
 web/app/components/workflow/nodes/agent/default.ts            | 1 +
 7 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/docker/docker-compose-template.yaml b/docker/docker-compose-template.yaml
index 2ff66d23a71..04a0c9b9fa1 100644
--- a/docker/docker-compose-template.yaml
+++ b/docker/docker-compose-template.yaml
@@ -715,7 +715,7 @@ services:
 
   # ssrf_proxy server
   # for more information, please refer to
-  # https://docs.dify.ai/learn-more/faq/install-faq#18-why-is-ssrf-proxy-needed%3F
+  # https://docs.dify.ai/en/self-host/deploy/troubleshooting/docker-issues#why-is-ssrf-proxy-needed
   ssrf_proxy:
     image: ubuntu/squid:latest
     restart: always
diff --git a/docker/docker-compose.middleware.yaml b/docker/docker-compose.middleware.yaml
index 23c964a38fc..9fa3bc98f46 100644
--- a/docker/docker-compose.middleware.yaml
+++ b/docker/docker-compose.middleware.yaml
@@ -193,7 +193,7 @@ services:
 
   # ssrf_proxy server
   # for more information, please refer to
-  # https://docs.dify.ai/learn-more/faq/install-faq#18-why-is-ssrf-proxy-needed%3F
+  # https://docs.dify.ai/en/self-host/deploy/troubleshooting/docker-issues#why-is-ssrf-proxy-needed
   ssrf_proxy:
     image: ubuntu/squid:latest
     restart: always
diff --git a/docker/docker-compose.yaml b/docker/docker-compose.yaml
index aea50d76f2a..0ad2271b29d 100644
--- a/docker/docker-compose.yaml
+++ b/docker/docker-compose.yaml
@@ -721,7 +721,7 @@ services:
 
   # ssrf_proxy server
   # for more information, please refer to
-  # https://docs.dify.ai/learn-more/faq/install-faq#18-why-is-ssrf-proxy-needed%3F
+  # https://docs.dify.ai/en/self-host/deploy/troubleshooting/docker-issues#why-is-ssrf-proxy-needed
   ssrf_proxy:
     image: ubuntu/squid:latest
     restart: always
diff --git a/web/app/components/workflow-app/hooks/__tests__/use-available-nodes-meta-data.spec.ts b/web/app/components/workflow-app/hooks/__tests__/use-available-nodes-meta-data.spec.ts
index 1c5e42d6e11..6ded926c890 100644
--- a/web/app/components/workflow-app/hooks/__tests__/use-available-nodes-meta-data.spec.ts
+++ b/web/app/components/workflow-app/hooks/__tests__/use-available-nodes-meta-data.spec.ts
@@ -99,7 +99,7 @@ describe('useAvailableNodesMetaData', () => {
     expect(result.current.nodesMap?.[BlockEnum.AgentV2]?.checkValid).toEqual(expect.any(Function))
     expect(result.current.nodesMap?.[BlockEnum.Agent]?.checkValid).toEqual(expect.any(Function))
     expect(result.current.nodesMap?.[BlockEnum.AgentV2]?.metaData.helpLinkUri).toBe(
-      '/docs/use-dify/nodes/agent#choose-an-agent',
+      '/docs/use-dify/nodes/agent#new-agent',
     )
   })
 
@@ -115,7 +115,7 @@ describe('useAvailableNodesMetaData', () => {
     expect(result.current.nodesMap?.[BlockEnum.Agent]).toBeDefined()
     expect(result.current.nodesMap?.[BlockEnum.AgentV2]).toBeDefined()
     expect(result.current.nodesMap?.[BlockEnum.Agent]?.metaData.helpLinkUri).toBe(
-      '/docs/use-dify/nodes/agent',
+      '/docs/use-dify/nodes/agent#classic-agent',
     )
   })
 })
diff --git a/web/app/components/workflow/nodes/agent-v2/__tests__/default.spec.ts b/web/app/components/workflow/nodes/agent-v2/__tests__/default.spec.ts
index 1e881a1ad98..57692f574d3 100644
--- a/web/app/components/workflow/nodes/agent-v2/__tests__/default.spec.ts
+++ b/web/app/components/workflow/nodes/agent-v2/__tests__/default.spec.ts
@@ -113,7 +113,7 @@ describe('agent/default', () => {
   })
 
   it('links directly to the New Agent section of the shared agent node document', () => {
-    expect(nodeDefault.metaData.helpLinkUri).toBe('agent#choose-an-agent')
+    expect(nodeDefault.metaData.helpLinkUri).toBe('agent#new-agent')
   })
 
   it('identifies version 2 agent data as Agent v2', () => {
diff --git a/web/app/components/workflow/nodes/agent-v2/default.ts b/web/app/components/workflow/nodes/agent-v2/default.ts
index 342c8361725..f7a8383e0a7 100644
--- a/web/app/components/workflow/nodes/agent-v2/default.ts
+++ b/web/app/components/workflow/nodes/agent-v2/default.ts
@@ -8,7 +8,7 @@ import { hasValidAgentBinding } from './types'
 const metaData = genNodeMetaData({
   sort: 3,
   type: BlockEnum.AgentV2,
-  helpLinkUri: 'agent#choose-an-agent',
+  helpLinkUri: 'agent#new-agent',
 })
 
 const nodeDefault: NodeDefault<AgentV2NodeType> = {
diff --git a/web/app/components/workflow/nodes/agent/default.ts b/web/app/components/workflow/nodes/agent/default.ts
index c011c7c19de..2ae8493d2b3 100644
--- a/web/app/components/workflow/nodes/agent/default.ts
+++ b/web/app/components/workflow/nodes/agent/default.ts
@@ -10,6 +10,7 @@ import { genNodeMetaData } from '../../utils'
 const metaData = genNodeMetaData({
   sort: 3,
   type: BlockEnum.Agent,
+  helpLinkUri: 'agent#classic-agent',
 })
 
 const nodeDefault: NodeDefault<AgentNodeType> = {