故障排除

遇到问题？本指南帮助你快速定位和解决由界常见问题。如果本指南未能解决你的问题，请通过反馈功能联系我们。

安装与启动问题

由界安装失败（Windows）

症状： 安装过程中报错或进度卡住。

解决方案：

1. 确认磁盘剩余空间 > 2GB
2. 以管理员身份运行安装包（右键 → 以管理员身份运行）
3. 暂时关闭第三方杀毒软件，重新安装（安装完成后重新开启）
4. 如仍失败，下载最新版安装包重试

macOS 提示"已损坏，无法打开"

原因： macOS Gatekeeper 的隔离属性。

解决方案： 在终端运行以下命令，然后重新打开由界：

xattr -cr /Applications/YojeX.app

由界打开后白屏或闪退

解决方案（按顺序尝试）：

1. 完全退出由界（包括系统托盘），重新启动
2. 重启计算机后再次尝试
3. 卸载后重新安装（用户数据和 Agent 配置不会丢失）

macOS 系统权限问题

macOS 版由界需要完成五项系统权限授权才能正常工作。首次启动时由界会引导你逐步授权。

权限授权卡住或无法完成

原则：按顺序操作，完成上一步后再进行下一步。

完成授权后沙箱功能仍不正常

1. 完全退出由界
2. 重新打开，再次检查五项权限是否全部显示"已完成"
3. 如仍有问题，尝试在对应系统设置中移除由界后重新添加

登录问题

收不到短信验证码

1. 确认手机号输入正确（无多余空格或字符）
2. 等待 60 秒后重新发送
3. 检查手机是否屏蔽了该号码的短信，或过滤了验证码类短信
4. 尝试更换网络环境（切换 Wi-Fi / 移动数据）

登录提示"网络连接失败"

1. 确认本机网络可以正常访问互联网
2. 如使用代理，在"用户与设置 → 更多"中确认代理配置正确
3. 检查防火墙是否拦截了由界的网络请求

Agent 安装失败

安装卡在进度中不动

解决方案：

1. 检查网络连接是否正常
2. 等待几分钟后，点击"重试"
3. 如使用网络代理，在"用户与设置 → 更多"中确认代理配置正确

安装提示磁盘空间不足

解决方案：

1. 确认磁盘有足够的空闲空间（建议至少保留 5GB）
2. 清理其他不需要的 Agent：在"我的 Agent"列表中找到不用的 Agent，点击管理 → 删除

Agent 启动异常

启动后立即停止

排查步骤：

1. 进入我的 Agent → 控制台标签，查看错误日志
2. 根据错误信息对照下表处理：

Agent 无法联网

原因： 安全设置中"拦截本地网络"开启，或 Agent 需要访问的服务被网络规则限制。

解决方案：

1. 我的 Agent → 安全设置 → 网络权限
2. 根据实际需求调整"拦截本地网络"开关
3. 重试操作

Agent 无响应

症状： Agent 长时间没有输出，对话无响应。

处理步骤：

1. 查看控制台标签，了解 Agent 是否卡在某个操作
2. 在对话框中发送"stop"中断当前任务
3. 如果无响应，点击"停止运行"强制终止
4. 重新下达指令

文件与专属电脑问题

无法访问专属电脑

解决方案：

1. 确认 Agent 处于"运行中"状态（部分入口需要 Agent 在运行状态）
2. 尝试通过不同入口：管理页顶部按钮或底栏右键菜单

Agent 无法读取我的文件

原因： 该目录未被添加到安全设置白名单。

解决方案：

1. 我的 Agent → 安全设置 → 文件权限
2. 确认生效模式为"白名单模式"
3. 点击"添加"，将 Agent 需要访问的目录加入白名单，选择合适的权限（只读/读与写）
4. 点击"更新配置"保存
5. 重试操作

网络问题

由界本身无法连接（无法登录、无法加载 Agent 市场）

排查步骤：

1. 确认本机网络可以正常访问互联网
2. 在"用户与设置 → 更多"中检查网络代理配置
3. 检查防火墙是否拦截了由界的出站连接

性能问题

由界界面卡顿

解决方案：

1. 减少同时运行的 Agent 数量
2. 完全退出由界，重新启动

Agent 资源占用过高

处理步骤：

1. 仪表盘 → 查看各 Agent 的性能详情，确认高占用来源
2. 停止当前高占用的 Agent
3. 如果 CPU/内存持续高占，可能是任务过重，尝试分步骤向 Agent 下达指令

反馈与联系支持

如果以上方案未能解决你的问题，请通过官方网站的提交反馈将问题反馈给我们。

提交时请附上：

• 问题描述（发生了什么、预期是什么）
• 操作系统版本
• 由界版本号（用户与设置 → 更多 → 关于由界）
• 控制台错误日志截图（如有）