nodes/AIDC-AI-ComfyUI-Copilot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat: faq

Browse Source
This commit is contained in:
ai-business-hql
2025-09-29 15:21:02 +08:00
parent f5ed21c798
commit f445ccbede
2 changed files with 32 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
assets/FAQ.md
+16 -16
View File
@@ -1,8 +1,8 @@
### Installation Issues
## Installation Issues
**Q: How to properly install ComfyUI-Copilot without errors?**
### How to properly install ComfyUI-Copilot without errors?
**A:** The recommended way is to clone the repo into `ComfyUI/custom_nodes` and install requirements:
The recommended way is to clone the repo into `ComfyUI/custom_nodes` and install requirements:
```bash
cd ComfyUI/custom_nodes
@@ -21,9 +21,9 @@ python_embedded\python.exe -m pip install -r requirements.txt
---
**Q: Why does pip install show dependency conflicts for ComfyUI-Copilot?**
### Why does pip install show dependency conflicts for ComfyUI-Copilot?
**A:** This usually happens due to incompatible OpenAI library versions. Fix by editing
This usually happens due to incompatible OpenAI library versions. Fix by editing
`custom_nodes/ComfyUI-Copilot/requirements.txt` to ensure:
* `openai>=1.5.0`
@@ -36,9 +36,9 @@ pip install --force-reinstall -r requirements.txt
---
**Q: Why does installing via ComfyUI Manager fail?**
### Why does installing via ComfyUI Manager fail?
**A:** Manager may cause permission errors. Solutions:
Manager may cause permission errors. Solutions:
1. Run ComfyUI with admin/root privileges, e.g. `sudo python main.py`.
2. If update fails, delete the Copilot folder and reinstall manually.
@@ -46,31 +46,31 @@ pip install --force-reinstall -r requirements.txt
---
### Runtime & UI Issues
## Runtime & UI Issues
**Q: Why is ComfyUI-Copilot blank or not showing after installation?**
### Why is ComfyUI-Copilot blank or not showing after installation?
**A:** You must click the **Copilot activation button** on the left panel of ComfyUI to enable it.
You must click the **Copilot activation button** on the left panel of ComfyUI to enable it.
Also make sure you paste and save a valid API key, otherwise the panel stays blank.
---
**Q: Why does the Copilot UI break or disappear with a non-default theme?**
### Why does the Copilot UI break or disappear with a non-default theme?
**A:** This is a known bug. Users reported that dark/custom themes cause UI issues.
This is a known bug. Users reported that dark/custom themes cause UI issues.
Workaround: switch back to the **default theme**.
---
**Q: How to get and activate the Copilot API key?**
### How to get and activate the Copilot API key?
**A:** Open Copilot panel → click “*” button → enter your email → you’ll receive an API key.
Open Copilot panel → click “*” button → enter your email → you’ll receive an API key.
Paste the key into the input field and click **Save** to activate.
---
**Q: Does ComfyUI-Copilot support offline mode or local AI models?**
### Does ComfyUI-Copilot support offline mode or local AI models?
**A:** Currently no. Copilot relies on external LLM APIs (e.g. OpenAI GPT, Claude) and requires internet access.
Currently no. Copilot relies on external LLM APIs (e.g. OpenAI GPT, Claude) and requires internet access.
---
assets/FAQ_CN.md
+16 -16
View File
@@ -1,8 +1,8 @@
### 安装相关
## 安装相关
**Q: 如何正确安装 ComfyUI-Copilot？**
### 如何正确安装 ComfyUI-Copilot？
**A:** 推荐方法是在 `ComfyUI/custom_nodes` 文件夹下克隆仓库，并安装依赖：
推荐方法是在 `ComfyUI/custom_nodes` 文件夹下克隆仓库，并安装依赖：
```bash
cd ComfyUI/custom_nodes
@@ -21,9 +21,9 @@ python_embedded\python.exe -m pip install -r requirements.txt
---
**Q: 为什么安装时会遇到 pip 依赖冲突？**
### 为什么安装时会遇到 pip 依赖冲突？
**A:** 主要原因是 OpenAI 相关库版本不兼容。解决方案：修改
主要原因是 OpenAI 相关库版本不兼容。解决方案：修改
`custom_nodes/ComfyUI-Copilot/requirements.txt`，确保依赖如下：
* `openai>=1.5.0`
@@ -36,9 +36,9 @@ pip install --force-reinstall -r requirements.txt
---
**Q: 使用 ComfyUI Manager 安装时出错怎么办？**
### 使用 ComfyUI Manager 安装时出错怎么办？
**A:** Manager 插件可能因权限不足报错。解决办法：
Manager 插件可能因权限不足报错。解决办法：
1. 用管理员权限运行 ComfyUI，例如 `sudo python main.py`。
2. 如果更新失败，删除 `ComfyUI-Copilot` 文件夹，手动重新安装。
@@ -46,31 +46,31 @@ pip install --force-reinstall -r requirements.txt
---
### 运行与界面相关
## 运行与界面相关
**Q: 安装后 Copilot 界面空白或不显示怎么办？**
### 安装后 Copilot 界面空白或不显示怎么办？
**A:** 需要在 ComfyUI 界面左侧点击 **Copilot 启动按钮** 才能激活插件。
需要在 ComfyUI 界面左侧点击 **Copilot 启动按钮** 才能激活插件。
另外必须先输入并保存 API Key，否则界面不会加载正常。
---
**Q: 为什么 Copilot 界面在暗色主题下显示异常？**
### 为什么 Copilot 界面在暗色主题下显示异常？
**A:** 已有用户反馈更换主题后 Copilot 窗口显示不正常。
已有用户反馈更换主题后 Copilot 窗口显示不正常。
解决方法：切换回 **默认主题** 使用。
---
**Q: 如何获取并激活 Copilot API Key？**
### 如何获取并激活 Copilot API Key？
**A:** 在 Copilot 界面点击 “*” 按钮 → 输入邮箱 → 系统会发送 API Key。
在 Copilot 界面点击 “*” 按钮 → 输入邮箱 → 系统会发送 API Key。
将密钥粘贴回输入框并点击 **保存**，即可完成激活。
---
**Q: Copilot 是否支持离线运行或本地模型？**
### Copilot 是否支持离线运行或本地模型？
**A:** 目前不支持。Copilot 依赖远程大语言模型（如 OpenAI GPT、Claude），必须联网使用。
目前不支持。Copilot 依赖远程大语言模型（如 OpenAI GPT、Claude），必须联网使用。
---