feat: add FAQ

assets/FAQ.md

@@ -0,0 +1,69 @@
+### Installation Issues
+
+**Q: How to properly install ComfyUI-Copilot without errors?**
+**A:** The recommended way is to clone the repo into `ComfyUI/custom_nodes` and install requirements:
+
+```bash
+cd ComfyUI/custom_nodes
+git clone https://github.com/AIDC-AI/ComfyUI-Copilot.git
+cd ComfyUI-Copilot
+pip install -r requirements.txt
+```
+
+On Windows, use the embedded Python shipped with ComfyUI, e.g.:
+
+```bash
+python_embedded\python.exe -m pip install -r requirements.txt
+```
+
+(Avoid using Manager installation if possible.)
+
+---
+
+**Q: Why does pip install show dependency conflicts for ComfyUI-Copilot?**
+**A:** This usually happens due to incompatible OpenAI library versions. Fix by editing
+`custom_nodes/ComfyUI-Copilot/requirements.txt` to ensure:
+
+* `openai>=1.5.0`
+* `openai-agents>=0.3.0`
+  Then reinstall with:
+
+```bash
+pip install --force-reinstall -r requirements.txt
+```
+
+---
+
+**Q: Why does installing via ComfyUI Manager fail?**
+**A:** 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.
+3. Manual Git installation is generally more reliable.
+
+---
+
+### Runtime & UI Issues
+
+**Q: 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.
+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?**
+**A:** 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?**
+**A:** 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?**
+**A:** Currently no. Copilot relies on external LLM APIs (e.g. OpenAI GPT, Claude) and requires internet access.
+
+---

assets/FAQ_CN.md

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

poster.html

@@ -310,7 +310,7 @@
         <!-- 底部标语 -->
         <div class="bottom-slogan">
             <div class="slogan-line1">探索对AI自动化及工作流</div>
-            <div class="slogan-line2">有深度使用需求的伙伴反馈体验</div>
+            <div class="slogan-line2">有深度使用需求的伙伴尽情体验</div>
         </div>
 
         <!-- 二维码区域 -->