下载与安装

下载安装包

前往由界官方网站下载页面：https://yojex.ai/download

根据你的操作系统选择对应版本：

如何确认 Mac 芯片类型：点击左上角苹果图标 → 关于本机 → 查看"芯片"或"处理器"字段。

安装步骤

Windows

1. 双击下载的 .exe 安装包
2. 如果 Windows 弹出安全提示，选择"是"
3. 按照安装向导点击"下一步"，选择安装路径（默认即可）
4. 点击"安装"，等待安装完成
5. 安装完成后，桌面会出现由界图标，点击即可启动

macOS

1. 双击下载的 .dmg 文件
2. 将由界图标拖拽到"应用程序"文件夹
3. 在启动台（Launchpad）或应用程序文件夹中找到由界，点击打开
4. 如果 macOS 提示"无法打开，因为它来自未知开发者"，请前往：系统设置 → 隐私与安全性 → 安全性 → 点击"仍要打开"

macOS 系统权限授权（仅 macOS）

由界在 macOS 上需要完成以下系统权限授权，才能正常运行沙箱功能。首次启动时，由界会引导你逐步完成，请按顺序操作，完成上一步后再进行下一步。

以上权限均用于沙箱隔离功能，由界不会利用这些权限访问你的个人数据。

首次登录

安装（和权限授权）完成后，进入登录页面：

1. 输入手机号，点击"获取验证码"
2. 收到短信后输入验证码
3. 点击"登录"

首次登录即自动完成注册，无需单独注册步骤。

常见安装问题

Q：Windows 安装时提示"此应用可能会损害你的设备"

由界已通过代码签名认证，此提示由 Windows SmartScreen 触发，属于常规安全提示。点击"更多信息" → "仍要运行"即可正常安装。

Q：macOS 提示"由界已损坏，无法打开"

这是 macOS Gatekeeper 的隔离属性导致的。请在终端运行以下命令后重新打开：

xattr -cr /Applications/YojeX.app

Q：macOS 系统权限授权页面卡住，无法完成某一步

请确保按顺序完成每一步，不要跳过。如果某步骤按钮显示灰色或无法点击，尝试先关闭由界，重新打开后再操作。

Q：安装后无法登录，提示"网络连接失败"

请检查网络设置，确保能正常访问互联网。如果使用代理，请在设置 → 网络代理中配置代理地址。

下一步

安装完成？继续体验：

→ 快速上手指南 — 5分钟创建并运行你的第一个 Agent