# ResearchPad Agent Windows 预览包安装说明

适用系统：Windows 10 / 11 x64。

当前提供的是 WSL2 预览包，不是最终签名版 `.exe` 安装器。

## 安装

1. 下载 `researchpad-agent-windows-preview.zip` 并解压。
2. 右键开始菜单，打开 PowerShell。
3. 进入解压目录。
4. 执行：

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
.\install.ps1
```

安装器会：

- 检查或安装 Node.js LTS。
- 检查 WSL2 / Ubuntu。
- 在 WSL2 中安装 code-server 和 Agent 扩展。
- 在 Windows 侧安装本地 HTTPS 代理。
- 创建并信任本地 HTTPS 证书。
- 注册登录自启任务 `ResearchPadAgent`。

如果是第一次安装 WSL，Windows 可能会要求重启或完成 Ubuntu 首次用户创建。完成后重新运行 `install.ps1`。

## 使用

安装完成后打开：

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

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

## 启动与停止

```powershell
.\start-agent.ps1
.\stop-agent.ps1
```

正式 Windows `.exe` 安装器会在后续版本中用 Inno Setup / WiX 包装这套脚本，并加入代码签名。