> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 故障排查

> QoderWake 常见问题、网络诊断表与反馈支持渠道。

本页汇总 QoderWake 使用中的常见问题及排查方法。若问题仍无法解决，可通过反馈渠道提交问题报告。

## 常见问题

### 服务无法启动

* 检查端口是否被占用：在终端执行 `qodercli status` 查看服务状态。
* 强制停止后重启：先执行 `qodercli stop --force`，再执行 `qodercli start --open`。

### Waker 无响应

* 确认服务正在运行（浏览器能正常访问 Web Console）。
* 打开「设置」→「网络设置」，点击连通性测试检查模型 API 是否可达。
* 确认 Waker 的 Identity 配置不为空。

### WakerFlow 运行卡住

* 在运行记录 Tab 中查看各节点状态。
* 检查是否有 `askUser` 节点等待用户输入。
* 确认目标 Waker 是否存在且可用。

### MCP 工具探测失败

* 确认 MCP 服务器进程正在运行。
* 检查传输方式和地址配置是否正确。
* 对需要认证的服务器，确认 OAuth 授权已完成。

## 网络诊断

在「设置」→「网络设置」中：

* 查看各服务端点的连接状态和延迟。
* 点击「测试连接」执行连通性测试。
* 检查代理配置是否正确。

**常见网络问题及解决方法：**

| 问题        | 可能原因       | 解决方式           |
| --------- | ---------- | -------------- |
| 模型 API 超时 | 代理未配置或配置错误 | 在网络设置中正确填写代理地址 |
| SSL 证书错误  | 系统时间不正确    | 校准系统时间         |
| DNS 解析失败  | 网络环境受限     | 检查 DNS 设置或使用代理 |
| 连接被拒绝     | 服务端口被占用    | 更换端口或释放被占用的端口  |

## 反馈与支持

遇到无法解决的问题时，打开「设置」菜单，点击「反馈」选项提交问题报告。提交反馈时系统会自动附带相关诊断信息，帮助定位问题。