在 ComfyUI 内统一管理工作流、模型与生成图像的扩展方案

方案简介

ComfyUI Workspace Manager（又称 Comfyspace）是一个面向 ComfyUI 的扩展插件，目标是把 ComfyUI 用户的工作流、模型、生成图像统一收纳到同一个工作区中进行管理。它解决了 ComfyUI 默认只能手动摆弄 output/、models/ 目录，难以回溯历史、切换多个工作流的痛点。

该扩展面向需要在本地搭建稳定 AI 图像生成工作区的研究者、设计师与 AI 创作者：通过它可以快速在不同 workflow 之间切换、追踪每次保存的版本历史与图像生成记录，并且可以从 Civitai 一键安装模型到对应类型的子目录下。

需要注意，README 顶部公告指出，自 2025-04-16 起，由于 ComfyUI 前端已内置 workspace 管理能力，本插件已标记过时并停止维护。下方文档反映的是仓库当时的功能组合，仍可作为「ComfyUI + 文件系统 + IndexedDB + Civitai」整合方案的设计参考。

亮点与能力

工作流管理能力：

• 🔁 在多个 workflow 之间便捷切换，支持一键在多个浏览器标签页打开同一 workflow。
• 🤏 拖拽当前 workflow 中的子工作流（subworkflow）到画布上，快速拼装复杂流程。
• 🗂️ 使用文件夹组织 workflow（已弃用 tag 机制，统一改为文件夹）。
• 📂 所有 workflow 同步保存到本地目录（默认 /ComfyUI/my_workflows，可在 Settings 中修改），支持与 OS 文件管理器双向同步（Two-way sync），可直接用文件管理器移动文件。
• 🕛 版本控制：每次按 💾 或 ⌨Shift+S 保存时，会在 Version History 中产生一条新记录，可像 git 一样切换/回退版本。
• 支持批量导入 workflow，并可一键 .zip 打包下载所有 workflow。

模型管理能力：

• 从 Civitai 一键安装模型到 models/ 下与模型类型匹配的子目录。
• 列出已安装模型并显示缩略图，拖拽即可在 workflow 中插入对应类型的 load model_type 节点。

图像画廊能力：

• 🖼️ 当前 workflow 每次生成的图像/视频都会进入该 workflow 的 Gallery；可任选一张图设为 workflow 封面。
• 支持深色/浅色模式。
• 计划中：cloud sync & backup workspace；beta 的一键分享 workflow。

浏览器兼容性：README 推荐使用 Chrome，Safari 体验不佳，Edge / Firefox 基本可用。

组成与分工

• ComfyUI：本扩展的宿主与运行环境，所有 workflow 都在 ComfyUI 画布上运行，模型也安装在 ComfyUI 的 models/ 目录之下。
• ComfyUI Manager：作为首选安装渠道，在 ComfyUI Manager 中搜索 ComfyUI Workspace Manager 即可一键安装扩展。
• 本地文件系统（/ComfyUI/my_workflows 与 /ComfyUI/custom_nodes/comfyui-workspace-manager/db/）：前者保存 workflow 文件，后者保存版本历史与画廊等元数据的磁盘备份。
• 浏览器 IndexedDB（comfyui_workspace_db）：主要存放版本历史与 Gallery 图像等元数据，可在浏览器 F12 → Application → IndexedDB 查看。
• Civitai：作为外部模型来源，通过插件内入口一键拉取模型并落到 models/ 对应子目录。

前置要求

硬件与系统：

• 一台可运行 ComfyUI 的主机（通常为带 NVIDIA GPU 的本地机器或远程服务器）。
• 现代浏览器：推荐 Chrome；README 明确提示 Safari 体验不佳，Edge / Firefox 也能用但不是最佳。

前置依赖：

• 已安装并能正常启动的 ComfyUI 主程序。
• 已安装 ComfyUI Manager（仅在使用 Option 1 安装方式时需要）。

安装方式说明：

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

实施步骤

1. 安装扩展（两种方式二选一）

通过 ComfyUI Manager（推荐）：

在 ComfyUI Manager 中搜索 ComfyUI Workspace Manager，点击安装，然后重启 ComfyUI。

通过 git（备选）：

在 ComfyUI 根目录下执行以下命令，然后重启 ComfyUI：

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

2. 升级到 V2 并应用推荐设置

README 建议尽快升级到 V2，确认 ComfyUI 标题区域出现的是 🦄 而不是 ☕️（V1）标识。V2 的推荐设置：

• 开启 two way sync（README 警告：从下一版本起将不再支持非双向同步模式）。
• 确保 My Workspace Save Directory 指向有效路径。

3. 验证安装成功

• 重启 ComfyUI 后，能够在界面上看到 Workspace Manager 的入口与按钮（💾 保存、文件夹、画廊等）。
• 进入浏览器开发者工具：F12 → Application → IndexedDB → comfyui_workspace_db，能查看 workflows、version history、gallery 等数据即代表正常。

使用与配置要点

保存 workflow：

• 点击 💾 按钮，或使用快捷键 Shift+S（可在 Settings 中自定义）。
• 每次保存都会在 Version History 中新增一条记录，可随时切回历史版本，行为类似 git。
• 默认开启了自动保存作为缓存；如出现 UI 卡顿，可在 Settings 中关闭自动保存。

切换 workflow：

• 在 Workspace Manager 的 workflow 列表中点击目标 workflow 即可切换。
• 支持将 workflow 一键在多个浏览器标签页打开。
• 支持 🤏 拖拽把一个 sub-workflow 直接插入当前画布。

组织 workflow：

• 使用文件夹对 workflow 进行分组（README 已说明：tag 已被弃用，请改用文件夹）。
• 通过 OS 文件管理器移动文件，工作区会双向同步该变化。
• 支持批量导入与一键 .zip 打包下载。

管理模型：

• 在 Models Manager 中浏览已安装模型及其缩略图。
• 从 Civitai 一键安装模型，插件会按模型类型放入 models/ 下对应的子目录。
• 通过拖拽，将 load model_type 节点插入到当前 workflow。

图库与封面：

• 每次生成的图像/视频会自动进入当前 workflow 的 Gallery。
• 可将 Gallery 中的任意图像设为该 workflow 的封面。

存储位置与备份：

• workflow 文件主目录：/ComfyUI/my_workflows（可在 Settings 中修改）。
• 版本历史与 Gallery 图像元数据：浏览器 IndexedDB（comfyui_workspace_db），并在 /ComfyUI/custom_nodes/comfyui-workspace-manager/db/ 下做磁盘备份。

注意事项与常见问题

项目维护状态：

README 顶部公告：自 2025-04-16 起，由于 ComfyUI 前端已内置 workspace 管理能力，本插件被标记为过时并将停止维护。下方为项目仍处于维护期时的功能说明。

数据迁移与浏览器：

• 版本历史、Gallery 图像等元数据主要存在浏览器 IndexedDB 中，README 明确警告：如果切换浏览器，将看不到此前的元数据。需要迁移时请使用同浏览器，或依赖磁盘备份目录 /ComfyUI/custom_nodes/comfyui-workspace-manager/db/。

兼容性与性能：

• Safari 用户体验不佳，推荐使用 Chrome。
• 自动保存 workflow 可能拖慢 UI；若感觉 UI 卡顿，请在 Settings 中关闭 autosave。

V2 兼容性：

• 若停留在 V1，不要启用 V2 的「双向同步」与新的 Save Directory 设置；V1 用户请勿套用 V2 推荐配置。
• README 提示下一版本起将停止支持非双向同步模式。

协作邀请：README 末尾公开邀请熟悉 React、Python 或 ML 模型部署的协作者共同推进「管理、分享、部署 ComfyUI 项目」的工作，联系邮箱为 weixuanfu01@gmail.com。

优缺点

• ✓ 一键安装 Civitai 模型
• ✓ 工作流支持文件夹与版本历史
• ✕ 依赖浏览器 IndexedDB，换浏览器
• ✕ Safari 兼容性不佳

出处

本方案挖掘自开源项目 11cafe/comfyui-workspace-manager，方案内容与实施命令均来自其 README 原文。