🔳界面与启动排障

本板块收录 LingChat 启动、界面、端口等相关常见问题及解决方法。

启动问题

Lingchat 启动半天都在转圈圈

• 多等一会，初始化时间比较长，在此期间不要关闭，如果最后还是无法启动，那没救了（，你的电脑可能是 20 多年前的老古董

通常每个套接字地址(地址/网络地址/端口)只允许使用一次

• 可能你的上一个 Lingchat 没有关闭，或者有其他从程序占用了 8765 这个端口，你可以检查是哪个程序占用的，把它那个程序给关了

极少数出现：哪个浏览器都卡死在加载页面

• 用记事本打开backend\api\frontend_router.py，把文件内容更换为以下内容，重启程序即可修复：

from fastapi import APIRouter, Request, Response  # 新增 Response
from fastapi.responses import FileResponse
from fastapi.staticfiles import StaticFiles
import os
from pathlib import Path  # 新增 Path 用于更安全的路径操作

router = APIRouter()

root_dir = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
frontend_dir = os.path.join(root_dir, 'frontend', 'public')

# ✅ 自定义 StaticFiles（禁用缓存）
class NoCacheStaticFiles(StaticFiles):
    async def get_response(self, path: str, scope):
        response = await super().get_response(path, scope)
        response.headers["Cache-Control"] = "no-cache, no-store, must-revalidate"
        response.headers["Pragma"] = "no-cache"
        response.headers["Expires"] = "0"
        
        # ✅ 新增：强制修正 JS 文件的 Content-Type
        if path.endswith('.js'):
            response.headers["Content-Type"] = "application/javascript"
            
        return response

# ✅ 托管所有静态资源（保持原有路径结构）
def get_static_files():
    return NoCacheStaticFiles(directory=frontend_dir)

# ✅ 保持原有HTML路由
def get_file_response(file_path: str) -> FileResponse:
    response = FileResponse(file_path)
    response.headers.update({
        "Cache-Control": "no-cache, no-store, must-revalidate",
        "Pragma": "no-cache",
        "Expires": "0"
    })
    return response

# ✅ 新增：方案二修复方法 - 手动处理关键JS文件
@router.get("/app.js")  # 假设这是你的主JS文件
async def serve_app_js():
    js_path = Path(frontend_dir) / "app.js"  # 根据实际路径调整
    if not js_path.exists():
        raise HTTPException(status_code=404)
    
    # ✅ 强制返回正确的 Content-Type
    return Response(
        content=js_path.read_bytes(),
        media_type="application/javascript",
        headers={
            "Cache-Control": "no-cache, no-store, must-revalidate",
            "Pragma": "no-cache"
        }
    )

@router.get("/")
async def index():
    return get_file_response(os.path.join(frontend_dir, "pages", "index.html"))

@router.get("/about")
async def about():
    return get_file_response(os.path.join(frontend_dir, "pages", "about.html"))

@router.get("/settings")
async def settings():
    return get_file_response(os.path.join(frontend_dir, "pages", "settings.html"))

对话问题

提示 402 错误: Your api key is invalid.

• 翻译：你的 API 无效，检查设置里有没有改过秘钥
• 检查是否 API KEY 和 URL 是对应的，硅基流动的秘钥不能给 deepseek 用之类的

提示 402 错误：Insuffient Balance.

• 翻译：你没有余额，假如你用 deepseek，要先充值

Simple Vits API 语音问题

启动提示 py 有问题

• 如果你在解压的时候遇到了错误提示，则软件是无法打开的，推荐使用 Bandzip 解压软件，无广告而且比原版 windows 好用多了。然后使用 Bandzip 解压，无错误则成功

Vits 卡住，提示 Connection 拒绝

• 打开 localhost:23456，随便生成一个语音。如果有错误提示：
• 使用梯子，确保网络环境通畅，首次生成语音会下载国外的东西。
• 如果网页能正常生成语音，则 lingchat 肯定也没问题
• 重启 lingchat，即可修复

提示 speaker_id 不存在

• 没有安装语言模型，把语音模型下载到 data/models/文件夹
• 如果使用的是其他 vits 模型，请人工设置 game_data/characters/人物名/settings.txt 里面的 speaker_id 的值，可以用 0 测试

MeCab初始化失败

• Vits有中文路径导致的，不要包含任何中文路径

生成之后卡死，无报错提示

• 经过测试，部分50系显卡会有这个问题，simple-vits-api似乎暂时不支持部分50系显卡，请使用BERT模型

Style Bert Vits2 语音问题

这个问题太多了，他们写的代码有很大的安装问题。请等待我们日后打包个简单版本