LingChat Docs

Appearance

🚀 LingChat 排障速查 ​

TTS服务问题 ​

问题: TTS服务不可达，语音功能被禁用

可能原因:

  • 防火墙阻止了端口访问
  • simple-vits-api服务未运行
  • 程序需要重新加载服务

解决方案:

  1. 检查并开放防火墙相关端口
  2. 确保simple-vits-api服务已启动
  3. 重新启动LingChat程序

大模型API请求错误 ​

错误代码问题描述解决方案
400无效请求或余额不足检查请求格式或充值API账户
401API密钥无效检查并更新LingChat设置中的API密钥
402余额不足检查API账户余额或充值
403权限不足检查API密钥权限
404资源未找到检查API端点是否正确
405方法不允许检查API文档或联系服务提供商
406不可接受的请求检查请求头或联系开发团队
407请求超时检查网络连接或稍后重试
408连接超时检查网络连接
409请求冲突检查请求参数或联系服务提供商
422参数错误检查所有必需参数
429请求频率过高/请求过多降低请求频率或升级API套餐，减少请求频率或等待一段时间
500服务器内部错误/内部服务器错误稍后重试或联系服务提供商/联系API提供商
502错误的网关检查API服务状态或稍后重试
503服务不可用检查API服务状态或稍后重试
504网关超时检查网络连接或稍后重试
505HTTP版本不受支持检查API文档或联系服务提供商
511需要网络认证检查网络连接
520未知错误检查API服务状态或联系开发团队

端口占用问题 ​

问题: "通常每个套接字地址只允许使用一次"

解决方案:

  1. 请使用netstat -ano查找占用端口的进程
  2. 终止相关进程或更改LingChat使用的端口
  3. 重启计算机（终极解决方案）

ERROR: Could not find Python 3.10, 3.11, or 3.12 using the 'py' launcher. ​

问题: 找不到Python 3.10, 3.11或3.12 解决方案:

  1. 确保已安装Python 3.10, 3.11或3.12,如未安装请前往下载！下载地址"https://www.python.org/downloads/"
  2. 在Windows上，确保Python安装路径已添加到系统环境变量中
  3. 在Linux上，使用update-alternatives --config python设置默认Python版本
  4. 在Mac上，使用brew install python@3.10安装Python 3.10

ERROR: Failed to activate the existing virtual environment. Check if it's corrupted. ​

问题: 无法激活现有虚拟环境，可能已损坏 解决方案:

  1. 尝试重新创建虚拟环境
  2. 检查虚拟环境目录的完整性
  3. 确保使用正确的Python版本
  4. 删除现有虚拟环境并重新创建
    bash
    rm -rf venv
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate  # Windows

ERROR: Failed to install the required packages. ​

问题: 无法安装所需的Python包 解决方案:

  1. 检查网络连接
  2. 确保使用正确的Python版本
  3. 尝试手动安装缺失的包
    bash
    pip install -r requirements.txt

ERROR: Failed to activate the new virtual environment. ​

问题: 无法激活新的虚拟环境 解决方案:

  1. 确保虚拟环境已正确创建，文件地址在"./venv"
  2. 检查虚拟环境目录是否存在
  3. 尝试手动激活虚拟环境
bash
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate  # Windows