Comfy-Org/ComfyUI_frontend

ComfyUI_frontend – ComfyUI 的官方基于网页的用户界面

ComfyUI 是一个开源的可视化编程环境，用于构建和运行 AI 图像生成工作流（Stable Diffusion、ControlNet 等）。ComfyUI_frontend 是配套的前端，可在浏览器中运行（或在基于 Electron 的桌面应用中），让用户无需编写代码即可组装、编辑和执行这些工作流。

它能做什么

图形编辑器 – 基于 Litegraph 的节点式画布，每个节点代表一个 AI 模型、预处理步骤或后处理操作。用户可通过拖拽、连接和配置节点来实现可视化操作。
实时预览 – 图像生成结果在图运行时立即显示，使实验过程快速高效。
内置工具 – 掩码编辑器、队列/历史侧边栏、支持模糊搜索的节点库，以及可自定义的顶部栏。
国际化支持 – 原生支持 14 种语言，可通过 UI 选择。
可扩展性 – 提供 JavaScript 扩展 API，开发者可在不修改核心代码的前提下添加自定义面板、命令、快捷键、弹窗通知和设置项。

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

功能	你将获得
原生翻译（v1.5）	在 `Comfy > 本地化 > 语言` 中选择语言；UI 字符串会即时翻译，无需第三方插件。
掩码编辑器（v1.4）	直接在 UI 中绘制或导入掩码，并将其附加到节点上。
集成的服务器终端（v1.3.22）	按下 `Ctrl`+` 即可打开与 ComfyUI 后端通信的终端。
快捷键自定义（v1.3.7）	通过专用 UI 重新映射快捷键、编辑节点标题、重置画布等。
节点库侧边栏（v1.2.4）	拖拽节点、按类型过滤、使用模糊匹配搜索。
队列/历史侧边栏（v1.2.0）	查看过往运行记录，重新运行或检查中间结果。
Litegraph 的体验优化 – 嵌套分组、分组选择、链接可见性切换、自动小部件转输入、平移模式、Shift+拖拽创建链接、可选输入的“甜甜圈”样式等。

扩展 API（快速速查表）

// 注册一个扩展
app.registerExtension({
  name: 'MyExtension',
  // 添加自定义侧边栏标签页
  sidebarTabs: [{
    id: 'myTab',
    title: '我的标签页',
    icon: 'pi pi-star',
    render: el => { el.innerHTML = '<div>你好</div>'; }
  }],
  // 添加顶部栏菜单命令
  commands: [{ id: 'myCmd', label: '执行', function: () => alert('运行') }],
  menuCommands: [{ path: ['ext', 'my'], commands: ['myCmd'] }],
  // 自定义快捷键
  keybindings: [{ combo: { key: 'k' }, commandId: 'myCmd' }],
  // 弹窗通知
  onLoad: () => app.extensionManager.toast.add({ severity: 'info', summary: '已加载', detail: 'MyExtension 就绪' })
});

该 API 还提供了 window.prompt/confirm/alert 的替代方案（在 Electron 桌面版中不可用），以及现代化的设置系统（app.registerExtension({ settings: [...] })）。

发布节奏

开发阶段 – 在 development 分支上进行为期两周的功能开发。
功能冻结 – 为期两周，仅将修复 bug 的提交合并到发布分支。
发布 – 冻结期结束后，打上稳定版本标签。
每日构建 – 每日发布；通过启动 ComfyUI 时使用 --front-end-version Comfy-Org/ComfyUI_frontend@latest 来使用它们。

周期重叠意味着新小版本的开发会在前一版本冻结期间开始，因此从合并到稳定发布大约有四周窗口期。

入门与故障排除

安装 – 前端已捆绑在 ComfyUI 桌面应用中，也可单独部署以用于纯网页环境。请参考官方文档： 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 扩展系统，所有内容均按可预测的时间表发布，并为早期使用者提供每日构建版本。

一个真正为视觉化工作流而生的现代界面，让 AI 图像生成变得直观且高效。— @Comfy-Org