diff --git a/assets/FAQ.md b/assets/FAQ.md index 7f533f9..fddfeb9 100644 --- a/assets/FAQ.md +++ b/assets/FAQ.md @@ -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. --- \ No newline at end of file diff --git a/assets/FAQ_CN.md b/assets/FAQ_CN.md index 7463b42..b072e1b 100644 --- a/assets/FAQ_CN.md +++ b/assets/FAQ_CN.md @@ -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),必须联网使用。 --- \ No newline at end of file