Bootstrapper 缺失（watchdog_bootstrapper_missing）

症状

启动 ComfyLauncher 时弹出错误窗口，提示"无法找到 ModelFinder.Bootstrapper.exe"，ComfyUI 无法正常启动。

根本原因

ComfyLauncher 使用 ModelFinder.Bootstrapper.exe 作为辅助进程来启动和管理 ComfyUI。该文件位于安装目录（默认路径 %LocalAppData%\ModelFinder）下，与 ModelFinder.exe 同级。

绝大多数情况下，该文件丢失是因为被杀毒软件误删或隔离。 因为 bootstrapper 是一个非签名的小型可执行文件，杀毒软件的启发式检测容易将其标记为"可疑程序"并自动移入隔离区。以下三款杀毒软件最为常见：

• Windows Defender（Windows 自带）
• 360 安全卫士
• 火绒安全

严重程度

高 — 缺少 bootstrapper 将导致 ComfyUI 完全无法启动。

解决方法

第一步：确认文件是否存在

打开安装目录，检查 ModelFinder.Bootstrapper.exe 是否存在。默认安装路径为：

%LocalAppData%\ModelFinder

在文件资源管理器的地址栏直接粘贴上面的路径即可跳转。如果文件不存在，说明已被杀毒软件删除或隔离，继续执行下面的步骤。

第二步：从杀毒软件恢复文件并加白名单

根据你使用的杀毒软件，选择对应的操作指南。

Windows Defender

查看隔离记录（GUI 方式）

1. 打开"Windows 安全中心"（在开始菜单搜索"Windows 安全"）
2. 点击"病毒和威胁防护"
3. 点击"保护历史记录"
4. 在列表中查找与 ModelFinder 相关的条目
5. 如果找到，点击该条目，选择"操作" -> "还原"

查看隔离记录（PowerShell 方式）

以管理员身份打开 PowerShell，执行以下命令查看最近的威胁检测记录：

Get-MpThreatDetection | Select-Object -First 20 | Format-List DetectionID, ActionSuccess, Resources

也可以使用 Defender 命令行工具列出所有被隔离的文件：

& "$env:ProgramFiles\Windows Defender\MpCmdRun.exe" -Restore -ListAll

添加排除目录

GUI 方式：

1. 打开"Windows 安全中心" -> "病毒和威胁防护"
2. 在"病毒和威胁防护设置"下，点击"管理设置"
3. 向下滚动到"排除项"，点击"添加或删除排除项"
4. 点击"添加排除项" -> "文件夹"
5. 选择 ComfyLauncher 的安装目录（默认 %LocalAppData%\ModelFinder）

PowerShell 方式（需要管理员权限）：

Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\ModelFinder"

执行后可以验证排除项是否已生效：

Get-MpPreference | Select-Object -ExpandProperty ExclusionPath

360 安全卫士

恢复隔离文件

1. 打开 360 安全卫士主界面
2. 点击"木马查杀"（或"安全防护中心"）
3. 查看"隔离区"或"恢复区"
4. 找到与 ModelFinder 相关的文件，勾选后点击"恢复"

添加信任目录

1. 打开 360 安全卫士主界面
2. 点击顶部的安全防护图标（小盾牌/小十字图标），进入"安全操作中心"
3. 切换到"已信任区"标签页
4. 点击"添加目录"
5. 选择 ComfyLauncher 安装目录（默认 %LocalAppData%\ModelFinder）
6. 在弹出的确认窗口中点击"确定"

火绒安全

恢复隔离文件

1. 打开火绒安全主界面
2. 点击左侧的"安全日志"
3. 找到被拦截的 ModelFinder.Bootstrapper.exe 记录
4. 点击"恢复"将文件还原

添加信任目录

1. 打开火绒安全主界面
2. 点击右上角的菜单按钮（三条横线图标）
3. 在弹出的菜单中点击"信任区"
4. 点击"添加文件夹"
5. 选择 ComfyLauncher 安装目录（默认 %LocalAppData%\ModelFinder）
6. 确认添加

第三步：重新安装 ComfyLauncher

如果在隔离区中找不到被删除的文件，需要重新安装来恢复缺失文件：

1. 先完成上面的白名单设置，否则重新安装后文件会再次被删除
2. 从官方渠道下载最新版 ComfyLauncher
3. 安装到原来的目录

安装完成后启动 ComfyLauncher，确认不再出现 bootstrapper 缺失错误。

仍然无法解决？

如果按照以上步骤操作后问题仍然存在，请通过应用内的"联系我们"按钮联系技术支持，并提供以下信息：

• 使用的杀毒软件名称和版本
• 安装目录的完整路径
• 隔离区中是否有 ModelFinder 相关记录