极速掌握ComfyUI插件管理：cm-cli命令行工具完全指南

你还在手动管理ComfyUI插件？安装、更新、切换版本时频繁切换界面？遇到依赖冲突束手无策？本文将带你掌握ComfyUI-Manager命令行工具cm-cli，无需启动ComfyUI即可高效管理所有插件，让你的工作流提速10倍！

读完本文你将学会：

• 3分钟上手cm-cli核心命令
• 一键批量更新所有插件的技巧
• 安全管理插件版本的快照功能
• 解决90%插件依赖问题的实战方案

什么是cm-cli

cm-cli是ComfyUI-Manager提供的命令行工具（Command Line Interface，命令行界面），允许用户在不启动ComfyUI图形界面的情况下管理自定义节点（插件）。通过简洁的命令，你可以实现插件的安装、更新、启用/禁用、快照备份等所有核心功能。

工具入口文件位于项目根目录：

• cm-cli.py（Python脚本）
• cm-cli.sh（Linux/macOS可执行脚本）

快速开始

环境准备

cm-cli需要与ComfyUI使用相同的Python环境，确保：

1. 已激活ComfyUI使用的虚拟环境（venv）
2. 如使用便携版ComfyUI，需通过内置Python执行：

.\python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Manager\cm-cli.py --help

基本语法

所有命令遵循以下格式：

python cm-cli.py [命令] [参数] [选项]

查看完整帮助：

python cm-cli.py help

核心功能详解

插件状态查看

使用show命令查看插件状态，支持多种过滤条件：

# 查看已启用插件
python cm-cli.py show enabled

# 简洁模式查看已安装插件
python cm-cli.py simple-show installed

# 查看所有可用插件（包括未安装）
python cm-cli.py show all --mode remote

样例输出：

[    ENABLED    ]  ComfyUI-Manager                                   (author: Dr.Lt.Data)
[    ENABLED    ]  ComfyUI-Impact-Pack                               (author: Dr.Lt.Data)
[    DISABLED   ]  ComfyUI-Loopchain                                 (author: Fannovel16)
[ NOT INSTALLED ]  ComfyUI-AnimateDiff                               (author: huchenlei)

插件安装与管理

安装插件

# 安装单个插件
python cm-cli.py install ComfyUI-Impact-Pack

# 安装多个插件
python cm-cli.py install ComfyUI-Inspire-Pack ComfyUI_experiments

# 从Git URL安装
python cm-cli.py install https://gitcode.com/gh_mirrors/co/ComfyUI-Impact-Pack.git

更新插件

# 更新指定插件
python cm-cli.py update ComfyUI-Impact-Pack

# 更新所有插件（会自动创建快照备份）
python cm-cli.py update all

启用/禁用插件

# 禁用插件
python cm-cli.py disable ComfyUI-Loopchain

# 启用插件
python cm-cli.py enable ComfyUI-Loopchain

# 禁用所有插件
python cm-cli.py disable all

修复插件问题

当插件出现依赖问题或运行错误时：

# 修复单个插件
python cm-cli.py fix ComfyUI-Impact-Pack

# 修复所有插件依赖
python cm-cli.py fix all

快照管理

快照功能可保存当前插件状态，是版本管理的安全网：

# 创建快照
python cm-cli.py save-snapshot --output my_snapshot.json

# 查看快照列表
python cm-cli.py show snapshot-list

# 恢复快照
python cm-cli.py restore-snapshot my_snapshot.json

快照文件默认保存在：snapshots/目录下

高级选项

通道与模式设置

# 使用最新通道和远程模式更新
python cm-cli.py update all --channel recent --mode remote

• --channel：选择插件信息通道（默认：default）
• --mode：数据获取模式（remote：远程最新，local：本地缓存，cache：优先缓存）

依赖管理

# 仅安装插件，不安装依赖
python cm-cli.py install ComfyUI-Impact-Pack --no-deps

# 恢复所有插件依赖
python cm-cli.py restore-dependencies

实战案例

案例1：新环境快速部署

在新系统中快速复现工作环境：

# 克隆项目
git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager.git

# 恢复插件依赖
python cm-cli.py restore-dependencies

# 从快照恢复所有插件
python cm-cli.py restore-snapshot backup_20250101.json

案例2：插件冲突解决

当安装新插件导致冲突时：

# 禁用问题插件
python cm-cli.py disable problematic-plugin

# 查看插件列表确认状态
python cm-cli.py show enabled

# 如仍有问题，恢复到之前快照
python cm-cli.py restore-snapshot before_conflict.json

注意事项

1. 环境变量：可通过COMFYUI_PATH指定ComfyUI路径，未设置时会自动推断
2. 权限问题：Linux/macOS系统可能需要使用sudo权限安装系统级依赖
3. 网络问题：使用--mode cache可在无网络时使用本地缓存数据
4. CLI-only模式：启用后将隐藏GUI按钮，仅允许命令行操作：

python cm-cli.py cli-only-mode enable

总结

cm-cli作为ComfyUI-Manager的命令行工具，提供了比图形界面更高效、更灵活的插件管理方式。无论是日常维护还是自动化部署，掌握这些命令都能显著提升你的工作效率。

核心命令回顾：

• install/update/uninstall：插件生命周期管理
• show/simple-show：状态查看
• save-snapshot/restore-snapshot：版本控制
• fix/restore-dependencies：问题修复

收藏本文，下次遇到插件管理问题时即可快速查阅。关注项目README.md获取最新更新信息。

你最常用的cm-cli命令是什么？欢迎在评论区分享你的使用心得！