常见问题

本页汇总了 ProxyCast 使用中的常见问题和解决方案。

启动问题

应用无法启动

症状: 双击应用图标后无反应

解决方案:

1. macOS: 右键点击应用，选择"打开"
2. Windows: 以管理员身份运行
3. 检查系统日志查看错误信息

端口被占用

症状: 服务启动失败，提示端口已被使用

解决方案:

# 查找占用端口的进程
# macOS/Linux
lsof -i :8999

# Windows
netstat -ano | findstr :8999

或在设置中更改端口号。

凭证问题

凭证未检测到

症状: 凭证池为空，未显示任何凭证

解决方案:

1. 确认 AI 客户端已安装并登录
2. 检查凭证文件是否存在
3. 点击"刷新凭证"重新扫描
4. 手动添加凭证

详见 凭证错误

Token 过期

症状: 请求返回 401 错误

解决方案:

1. 打开对应的 AI 客户端
2. 确认登录状态
3. 在 ProxyCast 中刷新凭证

连接问题

无法连接到 Provider

症状: 请求超时或连接失败

解决方案:

1. 检查网络连接
2. 确认 Provider 服务正常
3. 检查代理设置

详见 连接问题

SSL 证书错误

症状: 提示证书验证失败

解决方案:

1. 检查系统时间是否正确
2. 更新系统根证书
3. 检查代理是否拦截 HTTPS

API 问题

请求返回错误

常见错误码:

流式响应中断

症状: 流式响应突然停止

解决方案:

1. 检查网络稳定性
2. 增加超时时间
3. 检查 Provider 状态

性能问题

响应缓慢

可能原因:

1. Provider 响应慢
2. 网络延迟高
3. 请求内容过长

解决方案:

1. 切换到更快的 Provider
2. 使用更快的模型
3. 减少请求内容长度

内存占用高

解决方案:

1. 清除请求日志
2. 减少日志保留天数
3. 重启应用

获取帮助

如果以上方案无法解决问题：

1. 查看应用日志
2. 在 GitHub 提交 Issue
3. 提供详细的错误信息和复现步骤