故障排查

本文提供常见问题的快速排查路径。

---

本地服务连接失败

表现：

• 聊天页提示服务未启动
• /health 测试失败
• 发送任务无响应

处理步骤：

1. 打开「设置」。
2. 进入「本地服务配置」。
3. 检查监听端口。
4. 点击「测试 /health」。
5. 点击「保存并重启服务」。
6. 打开控制台查看错误日志。
7. 如果端口被占用，修改端口后重启服务。

---

模型列表为空

表现：

• 模型选择器为空
• 发送任务失败
• 模型选择器为空

处理步骤：

1. 确认已登录 LeapAll 账号。
2. 重新打开 LeapAll。
3. 退出后重新登录。
4. 检查网络。
5. 确认账号是否有可用模型配置。
6. 联系支持人员。

---

余额不足

表现：

• 发送消息失败
• 页面提示余额不足

处理步骤：

1. 打开「钱包」。
2. 查看余额。
3. 完成充值或确认套餐。
4. 点击「刷新余额」。
5. 返回聊天页继续使用。

---

Skill 选择失败

可能原因：

• Skill 未安装
• Skill 被禁用
• Skill 安装失败
• 已安装列表未刷新

处理步骤：

1. 进入「技能商店」。
2. 切换到「已安装」。
3. 点击「刷新列表」。
4. 确认 Skill 状态为启用。
5. 如果列表仍为空，重新安装 Skill。
6. 查看控制台日志。

---

Skill 执行效果异常

可能原因：

• 任务描述过于模糊
• 选错 Skill
• 附件上下文不足
• Skill 版本过旧
• 模型能力不足

处理步骤：

1. 补充任务目标。
2. 明确输出格式。
3. 上传必要附件。
4. 手动选择正确 Skill。
5. 更换更强模型。
6. 更新或重新安装 Skill。

---

附件上传失败

可能原因：

• 文件不存在
• 文件被占用
• 文件权限不足
• 工作区不可写
• 本地服务连接异常
• 文件过大

处理步骤：

1. 重新选择文件。
2. 关闭占用该文件的软件。
3. 检查工作区目录。
4. 测试 /health。
5. 查看控制台日志。
6. 尝试更小文件。

---

技能商店加载失败

可能原因：

• 网络异常
• 账号未登录
• 服务暂时不可用
• 本地缓存异常

处理步骤：

1. 检查网络连接。
2. 确认账号已登录。
3. 点击刷新。
4. 重新打开 LeapAll。
5. 查看控制台日志。

---

修改环境变量后无效

处理步骤：

1. 确认变量格式为 KEY=VALUE。
2. 删除多余空格。
3. 确认引号格式。
4. 点击「保存并重启服务」。
5. 重新测试任务。
6. 查看控制台日志。

---

生成文件打不开

可能原因：

• 文件尚未生成完成
• 文件路径失效
• 文件被移动或删除
• 当前系统缺少对应打开程序
• 工作区权限异常

处理步骤：

1. 等待任务完成。
2. 在聊天消息中重新点击文件。
3. 打开工作区目录查找文件。
4. 检查文件是否存在。
5. 使用对应软件打开。
6. 重新生成文件。