Pixelle-Video常见问题排查：安装/配置/报错解决大全
· 阅读需 1 分钟
收集自GitHub Issues和社区反馈的常见问题解决方案。
安装问题
整合包启动失败
- 原因：路径含中文/空格
- 解决：移到纯英文路径
uv 安装失败
- 原因：网络问题
- 解决：设置代理或使用镜像源
配置问题
LLM 连接失败
- 检查API Key是否正确
- 检查网络是否能访问API地址
- 检查防火墙设置
ComfyUI 连接失败
- 确认ComfyUI已启动
- 检查端口（默认8188）
- 点击"测试连接"按钮
生成问题
视频合成失败
- 检查FFmpeg是否安装
- 检查磁盘空间
- 检查输出目录权限
图像质量差
- 调整提示词前缀
- 更换图像模型
- 提高分辨率
性能问题
| 瓶颈 | 解决方案 |
|---|---|
| LLM生成慢 | 换 qwen-turbo 或 DeepSeek |
| 图片生成慢 | 使用 RunningHub 云端 |
| 视频编码慢 | 升级CPU或GPU加速 |