Merge branch 'feature/node-replacement-classify' into feature/node-replacement-ui

2026-04-20 06:20:11 +00:00 · 2026-02-05 15:16:30 +09:00
parent 513dd0e426 52a46e72c9
commit 3b3430e2d8
46 changed files with 938 additions and 234 deletions
--- a/.coderabbit.yaml
+++ b/.coderabbit.yaml
@@ -2,5 +2,6 @@ issue_enrichment:
  auto_enrich:
    enabled: true
 reviews:
+  high_level_summary: false
  auto_review:
    drafts: true
--- a/browser_tests/fixtures/components/ComfyNodeSearchBox.ts
+++ b/browser_tests/fixtures/components/ComfyNodeSearchBox.ts
@@ -80,4 +80,11 @@ export class ComfyNodeSearchBox {
  async removeFilter(index: number) {
    await this.filterChips.nth(index).locator('.p-chip-remove-icon').click()
  }
+
+  /**
+   * Returns a locator for a search result containing the specified text.
+   */
+  findResult(text: string): Locator {
+    return this.dropdown.locator('li').filter({ hasText: text })
+  }
 }
--- a/browser_tests/fixtures/helpers/CommandHelper.ts
+++ b/browser_tests/fixtures/helpers/CommandHelper.ts
@@ -5,10 +5,18 @@ import type { KeyCombo } from '../../../src/platform/keybindings/types'
 export class CommandHelper {
  constructor(private readonly page: Page) {}

-  async executeCommand(commandId: string): Promise<void> {
-    await this.page.evaluate((id: string) => {
-      return window.app!.extensionManager.command.execute(id)
-    }, commandId)
+  async executeCommand(
+    commandId: string,
+    metadata?: Record<string, unknown>
+  ): Promise<void> {
+    await this.page.evaluate(
+      ({ commandId, metadata }) => {
+        return window['app'].extensionManager.command.execute(commandId, {
+          metadata
+        })
+      },
+      { commandId, metadata }
+    )
  }

  async registerCommand(
--- a/browser_tests/tests/subgraphSearchAliases.spec.ts
+++ b/browser_tests/tests/subgraphSearchAliases.spec.ts
@@ -0,0 +1,109 @@
+import { expect } from '@playwright/test'
+
+import type { ComfyPage } from '../fixtures/ComfyPage'
+import { comfyPageFixture as test } from '../fixtures/ComfyPage'
+
+async function createSubgraphAndNavigateInto(comfyPage: ComfyPage) {
+  await comfyPage.workflow.loadWorkflow('default')
+  await comfyPage.nextFrame()
+
+  const ksampler = await comfyPage.nodeOps.getNodeRefById('3')
+  await ksampler.click('title')
+  await ksampler.convertToSubgraph()
+  await comfyPage.nextFrame()
+
+  const subgraphNodes =
+    await comfyPage.nodeOps.getNodeRefsByTitle('New Subgraph')
+  expect(subgraphNodes.length).toBe(1)
+  const subgraphNode = subgraphNodes[0]
+
+  await subgraphNode.navigateIntoSubgraph()
+  return subgraphNode
+}
+
+async function exitSubgraphAndPublish(
+  comfyPage: ComfyPage,
+  subgraphNode: Awaited<ReturnType<typeof createSubgraphAndNavigateInto>>,
+  blueprintName: string
+) {
+  await comfyPage.page.keyboard.press('Escape')
+  await comfyPage.nextFrame()
+
+  await subgraphNode.click('title')
+  await comfyPage.command.executeCommand('Comfy.PublishSubgraph', {
+    name: blueprintName
+  })
+
+  await expect(comfyPage.visibleToasts).toHaveCount(1, { timeout: 5000 })
+  await comfyPage.toast.closeToasts(1)
+}
+
+async function searchAndExpectResult(
+  comfyPage: ComfyPage,
+  searchTerm: string,
+  expectedResult: string
+) {
+  await comfyPage.command.executeCommand('Workspace.SearchBox.Toggle')
+  await expect(comfyPage.searchBox.input).toHaveCount(1)
+  await comfyPage.searchBox.input.fill(searchTerm)
+  await expect(comfyPage.searchBox.findResult(expectedResult)).toBeVisible({
+    timeout: 10000
+  })
+}
+
+test.describe('Subgraph Search Aliases', { tag: ['@subgraph'] }, () => {
+  test.beforeEach(async ({ comfyPage }) => {
+    await comfyPage.settings.setSetting('Comfy.UseNewMenu', 'Top')
+    await comfyPage.settings.setSetting('Comfy.NodeSearchBoxImpl', 'default')
+  })
+
+  test('Can set search aliases on subgraph and find via search', async ({
+    comfyPage
+  }) => {
+    const subgraphNode = await createSubgraphAndNavigateInto(comfyPage)
+
+    await comfyPage.command.executeCommand('Comfy.Subgraph.SetSearchAliases', {
+      aliases: 'qwerty,unicorn'
+    })
+
+    const blueprintName = `test-aliases-${Date.now()}`
+    await exitSubgraphAndPublish(comfyPage, subgraphNode, blueprintName)
+    await searchAndExpectResult(comfyPage, 'unicorn', blueprintName)
+  })
+
+  test('Can set description on subgraph', async ({ comfyPage }) => {
+    await createSubgraphAndNavigateInto(comfyPage)
+
+    await comfyPage.command.executeCommand('Comfy.Subgraph.SetDescription', {
+      description: 'This is a test description'
+    })
+    // Verify the description was set on the subgraph's extra
+    const description = await comfyPage.page.evaluate(() => {
+      const subgraph = window['app']!.canvas.subgraph
+      return (subgraph?.extra as Record<string, unknown>)?.BlueprintDescription
+    })
+    expect(description).toBe('This is a test description')
+  })
+
+  test('Search aliases persist after publish and reload', async ({
+    comfyPage
+  }) => {
+    const subgraphNode = await createSubgraphAndNavigateInto(comfyPage)
+
+    await comfyPage.command.executeCommand('Comfy.Subgraph.SetSearchAliases', {
+      aliases: 'dragon, fire breather'
+    })
+
+    const blueprintName = `test-persist-${Date.now()}`
+    await exitSubgraphAndPublish(comfyPage, subgraphNode, blueprintName)
+
+    // Reload the page to ensure aliases are persisted
+    await comfyPage.page.reload()
+    await comfyPage.page.waitForFunction(
+      () => window['app'] && window['app'].extensionManager
+    )
+    await comfyPage.nextFrame()
+
+    await searchAndExpectResult(comfyPage, 'dragon', blueprintName)
+  })
+})
--- a/manifest.json
+++ b/manifest.json
@@ -10,7 +10,5 @@
      "type": "image/svg+xml"
    }
  ],
-  "display": "standalone",
-  "background_color": "#172dd7",
-  "theme_color": "#f0ff41"
+  "display": "standalone"
 }
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@comfyorg/comfyui-frontend",
-  "version": "1.39.6",
+  "version": "1.39.7",
  "private": true,
  "description": "Official front-end implementation of ComfyUI",
  "homepage": "https://comfy.org",
--- a/src/components/ui/select/SelectContent.vue
+++ b/src/components/ui/select/SelectContent.vue
@@ -20,9 +20,18 @@ defineOptions({

 const {
  position = 'popper',
+  // Safari has issues with click events on portaled content inside dialogs.
+  // Set disablePortal to true when using Select inside a Dialog on Safari.
+  // See: https://github.com/chakra-ui/ark/issues/1782
+  disablePortal = false,
  class: className,
  ...restProps
-} = defineProps<SelectContentProps & { class?: HTMLAttributes['class'] }>()
+} = defineProps<
+  SelectContentProps & {
+    class?: HTMLAttributes['class']
+    disablePortal?: boolean
+  }
+>()
 const emits = defineEmits<SelectContentEmits>()

 const delegatedProps = computed(() => ({
@@ -34,7 +43,7 @@ const forwarded = useForwardPropsEmits(delegatedProps, emits)
 </script>

 <template>
-  <SelectPortal>
+  <SelectPortal :disabled="disablePortal">
    <SelectContent
      v-bind="{ ...forwarded, ...$attrs }"
      :class="
--- a/src/composables/useCoreCommands.test.ts
+++ b/src/composables/useCoreCommands.test.ts
@@ -68,8 +68,11 @@ vi.mock('@/platform/workflow/core/services/workflowService', () => ({
  useWorkflowService: vi.fn(() => ({}))
 }))

+const mockDialogService = vi.hoisted(() => ({
+  prompt: vi.fn()
+}))
 vi.mock('@/services/dialogService', () => ({
-  useDialogService: vi.fn(() => ({}))
+  useDialogService: vi.fn(() => mockDialogService)
 }))

 vi.mock('@/services/litegraphService', () => ({
@@ -84,14 +87,31 @@ vi.mock('@/stores/toastStore', () => ({
  useToastStore: vi.fn(() => ({}))
 }))

+const mockChangeTracker = vi.hoisted(() => ({
+  checkState: vi.fn()
+}))
+const mockWorkflowStore = vi.hoisted(() => ({
+  activeWorkflow: {
+    changeTracker: mockChangeTracker
+  }
+}))
 vi.mock('@/platform/workflow/management/stores/workflowStore', () => ({
-  useWorkflowStore: vi.fn(() => ({}))
+  useWorkflowStore: vi.fn(() => mockWorkflowStore)
 }))

 vi.mock('@/stores/subgraphStore', () => ({
  useSubgraphStore: vi.fn(() => ({}))
 }))

+vi.mock('@/renderer/core/canvas/canvasStore', () => ({
+  useCanvasStore: vi.fn(() => ({
+    getCanvas: () => app.canvas
+  })),
+  useTitleEditorStore: vi.fn(() => ({
+    titleEditorTarget: null
+  }))
+}))
+
 vi.mock('@/stores/workspace/colorPaletteStore', () => ({
  useColorPaletteStore: vi.fn(() => ({}))
 }))
@@ -155,11 +175,12 @@ describe('useCoreCommands', () => {
      findNodeById: vi.fn(),
      getNodeById: vi.fn(),
      setDirtyCanvas: vi.fn(),
-      sendActionToCanvas: vi.fn()
+      sendActionToCanvas: vi.fn(),
+      extra: {} as Record<string, unknown>
    } as Partial<typeof app.canvas.subgraph> as typeof app.canvas.subgraph
  }

-  const mockSubgraph = createMockSubgraph()
+  const mockSubgraph = createMockSubgraph()!

  function createMockSettingStore(
    getReturnValue: boolean
@@ -270,4 +291,138 @@ describe('useCoreCommands', () => {
      expect(api.dispatchCustomEvent).not.toHaveBeenCalled()
    })
  })
+
+  describe('Subgraph metadata commands', () => {
+    beforeEach(() => {
+      mockSubgraph.extra = {}
+      vi.clearAllMocks()
+    })
+
+    describe('SetDescription command', () => {
+      it('should do nothing when not in subgraph', async () => {
+        app.canvas.subgraph = undefined
+
+        const commands = useCoreCommands()
+        const setDescCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetDescription'
+        )!
+
+        await setDescCommand.function()
+
+        expect(mockDialogService.prompt).not.toHaveBeenCalled()
+      })
+
+      it('should set description on subgraph.extra', async () => {
+        app.canvas.subgraph = mockSubgraph
+        mockDialogService.prompt.mockResolvedValue('Test description')
+
+        const commands = useCoreCommands()
+        const setDescCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetDescription'
+        )!
+
+        await setDescCommand.function()
+
+        expect(mockDialogService.prompt).toHaveBeenCalled()
+        expect(mockSubgraph.extra.BlueprintDescription).toBe('Test description')
+        expect(mockChangeTracker.checkState).toHaveBeenCalled()
+      })
+
+      it('should not set description when user cancels', async () => {
+        app.canvas.subgraph = mockSubgraph
+        mockDialogService.prompt.mockResolvedValue(null)
+
+        const commands = useCoreCommands()
+        const setDescCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetDescription'
+        )!
+
+        await setDescCommand.function()
+
+        expect(mockSubgraph.extra.BlueprintDescription).toBeUndefined()
+        expect(mockChangeTracker.checkState).not.toHaveBeenCalled()
+      })
+    })
+
+    describe('SetSearchAliases command', () => {
+      it('should do nothing when not in subgraph', async () => {
+        app.canvas.subgraph = undefined
+
+        const commands = useCoreCommands()
+        const setAliasesCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetSearchAliases'
+        )!
+
+        await setAliasesCommand.function()
+
+        expect(mockDialogService.prompt).not.toHaveBeenCalled()
+      })
+
+      it('should set search aliases on subgraph.extra', async () => {
+        app.canvas.subgraph = mockSubgraph
+        mockDialogService.prompt.mockResolvedValue('alias1, alias2, alias3')
+
+        const commands = useCoreCommands()
+        const setAliasesCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetSearchAliases'
+        )!
+
+        await setAliasesCommand.function()
+
+        expect(mockDialogService.prompt).toHaveBeenCalled()
+        expect(mockSubgraph.extra.BlueprintSearchAliases).toEqual([
+          'alias1',
+          'alias2',
+          'alias3'
+        ])
+        expect(mockChangeTracker.checkState).toHaveBeenCalled()
+      })
+
+      it('should trim whitespace and filter empty strings', async () => {
+        app.canvas.subgraph = mockSubgraph
+        mockDialogService.prompt.mockResolvedValue('  alias1  ,  , alias2 ,  ')
+
+        const commands = useCoreCommands()
+        const setAliasesCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetSearchAliases'
+        )!
+
+        await setAliasesCommand.function()
+
+        expect(mockSubgraph.extra.BlueprintSearchAliases).toEqual([
+          'alias1',
+          'alias2'
+        ])
+      })
+
+      it('should set undefined when empty input', async () => {
+        app.canvas.subgraph = mockSubgraph
+        mockDialogService.prompt.mockResolvedValue('')
+
+        const commands = useCoreCommands()
+        const setAliasesCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetSearchAliases'
+        )!
+
+        await setAliasesCommand.function()
+
+        expect(mockSubgraph.extra.BlueprintSearchAliases).toBeUndefined()
+      })
+
+      it('should not set aliases when user cancels', async () => {
+        app.canvas.subgraph = mockSubgraph
+        mockDialogService.prompt.mockResolvedValue(null)
+
+        const commands = useCoreCommands()
+        const setAliasesCommand = commands.find(
+          (cmd) => cmd.id === 'Comfy.Subgraph.SetSearchAliases'
+        )!
+
+        await setAliasesCommand.function()
+
+        expect(mockSubgraph.extra.BlueprintSearchAliases).toBeUndefined()
+        expect(mockChangeTracker.checkState).not.toHaveBeenCalled()
+      })
+    })
+  })
 })
--- a/src/composables/useCoreCommands.ts
+++ b/src/composables/useCoreCommands.ts
@@ -171,8 +171,9 @@ export function useCoreCommands(): ComfyCommand[] {
      icon: 'pi pi-save',
      label: 'Publish Subgraph',
      menubarLabel: 'Publish',
-      function: async () => {
-        await useSubgraphStore().publishSubgraph()
+      function: async (metadata?: Record<string, unknown>) => {
+        const name = metadata?.name as string | undefined
+        await useSubgraphStore().publishSubgraph(name)
      }
    },
    {
@@ -1095,6 +1096,75 @@ export function useCoreCommands(): ComfyCommand[] {
        )
      }
    },
+    {
+      id: 'Comfy.Subgraph.SetDescription',
+      icon: 'pi pi-pencil',
+      label: 'Set Subgraph Description',
+      versionAdded: '1.39.7',
+      function: async (metadata?: Record<string, unknown>) => {
+        const canvas = canvasStore.getCanvas()
+        const subgraph = canvas.subgraph
+        if (!subgraph) return
+
+        const extra = (subgraph.extra ??= {}) as Record<string, unknown>
+        const currentDescription = (extra.BlueprintDescription as string) ?? ''
+
+        let description: string | null | undefined
+        const rawDescription = metadata?.description
+        if (rawDescription != null) {
+          description =
+            typeof rawDescription === 'string'
+              ? rawDescription
+              : String(rawDescription)
+        }
+        description ??= await dialogService.prompt({
+          title: t('g.description'),
+          message: t('subgraphStore.enterDescription'),
+          defaultValue: currentDescription
+        })
+        if (description === null) return
+
+        extra.BlueprintDescription = description.trim() || undefined
+        workflowStore.activeWorkflow?.changeTracker?.checkState()
+      }
+    },
+    {
+      id: 'Comfy.Subgraph.SetSearchAliases',
+      icon: 'pi pi-search',
+      label: 'Set Subgraph Search Aliases',
+      versionAdded: '1.39.7',
+      function: async (metadata?: Record<string, unknown>) => {
+        const canvas = canvasStore.getCanvas()
+        const subgraph = canvas.subgraph
+        if (!subgraph) return
+
+        const parseAliases = (value: unknown): string[] =>
+          (Array.isArray(value) ? value.map(String) : String(value).split(','))
+            .map((s) => s.trim())
+            .filter(Boolean)
+
+        const extra = (subgraph.extra ??= {}) as Record<string, unknown>
+
+        let aliases: string[]
+        const rawAliases = metadata?.aliases
+        if (rawAliases == null) {
+          const input = await dialogService.prompt({
+            title: t('subgraphStore.searchAliases'),
+            message: t('subgraphStore.enterSearchAliases'),
+            defaultValue: parseAliases(extra.BlueprintSearchAliases ?? '').join(
+              ', '
+            )
+          })
+          if (input === null) return
+          aliases = parseAliases(input)
+        } else {
+          aliases = parseAliases(rawAliases)
+        }
+
+        extra.BlueprintSearchAliases = aliases.length > 0 ? aliases : undefined
+        workflowStore.activeWorkflow?.changeTracker?.checkState()
+      }
+    },
    {
      id: 'Comfy.Dev.ShowModelSelector',
      icon: 'pi pi-box',
--- a/src/lib/litegraph/src/contextMenuCompat.test.ts
+++ b/src/lib/litegraph/src/contextMenuCompat.test.ts
@@ -195,6 +195,42 @@ describe('contextMenuCompat', () => {
        expect.any(Error)
      )
    })
+
+    it('should handle multiple items with undefined content correctly', () => {
+      // Setup base method with items that have undefined content
+      LGraphCanvas.prototype.getCanvasMenuOptions = function () {
+        return [
+          { content: undefined, title: 'Separator 1' },
+          { content: undefined, title: 'Separator 2' },
+          { content: 'Item 1', callback: () => {} }
+        ]
+      }
+
+      legacyMenuCompat.install(LGraphCanvas.prototype, 'getCanvasMenuOptions')
+
+      // Monkey-patch to add an item with undefined content
+      const original = LGraphCanvas.prototype.getCanvasMenuOptions
+      LGraphCanvas.prototype.getCanvasMenuOptions =
+        function (): (IContextMenuValue | null)[] {
+          const items = original.apply(this)
+          items.push({ content: undefined, title: 'Separator 3' })
+          return items
+        }
+
+      // Extract legacy items
+      const legacyItems = legacyMenuCompat.extractLegacyItems(
+        'getCanvasMenuOptions',
+        mockCanvas
+      )
+
+      // Should extract only the newly added item with undefined content
+      // (not collapse with existing undefined content items)
+      expect(legacyItems).toHaveLength(1)
+      expect(legacyItems[0]).toMatchObject({
+        content: undefined,
+        title: 'Separator 3'
+      })
+    })
  })

  describe('integration', () => {
--- a/src/lib/litegraph/src/contextMenuCompat.ts
+++ b/src/lib/litegraph/src/contextMenuCompat.ts
@@ -152,19 +152,51 @@ class LegacyMenuCompat {
      const patchedItems = methodToCall.apply(context, args) as
        | (IContextMenuValue | null)[]
        | undefined
-      if (!patchedItems) return []
+      if (!patchedItems) {
+        return []
+      }
+      // Use content-based diff to detect additions (not reference-based)
+      // Create composite keys from multiple properties to handle undefined content
+      const createItemKey = (item: IContextMenuValue): string => {
+        const parts = [
+          item.content ?? '',
+          item.title ?? '',
+          item.className ?? '',
+          item.property ?? '',
+          item.type ?? ''
+        ]
+        return parts.join('|')
+      }

-      // Use set-based diff to detect additions by reference
-      const originalSet = new Set<IContextMenuValue | null>(originalItems)
-      const addedItems = patchedItems.filter((item) => !originalSet.has(item))
+      const originalKeys = new Set(
+        originalItems
+          .filter(
+            (item): item is IContextMenuValue =>
+              item !== null && typeof item === 'object' && 'content' in item
+          )
+          .map(createItemKey)
+      )
+      const addedItems = patchedItems.filter((item) => {
+        if (item === null) return false
+        if (typeof item !== 'object' || !('content' in item)) return false
+        return !originalKeys.has(createItemKey(item))
+      })

      // Warn if items were removed (patched has fewer original items than expected)
-      const retainedOriginalCount = patchedItems.filter((item) =>
-        originalSet.has(item)
+      const patchedKeys = new Set(
+        patchedItems
+          .filter(
+            (item): item is IContextMenuValue =>
+              item !== null && typeof item === 'object' && 'content' in item
+          )
+          .map(createItemKey)
+      )
+      const removedCount = [...originalKeys].filter(
+        (key) => !patchedKeys.has(key)
      ).length
-      if (retainedOriginalCount < originalItems.length) {
+      if (removedCount > 0) {
        console.warn(
-          `[Context Menu Compat] Monkey patch for ${methodName} removed ${originalItems.length - retainedOriginalCount} original menu item(s). ` +
+          `[Context Menu Compat] Monkey patch for ${methodName} removed ${removedCount} original menu item(s). ` +
            `This may cause unexpected behavior.`
        )
      }
--- a/src/locales/ar/commands.json
+++ b/src/locales/ar/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "إعادة التشغيل"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "فتح عارض ثلاثي الأبعاد (بيتا) للعقدة المحددة"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "تجريبي: تصفح أصول النماذج"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "عرض نافذة الإعدادات"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "تعيين وصف الرسم البياني الفرعي"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "تعيين الأسماء المستعارة للبحث في الرسم البياني الفرعي"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "تجريبي: تمكين AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "تبديل اللوحة السفلية"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "تبديل لوحة الطرفية السفلية"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "تبديل لوحة السجلات السفلية"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "تبديل اللوحة السفلية الأساسية"
  },
--- a/src/locales/ar/main.json
+++ b/src/locales/ar/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "تدوير لليمين في محرر القناع",
    "Save": "حفظ",
    "Save As": "حفظ باسم",
+    "Set Subgraph Description": "تعيين وصف المخطط الفرعي",
+    "Set Subgraph Search Aliases": "تعيين الأسماء المستعارة للبحث في المخطط الفرعي",
    "Show Keybindings Dialog": "عرض مربع حوار اختصارات لوحة المفاتيح",
    "Show Model Selector (Dev)": "إظهار منتقي النماذج (للمطورين)",
    "Show Settings Dialog": "عرض نافذة الإعدادات",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "لا يمكن حذف المخططات المثبتة",
    "confirmDelete": "سيؤدي هذا الإجراء إلى إزالة المخطط نهائيًا من مكتبتك",
    "confirmDeleteTitle": "حذف المخطط؟",
+    "enterDescription": "أدخل وصفًا",
+    "enterSearchAliases": "أدخل الأسماء المستعارة للبحث (مفصولة بفواصل)",
    "hidden": "معاملات مخفية / متداخلة",
    "hideAll": "إخفاء الكل",
    "loadFailure": "فشل تحميل مخططات الرسم البياني الفرعي",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "تم الحفظ في مكتبة العقد",
    "publishSuccessMessage": "يمكنك العثور على مخطط الرسم البياني الفرعي الخاص بك في مكتبة العقد ضمن \"مخططات الرسم البياني الفرعي\"",
    "saveBlueprint": "احفظ المخطط الفرعي في المكتبة",
+    "searchAliases": "بحث عن الأسماء المستعارة",
    "showAll": "إظهار الكل",
    "showRecommended": "إظهار العناصر الموصى بها",
    "shown": "معروض على العقدة"
--- a/src/locales/en/commands.json
+++ b/src/locales/en/commands.json
@@ -263,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "Show Settings Dialog"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "Set Subgraph Description"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "Set Subgraph Search Aliases"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "Experimental: Enable AssetAPI"
  },
--- a/src/locales/en/main.json
+++ b/src/locales/en/main.json
@@ -1030,7 +1030,10 @@
    "hidden": "Hidden / nested parameters",
    "hideAll": "Hide all",
    "showRecommended": "Show recommended widgets",
-    "cannotDeleteGlobal": "Cannot delete installed blueprints"
+    "cannotDeleteGlobal": "Cannot delete installed blueprints",
+    "enterDescription": "Enter a description",
+    "searchAliases": "Search Aliases",
+    "enterSearchAliases": "Enter search aliases (comma separated)"
  },
  "electronFileDownload": {
    "inProgress": "In Progress",
@@ -1247,6 +1250,8 @@
    "Save": "Save",
    "Save As": "Save As",
    "Show Settings Dialog": "Show Settings Dialog",
+    "Set Subgraph Description": "Set Subgraph Description",
+    "Set Subgraph Search Aliases": "Set Subgraph Search Aliases",
    "Experimental: Enable AssetAPI": "Experimental: Enable AssetAPI",
    "Canvas Performance": "Canvas Performance",
    "Help Center": "Help Center",
--- a/src/locales/en/nodeDefs.json
+++ b/src/locales/en/nodeDefs.json
@@ -6104,6 +6104,10 @@
      "5": {
        "name": "recording_video",
        "tooltip": null
+      },
+      "6": {
+        "name": "model_3d",
+        "tooltip": null
      }
    }
  },
@@ -12541,11 +12545,11 @@
    }
  },
  "SaveGLB": {
-    "display_name": "SaveGLB",
+    "display_name": "Save 3D Model",
    "inputs": {
      "mesh": {
        "name": "mesh",
-        "tooltip": "Mesh or GLB file to save"
+        "tooltip": "Mesh or 3D file to save"
      },
      "filename_prefix": {
        "name": "filename_prefix"
--- a/src/locales/es/commands.json
+++ b/src/locales/es/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "Reiniciar"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "Abrir visor 3D (Beta) para el nodo seleccionado"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "Experimental: Explorar recursos de modelos"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "Mostrar Diálogo de Configuraciones"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "Establecer descripción del subgrafo"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "Establecer alias de búsqueda del subgrafo"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "Experimental: Habilitar AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "Alternar Panel Inferior"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "Alternar Panel Inferior de Terminal"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "Alternar Panel Inferior de Registros"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "Alternar panel inferior esencial"
  },
--- a/src/locales/es/main.json
+++ b/src/locales/es/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "Girar a la derecha en el editor de máscaras",
    "Save": "Guardar",
    "Save As": "Guardar como",
+    "Set Subgraph Description": "Establecer descripción del subgrafo",
+    "Set Subgraph Search Aliases": "Establecer alias de búsqueda del subgrafo",
    "Show Keybindings Dialog": "Mostrar diálogo de combinaciones de teclas",
    "Show Model Selector (Dev)": "Mostrar selector de modelo (Desarrollo)",
    "Show Settings Dialog": "Mostrar diálogo de configuración",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "No se pueden eliminar los blueprints instalados",
    "confirmDelete": "Esta acción eliminará permanentemente el subgrafo de tu biblioteca",
    "confirmDeleteTitle": "¿Eliminar subgrafo?",
+    "enterDescription": "Introduce una descripción",
+    "enterSearchAliases": "Introduce alias de búsqueda (separados por comas)",
    "hidden": "Parámetros ocultos/anidados",
    "hideAll": "Ocultar todo",
    "loadFailure": "No se pudieron cargar los subgrafos",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "Guardado en la biblioteca de nodos",
    "publishSuccessMessage": "Puedes encontrar tu subgrafo en la biblioteca de nodos bajo \"Subgraph Blueprints\"",
    "saveBlueprint": "Guardar subgrafo en la biblioteca",
+    "searchAliases": "Buscar alias",
    "showAll": "Mostrar todo",
    "showRecommended": "Mostrar widgets recomendados",
    "shown": "Mostrado en el nodo"
--- a/src/locales/fa/commands.json
+++ b/src/locales/fa/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "راه‌اندازی مجدد"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "باز کردن ۳D Viewer (بتا) برای node انتخاب‌شده"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "آزمایشی: مرور Model Assets"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "نمایش پنجره تنظیمات"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "تنظیم توضیحات زیرگراف"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "تنظیم نام‌های جایگزین جستجوی زیرگراف"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "آزمایشی: فعال‌سازی AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "تغییر پنل پایین"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "تغییر پنل ترمینال پایین"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "تغییر پنل گزارش‌ها پایین"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "تغییر پنل ضروریات پایین"
  },
--- a/src/locales/fa/main.json
+++ b/src/locales/fa/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "چرخش به راست در MaskEditor",
    "Save": "ذخیره",
    "Save As": "ذخیره به عنوان",
+    "Set Subgraph Description": "تنظیم توضیح زیرگراف",
+    "Set Subgraph Search Aliases": "تنظیم نام‌های مستعار جستجوی زیرگراف",
    "Show Keybindings Dialog": "نمایش پنجره کلیدهای میانبر",
    "Show Model Selector (Dev)": "نمایش انتخاب‌گر مدل (توسعه‌دهنده)",
    "Show Settings Dialog": "نمایش پنجره تنظیمات",
@@ -2435,6 +2437,8 @@
    "cannotDeleteGlobal": "امکان حذف blueprints نصب‌شده وجود ندارد",
    "confirmDelete": "این عمل باعث حذف دائمی بلوپرینت از کتابخانه شما می‌شود",
    "confirmDeleteTitle": "حذف بلوپرینت؟",
+    "enterDescription": "توضیحی وارد کنید",
+    "enterSearchAliases": "نام‌های مستعار جستجو را وارد کنید (با ویرگول جدا کنید)",
    "hidden": "پارامترهای مخفی / تو در تو",
    "hideAll": "مخفی‌سازی همه",
    "loadFailure": "بارگذاری بلوپرینت‌های زیرگراف ناموفق بود",
@@ -2445,6 +2449,7 @@
    "publishSuccess": "در کتابخانه گره‌ها ذخیره شد",
    "publishSuccessMessage": "می‌توانید بلوپرینت زیرگراف خود را در کتابخانه گره‌ها در بخش \"بلوپرینت‌های زیرگراف\" پیدا کنید",
    "saveBlueprint": "ذخیره زیرگراف در کتابخانه",
+    "searchAliases": "جستجوی نام‌های مستعار",
    "showAll": "نمایش همه",
    "showRecommended": "نمایش ویجت‌های پیشنهادی",
    "shown": "نمایش روی گره"
--- a/src/locales/fa/nodeDefs.json
+++ b/src/locales/fa/nodeDefs.json
@@ -6427,9 +6427,7 @@
  "Load3D": {
    "display_name": "بارگذاری ۳بعدی و انیمیشن",
    "inputs": {
-      "clear": {
-        "": "پاک‌سازی"
-      },
+      "clear": {},
      "height": {
        "name": "ارتفاع"
      },
@@ -6439,42 +6437,24 @@
      "model_file": {
        "name": "فایل مدل"
      },
-      "upload 3d model": {
-        "": "بارگذاری مدل سه‌بعدی"
-      },
-      "upload extra resources": {
-        "": "بارگذاری منابع اضافی"
-      },
+      "upload 3d model": {},
+      "upload extra resources": {},
      "width": {
        "name": "عرض"
      }
    },
-    "outputs": {
-      "0": {
-        "name": "تصویر",
-        "tooltip": null
-      },
-      "1": {
-        "name": "ماسک",
-        "tooltip": null
-      },
-      "2": {
-        "name": "مسیر مش",
-        "tooltip": null
-      },
-      "3": {
-        "name": "نرمال",
-        "tooltip": null
-      },
-      "4": {
-        "name": "اطلاعات دوربین",
-        "tooltip": null
-      },
-      "5": {
-        "name": "ویدئوی ضبط‌شده",
+    "outputs": [
+      null,
+      null,
+      null,
+      null,
+      null,
+      null,
+      {
+        "name": "مدل_۳بعدی",
        "tooltip": null
      }
-    }
+    ]
  },
  "LoadAudio": {
    "display_name": "بارگذاری صوت",
--- a/src/locales/fr/commands.json
+++ b/src/locales/fr/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "Redémarrer"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "Ouvrir le visualiseur 3D (bêta) pour le nœud sélectionné"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "Expérimental : Parcourir les ressources de modèles"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "Afficher la boîte de dialogue des paramètres"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "Définir la description du sous-graphe"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "Définir les alias de recherche du sous-graphe"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "Expérimental : Activer AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "Basculer le panneau inférieur"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "Basculer le panneau inférieur du terminal"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "Basculer le panneau inférieur des journaux"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "Afficher/Masquer le panneau inférieur essentiel"
  },
--- a/src/locales/fr/main.json
+++ b/src/locales/fr/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "Tourner à droite dans l'éditeur de masque",
    "Save": "Enregistrer",
    "Save As": "Enregistrer sous",
+    "Set Subgraph Description": "Définir la description du sous-graphe",
+    "Set Subgraph Search Aliases": "Définir les alias de recherche du sous-graphe",
    "Show Keybindings Dialog": "Afficher la boîte de dialogue des raccourcis clavier",
    "Show Model Selector (Dev)": "Afficher le sélecteur de modèle (Dev)",
    "Show Settings Dialog": "Afficher la boîte de dialogue des paramètres",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "Impossible de supprimer les blueprints installés",
    "confirmDelete": "Cette action supprimera définitivement le plan de votre bibliothèque",
    "confirmDeleteTitle": "Supprimer le plan ?",
+    "enterDescription": "Saisissez une description",
+    "enterSearchAliases": "Saisissez des alias de recherche (séparés par des virgules)",
    "hidden": "Paramètres cachés / imbriqués",
    "hideAll": "Tout masquer",
    "loadFailure": "Échec du chargement des plans de sous-graphes",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "Enregistré dans la bibliothèque de nœuds",
    "publishSuccessMessage": "Vous pouvez trouver votre plan de sous-graphe dans la bibliothèque de nœuds sous \"Plans de sous-graphes\"",
    "saveBlueprint": "Enregistrer le sous-graphe dans la bibliothèque",
+    "searchAliases": "Rechercher des alias",
    "showAll": "Tout afficher",
    "showRecommended": "Afficher les widgets recommandés",
    "shown": "Affiché sur le nœud"
--- a/src/locales/ja/commands.json
+++ b/src/locales/ja/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "再起動"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "選択したノードの3Dビューアー（ベータ）を開く"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "実験的: モデルアセットを参照"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "設定ダイアログを表示"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "サブグラフの説明を設定"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "サブグラフの検索エイリアスを設定"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "実験的: AssetAPIを有効化"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "パネル下部の切り替え"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "ターミナルパネル下部の切り替え"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "ログパネル下部の切り替え"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "必須な下部パネルを切り替え"
  },
--- a/src/locales/ja/main.json
+++ b/src/locales/ja/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "マスクエディタで右に回転",
    "Save": "保存",
    "Save As": "名前を付けて保存",
+    "Set Subgraph Description": "サブグラフの説明を設定",
+    "Set Subgraph Search Aliases": "サブグラフの検索エイリアスを設定",
    "Show Keybindings Dialog": "キーバインドダイアログを表示",
    "Show Model Selector (Dev)": "モデルセレクターを表示（開発用）",
    "Show Settings Dialog": "設定ダイアログを表示",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "インストール済みのブループリントは削除できません",
    "confirmDelete": "この操作により、ライブラリからサブグラフが完全に削除されます",
    "confirmDeleteTitle": "サブグラフを削除しますか？",
+    "enterDescription": "説明を入力してください",
+    "enterSearchAliases": "検索用エイリアスを入力（カンマ区切り）",
    "hidden": "非表示／ネストされたパラメータ",
    "hideAll": "すべて非表示",
    "loadFailure": "サブグラフの読み込みに失敗しました",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "ノードライブラリに保存されました",
    "publishSuccessMessage": "サブグラフはノードライブラリの「サブグラフブループリント」で見つけることができます",
    "saveBlueprint": "サブグラフをライブラリに保存",
+    "searchAliases": "エイリアスを検索",
    "showAll": "すべて表示",
    "showRecommended": "おすすめウィジェットを表示",
    "shown": "ノード上で表示"
--- a/src/locales/ko/commands.json
+++ b/src/locales/ko/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "재시작"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "선택한 노드에 대해 3D 뷰어(베타) 열기"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "실험적: 모델 에셋 탐색"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "설정 대화상자 보기"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "서브그래프 설명 설정"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "서브그래프 검색 별칭 설정"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "실험적: AssetAPI 활성화"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "하단 패널 토글"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "터미널 하단 패널 토글"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "로그 하단 패널 토글"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "필수 하단 패널 전환"
  },
--- a/src/locales/ko/main.json
+++ b/src/locales/ko/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "마스크 편집기에서 오른쪽으로 회전",
    "Save": "저장",
    "Save As": "다른 이름으로 저장",
+    "Set Subgraph Description": "서브그래프 설명 설정",
+    "Set Subgraph Search Aliases": "서브그래프 검색 별칭 설정",
    "Show Keybindings Dialog": "단축키 대화상자 표시",
    "Show Model Selector (Dev)": "모델 선택기 표시 (개발자용)",
    "Show Settings Dialog": "설정 대화상자 표시",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "설치된 블루프린트는 삭제할 수 없습니다",
    "confirmDelete": "이 작업은 라이브러리에서 블루프린트를 영구적으로 제거합니다",
    "confirmDeleteTitle": "블루프린트를 삭제하시겠습니까?",
+    "enterDescription": "설명을 입력하세요",
+    "enterSearchAliases": "검색 별칭을 입력하세요 (쉼표로 구분)",
    "hidden": "숨김 / 중첩 매개변수",
    "hideAll": "모두 숨김",
    "loadFailure": "서브그래프 블루프린트 로드 실패",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "노드 라이브러리에 저장됨",
    "publishSuccessMessage": "노드 라이브러리의 \"서브그래프 블루프린트\" 아래에서 서브그래프 블루프린트를 찾을 수 있습니다",
    "saveBlueprint": "서브그래프를 라이브러리에 저장",
+    "searchAliases": "별칭 검색",
    "showAll": "모두 표시",
    "showRecommended": "권장 위젯 표시",
    "shown": "노드에 표시됨"
--- a/src/locales/pt-BR/commands.json
+++ b/src/locales/pt-BR/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "Reiniciar"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "Abrir visualizador 3D (Beta) para o nó selecionado"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "Experimental: Navegar pelos ativos de modelo"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "Mostrar Diálogo de Configurações"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "Definir descrição do subgrafo"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "Definir aliases de pesquisa do subgrafo"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "Experimental: Ativar AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "Alternar painel inferior"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "Alternar painel inferior do terminal"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "Alternar painel inferior de logs"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "Alternar painel inferior essencial"
  },
--- a/src/locales/pt-BR/main.json
+++ b/src/locales/pt-BR/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "Girar para a direita no MaskEditor",
    "Save": "Salvar",
    "Save As": "Salvar como",
+    "Set Subgraph Description": "Definir Descrição do Subgrafo",
+    "Set Subgraph Search Aliases": "Definir Apelidos de Busca do Subgrafo",
    "Show Keybindings Dialog": "Mostrar diálogo de atalhos",
    "Show Model Selector (Dev)": "Mostrar seletor de modelo (Dev)",
    "Show Settings Dialog": "Mostrar diálogo de configurações",
@@ -2435,6 +2437,8 @@
    "cannotDeleteGlobal": "Não é possível excluir blueprints instalados",
    "confirmDelete": "Esta ação removerá permanentemente o blueprint da sua biblioteca",
    "confirmDeleteTitle": "Excluir blueprint?",
+    "enterDescription": "Insira uma descrição",
+    "enterSearchAliases": "Insira apelidos de busca (separados por vírgula)",
    "hidden": "Parâmetros ocultos/aninhados",
    "hideAll": "Ocultar tudo",
    "loadFailure": "Falha ao carregar blueprints de subgrafo",
@@ -2445,6 +2449,7 @@
    "publishSuccess": "Salvo na Biblioteca de Nós",
    "publishSuccessMessage": "Você pode encontrar seu blueprint de subgrafo na biblioteca de nós em \"Blueprints de Subgrafo\"",
    "saveBlueprint": "Salvar Subgrafo na Biblioteca",
+    "searchAliases": "Buscar Apelidos",
    "showAll": "Mostrar tudo",
    "showRecommended": "Mostrar widgets recomendados",
    "shown": "Exibido no nó"
--- a/src/locales/pt-BR/nodeDefs.json
+++ b/src/locales/pt-BR/nodeDefs.json
@@ -6427,9 +6427,7 @@
  "Load3D": {
    "display_name": "Carregar 3D & Animação",
    "inputs": {
-      "clear": {
-        "": "limpar"
-      },
+      "clear": {},
      "height": {
        "name": "altura"
      },
@@ -6439,42 +6437,24 @@
      "model_file": {
        "name": "arquivo_do_modelo"
      },
-      "upload 3d model": {
-        "": "enviar modelo 3D"
-      },
-      "upload extra resources": {
-        "": "enviar recursos extras"
-      },
+      "upload 3d model": {},
+      "upload extra resources": {},
      "width": {
        "name": "largura"
      }
    },
-    "outputs": {
-      "0": {
-        "name": "imagem",
-        "tooltip": null
-      },
-      "1": {
-        "name": "mask",
-        "tooltip": null
-      },
-      "2": {
-        "name": "caminho_malha",
-        "tooltip": null
-      },
-      "3": {
-        "name": "normal",
-        "tooltip": null
-      },
-      "4": {
-        "name": "info_câmera",
-        "tooltip": null
-      },
-      "5": {
-        "name": "vídeo_gravado",
+    "outputs": [
+      null,
+      null,
+      null,
+      null,
+      null,
+      null,
+      {
+        "name": "model_3d",
        "tooltip": null
      }
-    }
+    ]
  },
  "LoadAudio": {
    "display_name": "Carregar Áudio",
--- a/src/locales/ru/commands.json
+++ b/src/locales/ru/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "Перезапустить"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "Открыть 3D-просмотрщик (бета) для выбранного узла"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "Экспериментально: Просмотр ресурсов моделей"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "Показать диалог настроек"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "Установить описание подграфа"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "Установить поисковые псевдонимы подграфа"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "Экспериментально: Включить AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "Переключить нижнюю панель"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "Переключить нижнюю панель терминала"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "Переключить нижнюю панель логов"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "Показать/скрыть основную нижнюю панель"
  },
--- a/src/locales/ru/main.json
+++ b/src/locales/ru/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "Повернуть вправо в MaskEditor",
    "Save": "Сохранить",
    "Save As": "Сохранить как",
+    "Set Subgraph Description": "Установить описание подграфа",
+    "Set Subgraph Search Aliases": "Установить псевдонимы поиска подграфа",
    "Show Keybindings Dialog": "Показать диалог клавиш быстрого доступа",
    "Show Model Selector (Dev)": "Показать выбор модели (Dev)",
    "Show Settings Dialog": "Показать диалог настроек",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "Невозможно удалить установленные blueprints",
    "confirmDelete": "Это действие навсегда удалит подграф из вашей библиотеки",
    "confirmDeleteTitle": "Удалить подграф?",
+    "enterDescription": "Введите описание",
+    "enterSearchAliases": "Введите псевдонимы для поиска (через запятую)",
    "hidden": "Скрытые / вложенные параметры",
    "hideAll": "Скрыть всё",
    "loadFailure": "Не удалось загрузить схемы подграфов",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "Сохранено в библиотеку узлов",
    "publishSuccessMessage": "Вы можете найти свой подграф в библиотеке узлов в разделе «Subgraph Blueprints»",
    "saveBlueprint": "Сохранить подграф в библиотеку",
+    "searchAliases": "Поиск по псевдонимам",
    "showAll": "Показать всё",
    "showRecommended": "Показать рекомендуемые виджеты",
    "shown": "Показано на узле"
--- a/src/locales/tr/commands.json
+++ b/src/locales/tr/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "Yeniden Başlat"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "Seçili Düğüm için 3D Görüntüleyiciyi (Beta) Aç"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "Deneysel: Model Varlıklarını Gözat"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "Ayarlar İletişim Kutusunu Göster"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "Alt Grafik Açıklamasını Ayarla"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "Alt Grafik Arama Takma Adlarını Ayarla"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "Deneysel: AssetAPI'yi Etkinleştir"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "Alt Paneli Aç/Kapat"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "Terminal Alt Panelini Aç/Kapat"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "Kayıtlar Alt Panelini Aç/Kapat"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "Temel Alt Paneli Aç/Kapat"
  },
--- a/src/locales/tr/main.json
+++ b/src/locales/tr/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "MaskEditor'da sağa döndür",
    "Save": "Kaydet",
    "Save As": "Farklı Kaydet",
+    "Set Subgraph Description": "Alt Grafik Açıklamasını Ayarla",
+    "Set Subgraph Search Aliases": "Alt Grafik Arama Takma Adlarını Ayarla",
    "Show Keybindings Dialog": "Tuş Atamaları İletişim Kutusunu Göster",
    "Show Model Selector (Dev)": "Model Seçiciyi Göster (Geliştirici)",
    "Show Settings Dialog": "Ayarlar İletişim Kutusunu Göster",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "Yüklü şablonlar silinemez",
    "confirmDelete": "Bu işlem taslağı kütüphanenizden kalıcı olarak kaldıracaktır",
    "confirmDeleteTitle": "Taslak silinsin mi?",
+    "enterDescription": "Bir açıklama girin",
+    "enterSearchAliases": "Arama takma adlarını girin (virgülle ayrılmış)",
    "hidden": "Gizli / iç içe parametreler",
    "hideAll": "Tümünü gizle",
    "loadFailure": "Alt grafik taslakları yüklenemedi",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "Düğüm Kütüphanesine Kaydedildi",
    "publishSuccessMessage": "Alt grafik taslağınızı düğüm kütüphanesinde \"Alt Grafik Taslakları\" altında bulabilirsiniz",
    "saveBlueprint": "Alt Grafiği Kütüphaneye Kaydet",
+    "searchAliases": "Takma Adlarda Ara",
    "showAll": "Tümünü göster",
    "showRecommended": "Önerilen widget'ları göster",
    "shown": "Düğümde gösterilen"
--- a/src/locales/zh-TW/commands.json
+++ b/src/locales/zh-TW/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "重新啟動"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "為選取的節點開啟 3D 檢視器（Beta）"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "實驗性：瀏覽模型資源"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "顯示設定對話框"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "設定子圖描述"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "設定子圖搜尋別名"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "實驗性：啟用 AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "切換下方面板"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "切換終端機底部面板"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "切換日誌底部面板"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "切換基本下方面板"
  },
--- a/src/locales/zh-TW/main.json
+++ b/src/locales/zh-TW/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "在遮罩編輯器中向右旋轉",
    "Save": "儲存",
    "Save As": "另存新檔",
+    "Set Subgraph Description": "設定子圖描述",
+    "Set Subgraph Search Aliases": "設定子圖搜尋別名",
    "Show Keybindings Dialog": "顯示快捷鍵對話框",
    "Show Model Selector (Dev)": "顯示模型選擇器（開發用）",
    "Show Settings Dialog": "顯示設定對話框",
@@ -2424,6 +2426,8 @@
    "cannotDeleteGlobal": "無法刪除已安裝的藍圖",
    "confirmDelete": "此操作將永久從您的程式庫中移除藍圖",
    "confirmDeleteTitle": "刪除藍圖？",
+    "enterDescription": "輸入描述",
+    "enterSearchAliases": "輸入搜尋別名（以逗號分隔）",
    "hidden": "隱藏 / 巢狀參數",
    "hideAll": "全部隱藏",
    "loadFailure": "載入子圖藍圖失敗",
@@ -2434,6 +2438,7 @@
    "publishSuccess": "已儲存至節點庫",
    "publishSuccessMessage": "您可以在節點庫的「子圖藍圖」中找到您的子圖藍圖",
    "saveBlueprint": "將子圖儲存到資料庫",
+    "searchAliases": "搜尋別名",
    "showAll": "顯示全部",
    "showRecommended": "顯示建議的小工具",
    "shown": "在節點上顯示"
--- a/src/locales/zh/commands.json
+++ b/src/locales/zh/commands.json
@@ -35,9 +35,6 @@
  "Comfy-Desktop_Restart": {
    "label": "重启"
  },
-  "Comfy_3DViewer_Open3DViewer": {
-    "label": "为所选节点开启 3D 浏览器（Beta 版）"
-  },
  "Comfy_BrowseModelAssets": {
    "label": "实验性：浏览模型资源"
  },
@@ -266,6 +263,12 @@
  "Comfy_ShowSettingsDialog": {
    "label": "显示设置对话框"
  },
+  "Comfy_Subgraph_SetDescription": {
+    "label": "设置子图描述"
+  },
+  "Comfy_Subgraph_SetSearchAliases": {
+    "label": "设置子图搜索别名"
+  },
  "Comfy_ToggleAssetAPI": {
    "label": "实验性：启用 AssetAPI"
  },
@@ -311,12 +314,6 @@
  "Workspace_ToggleBottomPanel": {
    "label": "切换底部面板"
  },
-  "Workspace_ToggleBottomPanelTab_command-terminal": {
-    "label": "切换终端底部面板"
-  },
-  "Workspace_ToggleBottomPanelTab_logs-terminal": {
-    "label": "切换日志底部面板"
-  },
  "Workspace_ToggleBottomPanelTab_shortcuts-essentials": {
    "label": "切换基本下方面板"
  },
--- a/src/locales/zh/main.json
+++ b/src/locales/zh/main.json
@@ -1686,6 +1686,8 @@
    "Rotate Right in MaskEditor": "在蒙版编辑器中向右旋转",
    "Save": "保存",
    "Save As": "另存为",
+    "Set Subgraph Description": "设置子图描述",
+    "Set Subgraph Search Aliases": "设置子图搜索别名",
    "Show Keybindings Dialog": "显示快捷键对话框",
    "Show Model Selector (Dev)": "显示模型选择器（开发用）",
    "Show Settings Dialog": "显示设置对话框",
@@ -2435,6 +2437,8 @@
    "cannotDeleteGlobal": "无法删除已安装的蓝图",
    "confirmDelete": "此操作将永久从您的库中移除该子工作流",
    "confirmDeleteTitle": "删除子工作流？",
+    "enterDescription": "输入描述",
+    "enterSearchAliases": "输入搜索别名（用逗号分隔）",
    "hidden": "隐藏/嵌套参数",
    "hideAll": "全部隐藏",
    "loadFailure": "加载子工作流蓝图失败",
@@ -2445,6 +2449,7 @@
    "publishSuccess": "已保存到节点库",
    "publishSuccessMessage": "您可以在节点库的“子工作流蓝图”下找到您的子工作流蓝图",
    "saveBlueprint": "保存子工作流到节点库",
+    "searchAliases": "搜索别名",
    "showAll": "全部显示",
    "showRecommended": "显示推荐控件",
    "shown": "节点上显示"
--- a/src/locales/zh/nodeDefs.json
+++ b/src/locales/zh/nodeDefs.json
@@ -6443,32 +6443,18 @@
        "name": "宽度"
      }
    },
-    "outputs": {
-      "0": {
-        "name": "图像",
-        "tooltip": null
-      },
-      "1": {
-        "name": "遮罩",
-        "tooltip": null
-      },
-      "2": {
-        "name": "网格路径",
-        "tooltip": null
-      },
-      "3": {
-        "name": "法向",
-        "tooltip": null
-      },
-      "4": {
-        "name": "线条",
-        "tooltip": null
-      },
-      "5": {
-        "name": "相机信息",
+    "outputs": [
+      null,
+      null,
+      null,
+      null,
+      null,
+      null,
+      {
+        "name": "model_3d",
        "tooltip": null
      }
-    }
+    ]
  },
  "LoadAudio": {
    "display_name": "加载音频",
--- a/src/platform/secrets/components/SecretFormDialog.vue
+++ b/src/platform/secrets/components/SecretFormDialog.vue
@@ -13,10 +13,10 @@
          {{ $t('secrets.provider') }}
        </label>
        <Select v-model="form.provider" :disabled="mode === 'edit'">
-          <SelectTrigger id="secret-provider" class="w-full">
+          <SelectTrigger id="secret-provider" class="w-full" autofocus>
            <SelectValue :placeholder="$t('g.none')" />
          </SelectTrigger>
-          <SelectContent>
+          <SelectContent disable-portal>
            <SelectItem
              v-for="option in providerOptions"
              :key="option.value || 'none'"
@@ -79,10 +79,15 @@
      </span>

      <div class="flex justify-end gap-2 pt-2">
-        <Button variant="secondary" type="button" @click="visible = false">
+        <Button
+          variant="secondary"
+          type="button"
+          tabindex="0"
+          @click="visible = false"
+        >
          {{ $t('g.cancel') }}
        </Button>
-        <Button type="submit" :loading="loading">
+        <Button type="submit" tabindex="0" :loading="loading">
          {{ $t('g.save') }}
        </Button>
      </div>
--- a/src/platform/workflow/validation/schemas/workflowSchema.ts
+++ b/src/platform/workflow/validation/schemas/workflowSchema.ts
@@ -275,7 +275,9 @@ const zExtra = z
    frontendVersion: z.string().optional(),
    linkExtensions: z.array(zComfyLinkExtension).optional(),
    reroutes: z.array(zReroute).optional(),
-    workflowRendererVersion: zRendererType.optional()
+    workflowRendererVersion: zRendererType.optional(),
+    BlueprintDescription: z.string().optional(),
+    BlueprintSearchAliases: z.array(z.string()).optional()
  })
  .passthrough()

@@ -395,6 +397,10 @@ interface SubgraphDefinitionBase<
  revision: number
  name: string
  category?: string
+  /** Custom metadata for the subgraph (description, searchAliases, etc.) */
+  extra?: T extends ComfyWorkflow1BaseInput
+    ? z.input<typeof zExtra> | null
+    : z.output<typeof zExtra> | null

  inputNode: T extends ComfyWorkflow1BaseInput
    ? z.input<typeof zExportedSubgraphIONode>
--- a/src/scripts/api.ts
+++ b/src/scripts/api.ts
@@ -234,6 +234,7 @@ export type GlobalSubgraphData = {
  info: {
    node_pack: string
    category?: string
+    search_aliases?: string[]
  }
  data: string | Promise<string>
 }
--- a/src/services/nodeSearchService.test.ts
+++ b/src/services/nodeSearchService.test.ts
@@ -61,6 +61,54 @@ const EXAMPLE_NODE_DEFS: ComfyNodeDefImpl[] = (
  return def
 })

+const NODE_DEFS_WITH_SEARCH_ALIASES: ComfyNodeDefImpl[] = (
+  [
+    {
+      input: { required: {} },
+      output: ['MODEL'],
+      output_is_list: [false],
+      output_name: ['MODEL'],
+      name: 'CheckpointLoaderSimple',
+      display_name: 'Load Checkpoint',
+      description: '',
+      python_module: 'nodes',
+      category: 'loaders',
+      output_node: false,
+      search_aliases: ['ckpt', 'model loader', 'checkpoint']
+    },
+    {
+      input: { required: {} },
+      output: ['IMAGE'],
+      output_is_list: [false],
+      output_name: ['IMAGE'],
+      name: 'LoadImage',
+      display_name: 'Load Image',
+      description: '',
+      python_module: 'nodes',
+      category: 'loaders',
+      output_node: false,
+      search_aliases: ['img', 'picture']
+    },
+    {
+      input: { required: {} },
+      output: ['LATENT'],
+      output_is_list: [false],
+      output_name: ['LATENT'],
+      name: 'VAEEncode',
+      display_name: 'VAE Encode',
+      description: '',
+      python_module: 'nodes',
+      category: 'latent',
+      output_node: false
+      // No search_aliases
+    }
+  ] as ComfyNodeDef[]
+).map((nodeDef: ComfyNodeDef) => {
+  const def = new ComfyNodeDefImpl(nodeDef)
+  def['postProcessSearchScores'] = (s) => s
+  return def
+})
+
 describe('nodeSearchService', () => {
  it('searches with input filter', () => {
    const service = new NodeSearchService(EXAMPLE_NODE_DEFS)
@@ -74,4 +122,52 @@ describe('nodeSearchService', () => {
    ).toHaveLength(2)
    expect(service.searchNode('L')).toHaveLength(2)
  })
+
+  describe('search_aliases', () => {
+    it('finds nodes by search_aliases', () => {
+      const service = new NodeSearchService(NODE_DEFS_WITH_SEARCH_ALIASES)
+      // Search by alias
+      const ckptResults = service.searchNode('ckpt')
+      expect(ckptResults).toHaveLength(1)
+      expect(ckptResults[0].name).toBe('CheckpointLoaderSimple')
+    })
+
+    it('finds nodes by partial alias match', () => {
+      const service = new NodeSearchService(NODE_DEFS_WITH_SEARCH_ALIASES)
+      // Search by partial alias "model" should match "model loader" alias
+      const modelResults = service.searchNode('model')
+      expect(modelResults.length).toBeGreaterThanOrEqual(1)
+      expect(
+        modelResults.some((r) => r.name === 'CheckpointLoaderSimple')
+      ).toBe(true)
+    })
+
+    it('finds nodes by display_name when no alias matches', () => {
+      const service = new NodeSearchService(NODE_DEFS_WITH_SEARCH_ALIASES)
+      // "VAE" should match by display_name since there are no aliases
+      const vaeResults = service.searchNode('VAE')
+      expect(vaeResults).toHaveLength(1)
+      expect(vaeResults[0].name).toBe('VAEEncode')
+    })
+
+    it('finds nodes by both alias and display_name', () => {
+      const service = new NodeSearchService(NODE_DEFS_WITH_SEARCH_ALIASES)
+      // "img" should match LoadImage by alias
+      const imgResults = service.searchNode('img')
+      expect(imgResults).toHaveLength(1)
+      expect(imgResults[0].name).toBe('LoadImage')
+
+      // "Load" should match both checkpoint and image loaders by display_name
+      const loadResults = service.searchNode('Load')
+      expect(loadResults.length).toBeGreaterThanOrEqual(2)
+    })
+
+    it('handles nodes without search_aliases', () => {
+      const service = new NodeSearchService(NODE_DEFS_WITH_SEARCH_ALIASES)
+      // Ensure nodes without aliases are still searchable by name/display_name
+      const encodeResults = service.searchNode('Encode')
+      expect(encodeResults).toHaveLength(1)
+      expect(encodeResults[0].name).toBe('VAEEncode')
+    })
+  })
 })
--- a/src/stores/nodeDefStore.ts
+++ b/src/stores/nodeDefStore.ts
@@ -77,6 +77,11 @@ export class ComfyNodeDefImpl
   * and input connectivity.
   */
  readonly price_badge?: PriceBadge
+  /**
+   * Alternative names for search. Useful for synonyms, abbreviations,
+   * or old names after renaming a node.
+   */
+  readonly search_aliases?: string[]

  // V2 fields
  readonly inputs: Record<string, InputSpecV2>
--- a/src/stores/subgraphStore.test.ts
+++ b/src/stores/subgraphStore.test.ts
@@ -167,4 +167,142 @@ describe('useSubgraphStore', () => {
    await mockFetch({ 'test.json': mockGraph })
    expect(store.isGlobalBlueprint('nonexistent')).toBe(false)
  })
+
+  describe('search_aliases support', () => {
+    it('should include search_aliases from workflow extra', async () => {
+      const mockGraphWithAliases = {
+        nodes: [{ type: '123' }],
+        definitions: {
+          subgraphs: [{ id: '123' }]
+        },
+        extra: {
+          BlueprintSearchAliases: ['alias1', 'alias2', 'my workflow']
+        }
+      }
+      await mockFetch({ 'test-with-aliases.json': mockGraphWithAliases })
+
+      const nodeDef = useNodeDefStore().nodeDefs.find(
+        (d) => d.name === 'SubgraphBlueprint.test-with-aliases'
+      )
+      expect(nodeDef).toBeDefined()
+      expect(nodeDef?.search_aliases).toEqual([
+        'alias1',
+        'alias2',
+        'my workflow'
+      ])
+    })
+
+    it('should include search_aliases from global blueprint info', async () => {
+      await mockFetch(
+        {},
+        {
+          global_with_aliases: {
+            name: 'Global With Aliases',
+            info: {
+              node_pack: 'comfy_essentials',
+              search_aliases: ['global alias', 'test alias']
+            },
+            data: JSON.stringify(mockGraph)
+          }
+        }
+      )
+
+      const nodeDef = useNodeDefStore().nodeDefs.find(
+        (d) => d.name === 'SubgraphBlueprint.global_with_aliases'
+      )
+      expect(nodeDef).toBeDefined()
+      expect(nodeDef?.search_aliases).toEqual(['global alias', 'test alias'])
+    })
+
+    it('should not have search_aliases if not provided', async () => {
+      await mockFetch({ 'test.json': mockGraph })
+
+      const nodeDef = useNodeDefStore().nodeDefs.find(
+        (d) => d.name === 'SubgraphBlueprint.test'
+      )
+      expect(nodeDef).toBeDefined()
+      expect(nodeDef?.search_aliases).toBeUndefined()
+    })
+
+    it('should include description from workflow extra', async () => {
+      const mockGraphWithDescription = {
+        nodes: [{ type: '123' }],
+        definitions: {
+          subgraphs: [{ id: '123' }]
+        },
+        extra: {
+          BlueprintDescription: 'This is a test blueprint'
+        }
+      }
+      await mockFetch({
+        'test-with-description.json': mockGraphWithDescription
+      })
+
+      const nodeDef = useNodeDefStore().nodeDefs.find(
+        (d) => d.name === 'SubgraphBlueprint.test-with-description'
+      )
+      expect(nodeDef).toBeDefined()
+      expect(nodeDef?.description).toBe('This is a test blueprint')
+    })
+
+    it('should not duplicate metadata in both workflow extra and subgraph extra when publishing', async () => {
+      const subgraph = createTestSubgraph()
+      const subgraphNode = createTestSubgraphNode(subgraph)
+      const graph = subgraphNode.graph!
+      graph.add(subgraphNode)
+
+      // Set metadata on the subgraph's extra (as the commands do)
+      subgraph.extra = {
+        BlueprintDescription: 'Test description',
+        BlueprintSearchAliases: ['alias1', 'alias2']
+      }
+
+      vi.mocked(comfyApp.canvas).selectedItems = new Set([subgraphNode])
+      vi.mocked(comfyApp.canvas)._serializeItems = vi.fn(() => {
+        const serializedSubgraph = {
+          ...subgraph.serialize(),
+          links: [],
+          groups: [],
+          version: 1
+        } as Partial<ExportedSubgraph> as ExportedSubgraph
+        return {
+          nodes: [subgraphNode.serialize()],
+          subgraphs: [serializedSubgraph]
+        }
+      })
+
+      let savedWorkflowData: Record<string, unknown> | null = null
+      vi.mocked(api.storeUserData).mockImplementation(async (_path, data) => {
+        savedWorkflowData = JSON.parse(data as string)
+        return {
+          status: 200,
+          json: () =>
+            Promise.resolve({
+              path: 'subgraphs/testname.json',
+              modified: Date.now(),
+              size: 2
+            })
+        } as Response
+      })
+
+      await mockFetch({ 'testname.json': mockGraph })
+      await store.publishSubgraph()
+
+      expect(savedWorkflowData).not.toBeNull()
+
+      // Metadata should be in top-level extra
+      expect(savedWorkflowData!.extra).toEqual({
+        BlueprintDescription: 'Test description',
+        BlueprintSearchAliases: ['alias1', 'alias2']
+      })
+
+      // Metadata should NOT be in subgraph's extra
+      const definitions = savedWorkflowData!.definitions as {
+        subgraphs: Array<{ extra?: Record<string, unknown> }>
+      }
+      const subgraphExtra = definitions.subgraphs[0]?.extra
+      expect(subgraphExtra?.BlueprintDescription).toBeUndefined()
+      expect(subgraphExtra?.BlueprintSearchAliases).toBeUndefined()
+    })
+  })
 })
--- a/src/stores/subgraphStore.ts
+++ b/src/stores/subgraphStore.ts
@@ -95,18 +95,46 @@ export const useSubgraphStore = defineStore('subgraph', () => {
        if (!(await confirmOverwrite(this.filename))) return this
        this.hasPromptedSave = true
      }
+      // Extract metadata from subgraph.extra to workflow.extra before saving
+      this.extractMetadataToWorkflowExtra()
      const ret = await super.save()
-      registerNodeDef(await this.load(), {
+      // Force reload to update initialState with saved metadata
+      registerNodeDef(await this.load({ force: true }), {
        category: 'Subgraph Blueprints/User'
      })
      return ret
    }

+    /**
+     * Moves all properties (except workflowRendererVersion) from subgraph.extra
+     * to workflow.extra, then removes from subgraph.extra to avoid duplication.
+     */
+    private extractMetadataToWorkflowExtra(): void {
+      if (!this.activeState) return
+      const subgraph = this.activeState.definitions?.subgraphs?.[0]
+      if (!subgraph?.extra) return
+
+      const sgExtra = subgraph.extra as Record<string, unknown>
+      const workflowExtra = (this.activeState.extra ??= {}) as Record<
+        string,
+        unknown
+      >
+
+      for (const key of Object.keys(sgExtra)) {
+        if (key === 'workflowRendererVersion') continue
+        workflowExtra[key] = sgExtra[key]
+        delete sgExtra[key]
+      }
+    }
+
    override async saveAs(path: string) {
      this.validateSubgraph()
      this.hasPromptedSave = true
+      // Extract metadata from subgraph.extra to workflow.extra before saving
+      this.extractMetadataToWorkflowExtra()
      const ret = await super.saveAs(path)
-      registerNodeDef(await this.load(), {
+      // Force reload to update initialState with saved metadata
+      registerNodeDef(await this.load({ force: true }), {
        category: 'Subgraph Blueprints/User'
      })
      return ret
@@ -125,6 +153,17 @@ export const useSubgraphStore = defineStore('subgraph', () => {
          'Loaded subgraph blueprint does not contain valid subgraph'
        )
      sg.name = st.nodes[0].title = this.filename
+
+      // Copy blueprint metadata from workflow extra to subgraph extra
+      // so it's available when editing via canvas.subgraph.extra
+      if (st.extra) {
+        const sgExtra = (sg.extra ??= {}) as Record<string, unknown>
+        for (const [key, value] of Object.entries(st.extra)) {
+          if (key === 'workflowRendererVersion') continue
+          sgExtra[key] = value
+        }
+      }
+
      return loaded
    }
    override async promptSave(): Promise<string | null> {
@@ -177,7 +216,8 @@ export const useSubgraphStore = defineStore('subgraph', () => {
          {
            python_module: v.info.node_pack,
            display_name: v.name,
-            category
+            category,
+            search_aliases: v.info.search_aliases
          },
          k
        )
@@ -223,9 +263,10 @@ export const useSubgraphStore = defineStore('subgraph', () => {
        [`${i.type}`, undefined] satisfies InputSpec
      ])
    )
-    let description = 'User generated subgraph blueprint'
-    if (workflow.initialState.extra?.BlueprintDescription)
-      description = `${workflow.initialState.extra.BlueprintDescription}`
+    const workflowExtra = workflow.initialState.extra
+    const description =
+      workflowExtra?.BlueprintDescription ?? 'User generated subgraph blueprint'
+    const search_aliases = workflowExtra?.BlueprintSearchAliases
    const nodedefv1: ComfyNodeDefV1 = {
      input: { required: inputs },
      output: subgraphNode.outputs.map((o) => `${o.type}`),
@@ -236,13 +277,14 @@ export const useSubgraphStore = defineStore('subgraph', () => {
      category: 'Subgraph Blueprints',
      output_node: false,
      python_module: 'blueprint',
+      search_aliases,
      ...overrides
    }
    const nodeDefImpl = new ComfyNodeDefImpl(nodedefv1)
    subgraphDefCache.value.set(name, nodeDefImpl)
    subgraphCache[name] = workflow
  }
-  async function publishSubgraph() {
+  async function publishSubgraph(providedName?: string) {
    const canvas = canvasStore.getCanvas()
    const subgraphNode = [...canvas.selectedItems][0]
    if (
@@ -257,22 +299,25 @@ export const useSubgraphStore = defineStore('subgraph', () => {
    if (nodes.length != 1) {
      throw new TypeError('Must have single SubgraphNode selected to publish')
    }
+
    //create minimal workflow
    const workflowData = {
      revision: 0,
      last_node_id: subgraphNode.id,
      last_link_id: 0,
      nodes,
-      links: [],
+      links: [] as never[],
      version: 0.4,
      definitions: { subgraphs }
    }
    //prompt name
-    const name = await useDialogService().prompt({
-      title: t('subgraphStore.saveBlueprint'),
-      message: t('subgraphStore.blueprintNamePrompt'),
-      defaultValue: subgraphNode.title
-    })
+    const name =
+      providedName ??
+      (await useDialogService().prompt({
+        title: t('subgraphStore.saveBlueprint'),
+        message: t('subgraphStore.blueprintNamePrompt'),
+        defaultValue: subgraphNode.title
+      }))
    if (!name) return
    if (subgraphDefCache.value.has(name) && !(await confirmOverwrite(name)))
      //User has chosen not to overwrite.