5.1 Moss 无响应
典型现象
- 工作台发送消息后一直转圈。
- 输入区提示“快速/思考模型未正确配置”。
- 本地 Ollama 模型提示服务不可达。
- 外部模型返回密钥错误、模型不存在或连接超时。
先看输入区横幅
AI Dock 会主动提示模型配置问题：
| 横幅 | 处理 |
|---|---|
| 快速/思考指向本机 Ollama 但服务不可达 | 打开 3.12 本地大模型，启动服务 |
| 模型不在本机 Ollama 列表 | 到本地大模型页下载对应 tag，或改成列表中完整名称 |
| 远程模型配置不完整 | 打开 设置 → AI 引擎 补全模型名称、Base URL 和 API Key |
外部模型排查
进入 设置 → AI 引擎，测试当前思考或快速模型：
| 错误 | 常见原因 |
|---|---|
| 密钥错误或权限不足 | API Key 复制错、已失效或没有权限 |
| 模型不存在 | 模型名称填错，或 Base URL 不对 |
| 连接超时 | 网络不可达、代理、公司防火墙或服务端繁忙 |
| 服务商错误 | 服务商没有和模型平台对应 |
如果不确定哪一项填错，可以把模型平台的字段说明、 测试失败提示或遮住密钥后的截图发给 Moss，让它帮你逐项对应。API Key 不要直接发到对话中。
本地模型排查
如果使用 Ollama：
- 打开 本地大模型。
- 确认运行环境已安装。
- 确认服务已启动。
- 确认模型列表中存在当前配置的模型名称。
- 点击模型测试。
设备离线不是 Moss 无响应
设备离线时，Moss 仍可做方案和知识回答；只是板端执行会等待重连或再次确认。如果你问的是“执行命令”，先检查设备标签是否在线。