ComfyUI 環境維護小工具 v2.5.3 是專為 ComfyUI 用户打造的圖形界面工具，核心聚焦Python 環境管理與ComfyUI 運行優化，無需複雜命令行操作，即可解決依賴衝突、遷移環境、切換版本等問題，讓 ComfyUI 運行環境始終保持最佳狀態。

---

一、項目核心簡介

這款工具專為 ComfyUI 用户設計，以直觀的圖形界面覆蓋 Python 環境維護全場景。核心優勢包括：無需命令行基礎即可操作，全面檢測並解決包依賴衝突，支持多環境管理與遷移，內置國內鏡像源加速下載，搭配強大的版本管理與命令行功能，滿足各類環境維護需求，保障 ComfyUI 穩定運行。

---

二、版本更新日誌

1. 最新版本：v2.5.3（12 月 3 日）

• 修復 UI 界面中文亂碼問題，統一設置為 yahei 字體，覆蓋所有標籤、按鈕、輸入框等組件

2. 歷史重要更新

• 11 月 30 日：修復依賴檢測 BUG，新增 Python 環境目錄備份 / 恢復功能，自動搜索第三方插件未安裝依賴，新增 git clone 插件、檢測更新、ComfyUI 版本切換功能
• 10 月 7 日（v2.4）：新增環境遷移功能，無需重新安裝所有包，修復已知 BUG
• 10 月 3 日（v2.3）：新增 cmd 命令行執行功能，補充 pip install 參數説明，支持輪子安裝與編譯安裝
• 9 月 17 日：優化環境選擇（下拉列表 + 文本保存）、界面佈局與響應速度，增強鏡像源測試管理，修復兼容性問題

---

三、核心功能詳解

1. 環境管理

支持多 Python 環境快速切換與路徑保存，無需重複尋找環境地址；可完整遷移當前環境至新路徑，避免重複安裝包；提供環境分析（已安裝包及版本）、依賴分析（pipdeptree 可視化）與衝突檢測，生成詳細解決方案。

2. 包管理

支持指定版本安裝、輪子安裝、源碼編譯安裝，以及包的卸載、更新與批量操作；可查看包詳細信息與版本歷史，通過--dry-run模式模擬安裝，提前驗證兼容性。

3. 鏡像源管理

內置阿里雲、清華大學、中科大等國內鏡像源，自動測試連接速度並推薦最優選項，一鍵切換 PyPI 鏡像源，大幅提升包下載效率。

4. 版本管理

實時顯示當前 ComfyUI 版本，支持指定版本切換，自動執行git clean -fd清理未跟蹤文件，搭配--force參數確保切換成功，生成完整日誌便於調試；可識別新初始化 Git 倉庫並顯示 “新倉庫” 狀態。

5. 命令行與其他功能

內置終端可直接執行 cmd 命令，保存命令歷史便於複用，實時顯示執行結果；採用現代化 UI 設計，支持單例運行避免資源衝突，提供詳細錯誤診斷與修復建議，代碼結構優化更穩定。

---

四、系統運行要求

• 操作系統：Windows 7/8/10/11
• Python 版本：3.6 及以上
• 基礎配置：pip 已正確安裝（推薦最新版），至少 4GB 內存，100MB 可用磁盤空間
• 顯示要求：推薦 1280x800 及以上屏幕分辨率
• 網絡需求：部分功能（鏡像源測試、在線安裝）需穩定網絡連接

---

五、使用指南與界面説明

1. 基本操作流程

啓動工具（exe 文件或 Python 腳本）→ 選擇 Python 環境（默認當前環境）→ 配置鏡像源 → 點擊對應功能按鈕執行操作 → 在結果顯示區查看輸出與報告

2. 重點功能使用

• 版本切換：在版本管理區選擇目標版本，點擊切換，通過進度條查看進度，完成後自動更新顯示
• 環境遷移：點擊 “環境遷移”→ 選擇源環境與目標路徑 → 核對信息後確認，通過進度條查看遷移狀態

3. 界面分區説明

頂部導航區（程序名稱、版本、功能菜單）→ 環境配置區（環境選擇、鏡像源設置）→ 功能操作區（包管理、環境分析等）→ 版本管理區（版本顯示與切換）→ 結果顯示區（輸出與報告）→ 進度指示區（操作狀態）→ 命令行執行區（內置終端）

---

下載地址

夸克網盤

https://pan.quark.cn/s/d134dbfd8d9e

迅雷網盤

https://pan.xunlei.com/s/VOg76DW6Agf7aJ0n8iYnc6FaA1?pwd=yczp#