本页介绍从 Legacy Desktop（旧版单实例桌面应用）迁移到 Comfy Desktop。如果您是首次使用，可以跳过此页。
正在寻找其他安装方式？
如果您已经有 ComfyUI 安装（portable、手动 git clone 等）并想将其添加到 Comfy Desktop，请参见实例管理中的“追踪已有安装”。
迁移内容
Legacy Desktop 是单实例应用。Comfy Desktop 是多实例管理器。迁移时：- 工作流和设置 — 复制到新的 Standalone 安装
- 自定义节点 — 扫描后在新环境中重新安装
- 模型 — 您原有的模型文件夹被添加为共享目录（文件保留在原位置）
- 输入文件和输出 — 复制到新安装的共享目录
- Python 环境 — 创建全新的 Python 环境（Legacy 自带的 Python 不会被重复使用）
- ComfyUI 版本 — 新 Standalone 中安装最新版本
迁移后的变化
迁移完成后，您的新 Standalone 安装与其他 Comfy Desktop 安装一样工作：- 启动 — 在 Chooser 视图中点击新安装卡片的播放按钮即可启动 ComfyUI。
- 端口 — Legacy Desktop 默认使用端口
8000。新安装会继承此端口设置（以及您曾有的任何其他自定义启动参数）。 - 管理 — 使用 Manage 面板更新、创建快照和配置安装。
- 更新 — Standalone 安装可以通过 Manage 面板独立更新。与 Legacy Desktop 不同，您不再需要为每次更新下载新构建版本。
- 多实例 — 您可以拥有多个并行的 Standalone 安装，每个都有自己的 ComfyUI 版本和配置。
- 共享存储 — 模型默认在所有 Standalone 安装之间共享。输入和输出目录固定到被采用的 Legacy 工作区，因此您现有的文件位置不变。
我的旧链接还能用吗？
Legacy Desktop 默认在端口8000 上运行。新安装会继承端口设置，因此 http://localhost:8000 应该仍然可用。如果您配置过自定义 CLI 参数（例如 --port 8188），这些参数也会一并继承。
如果您使用了 URL 缩短器、书签或引用 Legacy Desktop 应用的其他地址的外部集成，您可能需要检查新安装的 Startup Args 选项卡并相应更新。
分步迁移
安装 Comfy Desktop
从官方下载页面下载并安装 Comfy Desktop。
确认迁移
点击 Migrate Now 继续。Comfy Desktop 将：
- 扫描现有安装（自定义节点、模型、工作流）
- 创建新的 Standalone 安装，包含全新的 Python 环境和最新 ComfyUI
- 复制用户数据（工作流、设置等）
- 复制输入文件和输出
- 将模型文件夹添加为共享目录
- 在新环境中安装自定义节点
故障排查
Legacy Desktop 未自动检测到
如果未出现迁移提示，您可以手动迁移：- 在 Chooser 视图中点击 + 卡片
- 选择 Legacy Desktop
- 选择您的 Legacy Desktop 安装并按照提示操作
迁移失败
- 查看日志：在 Manage 面板的 Console 选项卡中查看错误详情
- 确保 Legacy 安装完整：迁移需要从现有安装读取数据
- 重试：网络问题可能在二次尝试后解决
迁移后模型丢失
模型是作为共享目录路径添加的（不是复制）。如果模型未显示：- 打开已迁移安装的 Manage 面板
- 进入 Settings → Model directories
- 检查旧模型文件夹是否已列出。如果未列出，请手动添加。