# ResearchPad Agent macOS 安装说明

适用系统：macOS 10.15 或更新版本，支持 Apple Silicon 与 Intel Mac。

## 安装

1. 解压下载包。
2. 打开终端，进入解压后的文件夹。
3. 执行：

```bash
bash install.sh
```

安装脚本会自动完成：

- 检测 Node.js。
- 下载并安装 code-server。
- 生成并信任本地 HTTPS 证书。
- 配置本地服务启动项。
- 启动 ResearchPad Agent 本地 IDE 服务。

安装过程中如果系统请求管理员密码，是为了信任本地 HTTPS 证书和写入本地 hosts 备份。

## 使用

安装完成后打开：

```text
https://agent.researchpad.org/
```

首次连接时，本地 IDE 会弹出“ResearchPad 网页端请求连接本地 IDE”。点击“允许连接”后即可使用。

## 排查

如果页面显示 IDE 离线，可执行：

```bash
launchctl kickstart -k gui/$(id -u)/org.researchpad.agent
```

或重新运行：

```bash
bash install.sh
```