从 Legacy Desktop 迁移

如果您已经安装了 Legacy Desktop，Comfy Desktop 可以检测到它并进行迁移，在 Chooser 视图中创建一个新的 Standalone 安装。

迁移内容

Legacy Desktop 是单实例应用。Comfy Desktop 是多实例管理器。迁移时：

• 工作流和设置 — 复制到新的 Standalone 安装
• 自定义节点 — 扫描后在新环境中重新安装
• 模型 — 您原有的模型文件夹被添加为共享目录（文件保留在原位置）
• 输入文件和输出 — 复制到新安装的共享目录
• Python 环境 — 创建全新的 Python 环境（Legacy 自带的 Python 不会被重复使用）
• ComfyUI 版本 — 新 Standalone 中安装最新版本

Legacy Desktop 安装本身在迁移过程中不会被修改。它保留在您的系统中作为备份。

迁移后的变化

迁移完成后，您的新 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 选项卡并相应更新。

分步迁移

故障排查

Legacy Desktop 未自动检测到

如果未出现迁移提示，您可以手动迁移：

1. 在 Chooser 视图中点击 + 卡片
2. 选择 Legacy Desktop
3. 选择您的 Legacy Desktop 安装并按照提示操作

如果您的现有安装完全未被 Chooser 检测到，您也可以通过 Manage 面板直接添加。有关说明，请参阅 **追踪已有安装**。

迁移失败

• 查看日志：在 Manage 面板的 Console 选项卡中查看错误详情
• 确保 Legacy 安装完整：迁移需要从现有安装读取数据
• 重试：网络问题可能在二次尝试后解决

迁移后模型丢失

模型是作为共享目录路径添加的（不是复制）。如果模型未显示：

1. 打开已迁移安装的 Manage 面板
2. 进入 Settings → Model directories
3. 检查旧模型文件夹是否已列出。如果未列出，请手动添加。