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 相關記錄