Comfy-Org/ComfyUI_frontend

ComfyUI_frontend – ComfyUI 的官方網頁版 UI

ComfyUI 是一個用於構建和運行 AI 圖像生成管線（Stable Diffusion、ControlNet 等）的開源視覺化編程環境。ComfyUI_frontend 是配套的前端，可在瀏覽器（或基於 Electron 的桌面應用程式）中運行，讓用戶無需編寫代碼即可組裝、編輯和執行這些管線。

功能介紹

圖形編輯器 – 一個基於節點的畫布（基於 Litegraph 構建），其中每個節點代表一個 AI 模型、一個預處理步驟或一個後處理操作。用戶可以通過視覺化方式拖放、連接和配置節點。
實時預覽 – 生成的圖像會在圖形運行時立即顯示，使實驗過程非常快速。
內置工具 – 遮罩編輯器、隊列/歷史記錄側邊欄、具有模糊搜索功能的節點庫，以及可自定義的頂部欄。
國際化 – 原生支持 14 種語言，可從 UI 中選擇。
可擴展性 – JavaScript 擴展 API 允許開發者在不修改核心代碼的情況下，添加自定義面板、命令、按鍵綁定和彈窗通知（toast notifications），以及設置。

顯著功能（截至最新版本）

功能	您將獲得
原生翻譯 (v1.5)	從 `Comfy > Locale > Language` 選擇語言；UI 字串會即時翻譯，無需第三方插件。
遮罩編輯器 (v1.4)	直接在 UI 中繪製或導入遮罩並將其附加到節點。
集成伺服器終端機 (v1.3.22)	按 `Ctrl`+` 以打開與 ComfyUI 後端通信的終端機。
按鍵綁定自定義 (v1.3.7)	通過專用 UI 重新映射快捷鍵、編輯節點標題、重置畫布等。
節點庫側邊欄 (v1.2.4)	拖放節點、按類型過濾，並使用模糊匹配進行搜索。
隊列/歷史記錄側邊欄 (v1.2.0)	查看過去的運行記錄，重新運行它們，或檢查中間結果。
Litegraph 品質提升 – 嵌套分組、分組選擇、鏈接可見性切換、自動將小部件到輸入轉換、平移模式、Shift-drag 鏈接創建、可選輸入 "donuts" 等。

擴展 API (快速速查表)

// Register an extension
app.registerExtension({
  name: 'MyExtension',
  // add a custom sidebar tab
  sidebarTabs: [{
    id: 'myTab',
    title: 'My Tab',
    icon: 'pi pi-star',
    render: el => { el.innerHTML = '<div>Hello</div>'; }
  }],
  // add a top‑bar menu command
  commands: [{ id: 'myCmd', label: 'Do it', function: () => alert('run') }],
  menuCommands: [{ path: ['ext', 'my'], commands: ['myCmd'] }],
  // custom keybinding
  keybindings: [{ combo: { key: 'k' }, commandId: 'myCmd' }],
  // toast notification
  onLoad: ():// app.extensionManager.toast.add({ severity: 'info', summary: 'Loaded', detail: 'MyExtension ready' })
});

該 API 還提供了 window.prompt/confirm/alert 的替代方案（這些在 Electron 桌面版本中無法使用）以及現代化的設置系統 (app.registerExtension({ settings: [...] }))。

發佈週期

開發階段 – 在 development 分支上進行為期 2 週的功能開發工作。
功能凍結期 – 為期 2 週，僅將錯誤修復（bug-fixes）挑選到發佈分支中。 | 發佈 – 在凍結期結束時標記一個穩定版本。
Nightly builds – 每日發佈；使用它們時需通過啟動 ComfyUI 時使用 --front-end-version Comfy-Org/ComfyUI_frontend@latest。

重疊的週期意味著當前一個版本在凍結期時，新的次要版本已開始開發，從合併到穩定發佈大約有 4 週的窗口期。

入門 / 故障排除

安裝 – 前端與 ComfyUI 桌面應用程式捆綁在一起，或者可以單獨為 Web-only 設置提供服務。遵循官方文檔：https://docs.comfy.org/installation/desktop/windows.
常見問題 – 查看故障排除指南以獲取性能提示、自定義節點衝突和桌面版特有的問題：https://docs.comfy.org/troubleshooting/overview.
開發 – 查看 CONTRIBUTING.md 以設置開發環境、運行 Storybook，以及編寫擴展。

誰會使用它？

藝術家與創作者 – 正在構建 Stable Diffusion 管線的用戶，他們偏好視覺化工作流。
研究人員 – 正在原型化新模型組合，而無需編寫 Python 粘合代碼。
擴展開發者 – 想要為 ComfyUI 添加自定義 UI 面板、命令、按鍵綁定或集成功能的人。

總結

ComfyUI_frontend 是 ComfyUI AI 工作流引擎的完整功能且持續維護的 UI 層。它提供了一個精屬緻的節點圖編輯器、多語言支持和豐富的 JavaScript 擴展系統，並以可預測的發佈週期與 Nightly builds 供早期採用者使用。