常见问题与解决方法
在使用过程中遇到问题？这里汇总了常见问题的解决方法。
🔌 API连接问题
连接失败
OpenAI/Claude等海外模型
问题: 保存时显示"连接失败"
解决方法:
- 检查网络代理（VPN）是否正常工作
- 确认代理设置允许应用访问
- 重新打开代理后再次保存
DeepSeek/火山引擎等国内模型
问题: 连接失败
解决方法:
- 检查API密钥是否正确
- 确认账户余额充足
- 检查是否超出调用频率限制
自定义API地址
问题: 无法连接到自定义API
解决方法:
- 确认API地址格式正确（包含
https://） - 检查端口是否正确
- 确认服务端正常运行
---
常见错误码
| 错误码 | 含义 | 解决方法 |
|---|---|---|
| 401 | API密钥无效 | 检查密钥是否正确 |
| 403 | 访问被拒绝 | 检查账户状态/地区限制 |
| 429 | 请求过于频繁 | 稍后再试/升级套餐 |
| 500 | 服务器错误 | 等待服务恢复 |
| 503 | 服务不可用 | 服务商维护中 |
📥 角色导入问题
PNG图片导入失败
"不包含任何文本块"
原因: 这张PNG不是有效的角色卡，只是普通图片
解决方法:
- 从正规角色卡网站下载带有元数据的PNG
- 确认下载的是角色卡版本，而非普通图片
导入后数据不完整
原因: 角色卡格式版本差异
解决方法:
- 尝试从其他格式（JSON/CharX）导入
- 联系角色作者获取完整版本
### URL导入失败
常见原因:
- 角色设为私有
- 平台未授权第三方访问
- 链接格式不正确
- 网络连接问题
解决方法:
- 尝试下载角色卡文件后本地导入
- 检查网络连接
- 确认链接格式正确
💬 对话问题
AI不回复
检查API状态
- 进入API设置
- 选择当前API配置
- 点击"测试连接"
- 确认连接正常
检查账户余额
部分服务需要预充值，余额不足时无法调用。
检查模型选择
确保选择的模型在你的账户中可用。
### 回复被截断
原因: 达到模型的最大输出长度
解决方法:
- 使用
/continue命令继续生成 - 在设置中增加
max_tokens值 - 选择上下文更长的模型
回复质量不佳
调整采样参数
- 降低 Temperature（更确定性）
- 提高 Temperature（更创意性）
- 调整 Top-P、Top-K 等参数
优化提示词
- 使用更详细的角色描述
- 添加对话示例
- 使用作者注释引导
更换模型
不同模型有不同特点，尝试更换更适合角色扮演的模型。
---
📱 应用问题
应用闪退
解决方法:
- 确保应用是最新版本
- 清理应用缓存
- 重启设备
- 重新安装应用
数据丢失
预防措施:
- 开启自动备份功能
- 定期手动导出重要数据
- 使用iCloud/Google Drive云备份
🔧 性能优化
加载缓慢
- 减少保存的角色数量
- 清理旧的聊天记录
- 关闭不需要的功能（如表情精灵）
耗电严重
- 关闭自动播放TTS
- 减少动画效果
- 使用深色主题（AMOLED屏幕）
❓ 需要更多帮助？
如果以上方法都无法解决你的问题：
- 📧 邮件咨询: [email protected]
- 💬 加入 Discord社区 获取帮助