☕️ ComfyUI 工作区管理器 - Comfyspace

[2025-4-16] 📣大家好，由于 ComfyUI 前端现已内置工作区管理功能，本插件已过时，将不再维护。感谢各位对 comfyui-workspace-manager 的支持！很抱歉它无法继续更新了。

ComfyUI 工作流与模型管理扩展，旨在 在一个地方组织和管理您的所有工作流、模型及生成的图片。您可以无缝切换不同工作流、追踪版本历史与图像生成记录，一键从 Civit AI 安装模型，并浏览或更新您已安装的模型。

安装

[选项 1] 通过 ComfyUI 管理器（推荐）

只需搜索“ComfyUI Workspace Manager”，安装并重启 ComfyUI 即可。

[选项 2] 通过 Git

与其他自定义节点安装方式相同，在您的 ComfyUI 根目录下运行以下命令并重启 ComfyUI：

cd custom_nodes && git clone https://github.com/11cafe/comfyui-workspace-manager.git

请尽快升级到 V2 版本，您应该会在这里看到一只 独角兽🦄，而不是 ☕️（V1）。我将很快停止对 V1 的支持。

V2 推荐设置（如果您使用的是 V1，请勿采用这些设置）：

• 启用双向同步（‼️ 下一版本起将不再支持非双向同步模式）
• 确保“我的工作区保存目录”为有效路径

功能

工作流管理器

• 🔁轻松切换不同工作流。只需点击一下，即可在多个浏览器标签页中打开同一工作流。
• 🤏通过 拖放操作 将子工作流插入当前流程。
• 🗂️ 使用文件夹组织工作流（标签功能已弃用，请使用文件夹进行整理）。
• 📂将所有工作流保存并同步到本地文件夹中（默认位于 /ComfyUI/my_workflows，可在设置中自定义）。
  • 按下 💾 按钮或使用 ⌨Shift+S 快捷键保存工作流（可在设置中自定义）。
  • 每次保存都会在 版本历史 中创建一条新记录，您可以轻松回滚到任意版本。
  • 启用/禁用自动保存功能（如果遇到界面卡顿，请关闭自动保存）。
  • 您可以使用操作系统文件资源管理器移动文件，这些文件将与工作区实现 双向同步。
• 🕛 对工作流进行 版本控制，创建或切换版本。
• 批量导入工作流至您的工作区。
• 一键将所有工作流打包成 .zip 文件下载。

🔮模型管理器：

• 一键从 civitai 安装模型到对应模型类型的 models/ 子文件夹中。
• 浏览已安装的模型，并查看缩略图。
• 拖放“加载模型类型”节点到工作流中。

🖼️ 图片库：您生成的每张图片或视频都会保存在当前工作流的图库中。您可以将图库中的任意一张图片设为该工作流的封面照片。

• 暗色/亮色模式
• 云端同步与备份工作区，确保数据永不丢失（即将推出！）
• 【测试版】一键分享工作流

建议使用 Chrome 浏览器以获得最佳体验。Safari 效果不佳，Edge 或 Firefox 则均可。

中文版教程       路线图

更新日志

🦄v2.0 实现与本地文件夹的双向同步，模型管理器支持外部模型路径如 Automatic1111，并可云端同步工作流

v2.0 演示视频：https://youtu.be/7Hht_BMe844

v1.7 ComfyUI 模型管理器，查看已安装的模型、从 civit ai 安装模型、在多个浏览器标签页中打开工作流

使用方法

切换工作流：

🤏通过拖放插入子工作流：

批量导入工作流：

工作流操作：手动保存、下载、放弃未保存的更改：

如何保存我的工作流？

您可以通过点击 💾 软盘图标按钮或使用 ⌨Shift+S 快捷键来保存工作流（您可以在设置中自定义此快捷键）。每次保存都会在 版本历史 中创建一条新记录。您可以像使用 Git 一样，在版本历史中来回切换不同的版本。

默认情况下，我们还启用了自动保存功能，以便在您忘记手动保存时作为缓存。不过，这可能会影响界面性能。如果您遇到界面卡顿，请 ‼️‼️在设置中关闭自动保存功能：

我的工作流和工作区数据存储在哪里？

🗂️ 您的所有工作流都保存在 /ComfyUI/my_workflows 文件夹中，您可以在设置中更改此路径。

其他元数据（版本、图库图片）主要存储在您的浏览器缓存（IndexDB）中，并备份在磁盘的 /ComfyUI/custom_nodes/comfyui-workspace-manager/db/ 目录下。按下 F12 或右键点击浏览器菜单中的“检查”，进入“应用” -> “IndexedDB” -> “comfyui_workspace_db”，即可查看您的数据（工作流、版本历史、图库等）。

如果您更换浏览器，将无法在新浏览器中看到之前的元数据（版本历史、图库图片）。

我们正在寻找合作者和同事 来共同开发这款 ComfyUI 项目管理工具。如果您熟悉 React、Python 或机器学习模型部署，请联系 weixuanfu01@gmail.com。我们的目标是让 ComfyUI 项目的 管理、共享和部署 变得更加简单。

即将推出的功能

1. 一键安装模型
   从网上导入 JSON 工作流时，常常会遇到缺少节点或模型的错误。我们将提供一键从 Hugging Face 和 Civiti 安装缺失模型的功能。

2. 模块化
   现代软件开发项目都是模块化的，整个系统被拆分成不同的模块。在 ComfyUI 中，每个自定义节点都可以视为一个模块，应该具备自包含性，易于安装并与其他模块依赖。这样，这些模块（自定义节点）就可以在不同项目中轻松复用。 ➡️ 我们需要类似 Web 打包工具的东西，例如 webpack 或 vite。这将使每个自定义节点都能自包含，并清晰定义其依赖关系。

3. 多工作流项目
   目前您一次只能处理一个工作流，这限制了构建由多个子工作流组成的大型工作流的可能性。每个工作流都可以被视为一个自定义节点。您应该能够轻松地将一个工作流转换为一个自定义节点，并在项目中重复使用。 ➡️ 我们需要一个跨工作流的项目管理工具，类似于 VSCode 编辑器。

4. 云端运行 / 简易部署
   目前，您需要搭建 Python 环境和 GPU 服务器才能运行 ComfyUI 或 Automatic1111，这对没有 GPU 的用户来说非常不便。您应该能够在不支付 GPU 费用的情况下独立运行 UI 💰。 ➡️ 您可以一键将工作流分享到云端并部署，其他人无需任何设置即可通过浏览器使用云端 GPU 运行。这应该像使用 Google Docs 或 Figma 一样简单。

Beta 预览版

我们一直在 beta 分支上不断推送新功能。以下是切换到 beta 分支以提前获取最新功能更新的方法！这需要您具备一些基本的命令行和 git 知识。

• 确保已安装 git。
• 打开终端，进入 ComfyUI 文件夹（即您执行 python main.py 的目录）。
• 在 ComfyUI 根目录下，依次输入 cd custom_nodes && cd comfyui-workspace-manager。
• 在 custom_nodes/comfyui-workspace-manager 目录内，执行 git fetch origin beta && git checkout beta，您应该会看到类似以下内容：

From https://github.com/11cafe/comfyui-workspace-manager
 * branch            beta       -> FETCH_HEAD
Switched to branch 'beta'
Your branch is up to date with 'origin/beta'.

• 重新启动 ComfyUI Python 服务器：python main.py。

‼️ 请注意，beta 分支可能不稳定，因此请务必备份所有工作流！在切换到 beta 分支之前，请务必将以下文件夹复制到安全位置：

ComfyUI/custom_nodes/comfyui-workspace-manager/db 或者整个 ComfyUI/custom_nodes/comfyui-workspace-manager/ 文件夹。

如果出现问题，您可以随时将这些文件夹恢复原位。此外，您还应始终将 /my_workflows 文件夹（工作区保存目录）妥善保管。

要返回主分支：

• 在 custom_nodes/comfyui-workspace-manager 目录内，执行 git checkout main，然后重启 Python 服务器，您就回到了主分支！

致谢

ComfyUI：https://github.com/comfyanonymous/ComfyUI

ComfyUI 浏览器：https://github.com/talesofai/comfyui-browser（用于参考的媒体显示代码）

同时感谢所有为社区建设贡献力量的自定义节点开发者！

开发说明

1. 克隆 ComfyUI
   git clone https://github.com/comfyanonymous/ComfyUI
   按照 ComfyUI README 中的安装和设置说明进行操作。

2. 克隆 Workspace Manager
   在 /ComfyUI 文件夹中：

cd custom_nodes && git clone https://github.com/11cafe/comfyui-workspace-manager.git

3. 安装 npm 依赖
   进入 /ComfyUI/custom_nodes/comfyui-workspace-manager 目录后，执行 cd ui && npm install，这将安装所有 Node.js 依赖项。

4. 构建并运行
   进入 /ComfyUI/custom_nodes/comfyui-workspace-manager/ui 目录后，执行 npm run build --watch。该命令会监听文件变化并自动重新构建，您只需刷新浏览器即可看到代码更改的效果。

5. 运行 ComfyUI 服务器
   在 /ComfyUI 目录下，根据您的 Python 版本执行 python main.py 或 python3 main.py。

IndexDB 故障排除

如果您在控制台中看到类似以下的 IndexDB 版本不匹配错误：

VersionError: 请求的版本 (10) 低于现有版本 (30)。"
name
:
"DatabaseClosedError"

请手动删除 IndexDB：打开 F12 开发者工具 -> 应用 -> IndexedDB -> WorkspaceManagerDB。

同时删除 localstorage.WORKSPACE_INDEXDB_BACKFILL。

仅建议开发者执行此操作。

ComfyUI Workspace Manager 快速上手指南

⚠️ 重要提示：自 2025 年 4 月 16 日起，由于 ComfyUI 前端已内置工作区管理功能，本插件（comfyui-workspace-manager）已停止维护。如果您使用的是最新版 ComfyUI，建议直接使用官方内置功能。以下指南仅适用于仍希望使用此插件的旧版本用户或特定需求场景。

ComfyUI Workspace Manager 是一款用于集中管理工作流、模型和生成图像的扩展工具，支持版本控制、一键安装模型及子工作流拖拽等功能。

环境准备

• 系统要求：Windows / macOS / Linux
• 前置依赖：
  • 已安装并配置好的 ComfyUI 环境
  • Python 3.8+
  • Git（若选择手动安装）
  • 推荐使用 Chrome 浏览器以获得最佳体验（Safari 兼容性较差）

安装步骤

方式一：通过 ComfyUI Manager 安装（推荐）

1. 启动 ComfyUI，点击右侧菜单中的 Manager 按钮。
2. 在搜索框中输入 ComfyUI Workspace Manager。
3. 点击 Install 进行安装。
4. 安装完成后，重启 ComfyUI 即可生效。

方式二：通过 Git 手动安装

1. 打开终端（Terminal 或 CMD），进入 ComfyUI 根目录。
2. 执行以下命令克隆插件仓库：

cd custom_nodes && git clone https://github.com/11cafe/comfyui-workspace-manager.git

3. 安装完成后，重启 ComfyUI。

💡 V2 版本升级提示：请确保升级到 V2 版本（图标为 🦄 独角兽，而非 V1 的 ☕️ 咖啡杯）。

V2 推荐设置：

• 启用 双向同步 (Two way sync)（未来版本将不再支持非双向同步模式）。
• 确认 My Workspace Save Directory 设置为有效的本地路径。

基本使用

安装重启后，您将在界面中看到新的工作区管理面板。以下是核心功能的最简使用流程：

1. 保存与管理工作流

• 手动保存：点击面板上的 💾 软盘图标，或使用快捷键 Shift+S。
  • 每次保存都会自动生成一个版本历史记录，可随时回滚到任意旧版本。
• 自动保存：默认开启（作为缓存防止丢失），若感到界面卡顿，可在设置中关闭。
• 文件同步：所有工作流默认保存在 /ComfyUI/my_workflows 目录下。您可以直接在操作系统文件管理器中移动文件，插件会自动双向同步更新。

2. 切换与组合工作流

• 切换工作流：在工作区列表中点击任意工作流名称即可无缝切换。
• 子工作流拖拽：选中某个子工作流，直接拖拽到当前画布中，即可将其作为子节点插入现有流程。

3. 模型管理

• 浏览模型：在模型管理器中查看已安装的模型缩略图。
• 一键安装：支持从 Civitai 一键下载模型至对应的 models/ 子文件夹。
• 快速加载：直接将模型缩略图拖拽到画布中，自动生成对应的 "Load Model" 节点。

4. 图像画廊

• 当前工作流生成的所有图片/视频会自动保存在该工作流的画廊中。
• 可右键点击任意生成图，将其设置为该工作流的封面图。

---

注：元数据（如版本历史、画廊图片）主要存储在浏览器的 IndexedDB 中，并备份于 /ComfyUI/custom_nodes/comfyui-workspace-manager/db/。更换浏览器可能导致历史记录不可见，但工作流文件本身不受影响。