常见问题排查

排查时建议先看 Developer Logs，再判断是客户端状态、OmniInfer Server、模型文件、网络还是系统策略问题。

推荐排查顺序

1. 打开 Developer Mode。
2. 查看 Local Server / Remote Server 状态。
3. 查看 Runtime Models 是否有 loaded 模型。
4. 查看 Developer Logs 中最近的 error。
5. 必要时打开独立日志窗口，复制关键日志给支持人员。

Local Server 一直 Offline

可能原因：

• 端口被占用。
• runtime 文件被旧进程锁定。
• 安装目录权限不足。
• OmniInfer 启动失败。

处理建议：

1. 点击 Stop Server 后重新 Start Server。
2. 确认没有残留 omniinfer 进程。
3. 更换一个不容易冲突的端口。
4. 查看 Developer Logs 中的启动阶段耗时和错误。

Chat 页面无法发送消息

常见原因：

• 当前没有 loaded 模型。
• 新建空会话还没有完成创建缓存同步。
• 远程 Server 配置了 Base URL，但连接测试失败。
• 模型加载中，Runtime Models 尚未 Ready。

处理建议：

1. 回到 Developer Mode。
2. 确认 Runtime Models 中至少有一个 Local 或 Remote 模型。
3. 等待状态变为 Ready。
4. 回到 Chat 页面重新选择模型。

远程 Server 测试失败

检查：

• Base URL 是否保留 /v1。
• API Key 是否正确。
• URL 是否可由当前客户端所在网络访问。
• 如果使用 Public Base URL，确认隧道是当前这次启动生成的最新地址。

模型无法下载

可能原因：

• 网络无法访问模型源。
• Hugging Face 源设置不适合当前网络。
• ModelScope 或 Hugging Face API 临时限流。
• 磁盘空间不足。

可以先切换 Hugging Face 访问源，或改用 ModelScope / OmniCore。

安装包被 Windows 拦截

如果 Windows 显示无法验证发布者或智能拦截，通常说明安装包没有被系统识别为可信签名文件，或新版本文件 hash 还没有声誉。请优先使用官网下载链接。正式发布版本建议使用完成 Authenticode 签名的安装包。

Public Base URL 没显示

Public API access 启动后，OmniInfer Server 可能先 Ready，公网 URL 稍后才返回。Developer Mode 会轮询并捕获最新 Public Base URL。若长时间不显示：

1. 确认 Local Server Settings 中已开启对公网开放 API 服务。
2. 重启 Local Server。
3. 查看 Developer Logs 是否出现 Public Base URL captured。