# Pi 离线 Playwright MCP 包

包含 Pi MCP bridge、Playwright MCP 和 Chromium 的离线分发包。Linux 包在 Linux 构建；Windows x64 包由 Linux 主机交叉打包官方 Windows 依赖和浏览器生成，尚未在 Windows 实机验证。也可在联网 Windows 机器运行 `build.ps1` 原生重建。

需要 Node.js 18+ 和 npm。Linux 目标机还需 Chromium 的系统共享库；这些系统库不包含在压缩包中，需在联网构建机预先确认，或离线准备目标发行版对应的系统包。

## 构建

Windows PowerShell：

```powershell
Set-ExecutionPolicy -Scope Process Bypass
.\build.ps1
```

Linux：

```bash
./build.sh
```

构建结果在 `dist/`。当前 Linux 包约 312 MB，Windows x64 包约 355 MB。

## 离线安装

解压目标系统对应的归档，在解压目录运行：

```bash
pi install .
```

启动 Pi 前配置环境变量（将示例路径替换为实际解压目录）。

Linux/macOS：

```bash
export MCP_SERVER_CMD=node
export PLAYWRIGHT_BROWSERS_PATH=0
export MCP_SERVER_ARGS='["/完整路径/node_modules/@playwright/mcp/cli.js","--browser","chromium","--headless"]'
pi
```

Windows PowerShell：

```powershell
$env:MCP_SERVER_CMD = "node"
$env:PLAYWRIGHT_BROWSERS_PATH = "0"
$cli = (Resolve-Path .\node_modules\@playwright\mcp\cli.js).Path.Replace('\','/')
$env:MCP_SERVER_ARGS = '["' + $cli + '","--browser","chromium","--headless"]'
pi
```

这些环境变量需在每次启动 Pi 前设置，也可写入 shell profile。Pi 启动后可让它打开网页来验证。

## 说明

- Windows 与 Linux 包不能互换，需分别在对应系统联网构建。
- Linux 的系统级 Chromium 依赖不随包分发；离线目标机若缺少依赖，需另行准备。
- 更新依赖版本后，在各目标系统重新联网构建。
- Playwright MCP 使用 Apache-2.0；pi-mcp-bridge 使用 MIT。