1.9 KiB
1.9 KiB
安装相关
如何正确安装 ComfyUI-Copilot？
推荐方法是在 ComfyUI/custom_nodes 文件夹下克隆仓库，并安装依赖：
cd ComfyUI/custom_nodes
git clone https://github.com/AIDC-AI/ComfyUI-Copilot.git
cd ComfyUI-Copilot
pip install -r requirements.txt
在 Windows 环境下，需使用 ComfyUI 自带的 Python，例如：
python_embedded\python.exe -m pip install -r requirements.txt
（避免使用插件管理器安装时权限问题。）
为什么安装时会遇到 pip 依赖冲突？
主要原因是 OpenAI 相关库版本不兼容。解决方案：修改
custom_nodes/ComfyUI-Copilot/requirements.txt，确保依赖如下：
openai>=1.5.0openai-agents>=0.3.0然后执行：
pip install --force-reinstall -r requirements.txt
使用 ComfyUI Manager 安装时出错怎么办？
Manager 插件可能因权限不足报错。解决办法：
- 用管理员权限运行 ComfyUI，例如
sudo python main.py。 - 如果更新失败，删除
ComfyUI-Copilot文件夹，手动重新安装。 - 手动 Git 安装通常比 Manager 更可靠。
运行与界面相关
安装后 Copilot 界面空白或不显示怎么办？
需要在 ComfyUI 界面左侧点击 Copilot 启动按钮 才能激活插件。 另外必须先输入并保存 API Key，否则界面不会加载正常。
为什么 Copilot 界面在暗色主题下显示异常？
已有用户反馈更换主题后 Copilot 窗口显示不正常。 解决方法：切换回 默认主题 使用。
如何获取并激活 Copilot API Key？
在 Copilot 界面点击 “*” 按钮 → 输入邮箱 → 系统会发送 API Key。 将密钥粘贴回输入框并点击 保存，即可完成激活。
Copilot 是否支持离线运行或本地模型？
目前不支持。Copilot 依赖远程大语言模型（如 OpenAI GPT、Claude），必须联网使用。