Centralized management of external links (#4471)

Update the desktop guide links to make them platform and locale-aware

Edited by Terry:
Refactor external link management by introducing a centralized
useExternalLink composable with automatic locale and platform detection
for documentation URLs.

- Created useExternalLink composable - A new centralized utility for
managing all external links
- Dynamic docs URL builder (buildDocsUrl) - Automatically constructs
docs.comfy.org URLs with:
  - Locale detection (Chinese vs English)
  - Platform detection (macOS vs Windows for desktop)
  - Flexible path construction with options

┆Issue is synchronized with this [Notion
page](https://www.notion.so/PR-4471-Add-platform-and-locale-aware-desktop-guide-URL-2346d73d3650815ea4a4dd64be575bbe)
by [Unito](https://www.unito.io)

---------

Co-authored-by: Terry Jia <terryjia88@gmail.com>
This commit is contained in:
ComfyUI Wiki
2025-11-14 13:35:28 +08:00
committed by GitHub
parent 1a6913c466
commit b347dd1734
17 changed files with 361 additions and 83 deletions

View File

@@ -1,6 +1,7 @@
import { useCurrentUser } from '@/composables/auth/useCurrentUser'
import { useFirebaseAuthActions } from '@/composables/auth/useFirebaseAuthActions'
import { useSelectedLiteGraphItems } from '@/composables/canvas/useSelectedLiteGraphItems'
import { useExternalLink } from '@/composables/useExternalLink'
import { useModelSelectorDialog } from '@/composables/useModelSelectorDialog'
import {
DEFAULT_DARK_COLOR_PALETTE,
@@ -76,6 +77,7 @@ export function useCoreCommands(): ComfyCommand[] {
const canvasStore = useCanvasStore()
const executionStore = useExecutionStore()
const telemetry = useTelemetry()
const { staticUrls, buildDocsUrl } = useExternalLink()
const bottomPanelStore = useBottomPanelStore()
@@ -761,10 +763,7 @@ export function useCoreCommands(): ComfyCommand[] {
is_external: true,
source: 'menu'
})
window.open(
'https://github.com/comfyanonymous/ComfyUI/issues',
'_blank'
)
window.open(staticUrls.githubIssues, '_blank')
}
},
{
@@ -779,7 +778,7 @@ export function useCoreCommands(): ComfyCommand[] {
is_external: true,
source: 'menu'
})
window.open('https://docs.comfy.org/', '_blank')
window.open(buildDocsUrl('/', { includeLocale: true }), '_blank')
}
},
{
@@ -794,7 +793,7 @@ export function useCoreCommands(): ComfyCommand[] {
is_external: true,
source: 'menu'
})
window.open('https://www.comfy.org/discord', '_blank')
window.open(staticUrls.discord, '_blank')
}
},
{
@@ -861,7 +860,7 @@ export function useCoreCommands(): ComfyCommand[] {
is_external: true,
source: 'menu'
})
window.open('https://forum.comfy.org/', '_blank')
window.open(staticUrls.forum, '_blank')
}
},
{