酒馆SillyTavern内部通讯错误怎么解决

如果在使用 SillyTavern 时出现“内部通讯错误”，通常意味着前端（浏览器 UI）与后端服务或 AI 模型 API 之间的通信出现故障。请按以下步骤逐项排查并解决：

1. 确认后端 AI 服务已正确启动并可访问

   • 云端 API（如 OpenAI）：确保环境变量 OPENAI_API_KEY 已正确设置，并在 UI 的“API 连接”中填入了对应 Key。
   • 本地模型（如 Oobabooga TextGen WebUI）：
     1. 在模型目录启动服务，并添加 --api 标志，例如：

        bash
        text-generation-webui --listen --api --port 5000

     2. 在 SillyTavern 的“API 连接”页面，选择“TextGeneration WebUI”，将 URL 填写为 http://127.0.0.1:5000/（不要带 /v1），并确保未勾选“Legacy API”

2. 检查 SillyTavern 服务端监听及跨域设置

   • 默认只监听本机（127.0.0.1:8000）。如果需要在局域网或手机等设备上访问：
     1. 编辑根目录下的 config.yaml，将

        yaml
        listen: true

     2. 配置访问白名单（至少包括 127.0.0.1），例如：

        yaml
        whitelist:
          - ::1
          - 127.0.0.1
          - 192.168.0.0/16

     3. 重启后控制台应显示：

        SillyTavern is listening on IPv4: 0.0.0.0:8000
        

     这样才能允许外部设备正常连接。

3. 控制对话上下文长度，避免超限导致的通信失败

   • 当上下文 Token 数量过多（3–4 万左右）时，可能会频繁出现内部错误。可在 UI 的“响应配置”中将“Context (tokens)”调小，或在“历史消息最大层数”中限制消息条数（如 ≤50 条）。
   • 也可安装MessageLimit 扩展来自动限制每次发送的消息数量。

4. 查看日志定位具体错误

   • 终端日志：在启动 SillyTavern 服务的终端中留意报错信息，若有网络请求失败，可根据报文和状态码（如 ERR_CONNECTION_REFUSED、403 Forbidden、disk I/O error）进一步排查。
   • 浏览器控制台：按 F12 → Network/Console，检查是否有 CORS 错误或跨域被拒的提示，并在 config.yaml 中添加或调整 apiCors: '*'（或启动模型时加入跨域标志）。

5. 更新到最新版本并重启

   • 经常同步最新版 SillyTavern，可修复已知的通信 Bug。Linux 用户：

     bash
     cd SillyTavern
     git pull origin main
     npm install
     ./start.sh

   • Windows/MacOS 用户可运行 UpdateAndStart.bat。

完成上述排查后，绝大多数“内部通讯错误”都能得到解决；如果问题仍然存在，建议将完整的启动/网络日志贴到官方 GitHub Issues 或社区寻求进一步帮助。