ComfyUI-Manager 命令行工具 cm-cli 使用指南

ComfyUI-Manager 命令行工具 cm-cli 使用指南

ComfyUI-Manager 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager

概述

ComfyUI-Manager 是一个强大的 ComfyUI 扩展管理工具，而 cm-cli 则是其配套的命令行界面工具。它允许用户在不启动 ComfyUI 图形界面的情况下，通过命令行完成各种扩展管理操作，非常适合自动化部署、批量操作和服务器环境使用。

安装与环境准备

使用 cm-cli 前需要确保：

1. 必须在运行 ComfyUI 的相同 Python 环境中执行
2. 如果使用虚拟环境，需要先激活虚拟环境
3. 对于便携版 ComfyUI，需要指定正确的 Python 解释器路径

可以通过设置 COMFYUI_PATH 环境变量来指定 ComfyUI 的安装路径，如果未设置，工具会尝试自动推断路径。

基本使用方法

cm-cli 的基本命令格式为：

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

常用命令包括：

• 安装/卸载/更新节点
• 启用/禁用节点
• 查看节点信息
• 管理快照
• 恢复依赖关系

核心功能详解

1. 节点管理

cm-cli 提供了完整的节点生命周期管理功能：

# 安装节点
python cm-cli.py install 节点名称1 节点名称2

# 重新安装节点
python cm-cli.py reinstall 节点名称

# 更新节点
python cm-cli.py update 节点名称

# 更新所有节点
python cm-cli.py update all

# 禁用节点
python cm-cli.py disable 节点名称

# 启用节点
python cm-cli.py enable 节点名称

2. 节点信息查看

可以通过 show 命令查看不同类型的节点信息：

# 查看已安装节点(详细信息)
python cm-cli.py show installed

# 查看已启用节点(简略信息)
python cm-cli.py simple-show enabled

# 查看未安装节点
python cm-cli.py show not-installed

# 查看所有可用节点
python cm-cli.py show all

3. 快照管理

快照功能可以保存和恢复当前的节点配置状态：

# 创建当前配置的快照
python cm-cli.py save-snapshot

# 保存快照到指定文件
python cm-cli.py save-snapshot --output /path/to/snapshot.yaml

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

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

4. 高级选项

渠道和模式选择

通过 --channel 和 --mode 可以指定操作的数据源：

# 从远程获取最新数据更新所有节点
python cm-cli.py update all --channel recent --mode remote

CLI 专用模式

可以启用 CLI 专用模式，禁用图形界面功能：

# 启用 CLI 专用模式
python cm-cli.py cli-only-mode enable

# 禁用 CLI 专用模式
python cm-cli.py cli-only-mode disable

依赖恢复

当需要重新安装所有节点的依赖时：

python cm-cli.py restore-dependencies

使用场景示例

场景1：批量安装常用节点

python cm-cli.py install ComfyUI-Impact-Pack ComfyUI-Inspire-Pack comfyui_controlnet_aux

场景2：服务器环境自动化部署

1. 先保存开发环境的快照
2. 在服务器上恢复快照
3. 恢复所有依赖

python cm-cli.py restore-snapshot production_snapshot.json
python cm-cli.py restore-dependencies

场景3：定期维护更新

# 每周自动更新所有节点
python cm-cli.py update all --mode remote

注意事项

1. 执行安装/更新操作时需要有网络连接
2. 某些操作可能需要管理员权限
3. 快照恢复会修改现有节点配置，建议先备份
4. 在生产环境中使用前，建议在测试环境验证命令

总结

ComfyUI-Manager 的 cm-cli 工具为高级用户和系统管理员提供了强大的命令行管理能力，特别适合需要自动化、批量操作或远程管理 ComfyUI 扩展的场景。通过合理使用快照和批量操作功能，可以大大提高工作效率并确保环境的一致性。

ComfyUI-Manager 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager