## 环境要求

| 组件 | 版本 | 用途 |
| --- | --- | --- |
| Node.js | ≥ 20 | Web 前端（Vite） |
| Go | ≥ 1.23 | 本地代理服务（Gin） |
| Rust + Cargo | 可选 | 仅编译桌面端（Tauri）时需要 |

## 启动

```bash
git clone <你的仓库地址> opsxapi
cd opsxapi
make install     # 安装依赖（npm install，含桌面端）

./run.sh web     # 启动：Gin(:8787) + Web UI(:5173)
```

看到下面的输出即可打开浏览器：

```bash
[OK] 后端 UP  http://127.0.0.1:8787/health
[OK] Web UP  http://127.0.0.1:5173
```

| 命令 | 说明 |
| --- | --- |
| `./run.sh web` | 浏览器版（推荐） |
| `./run.sh gui` | 桌面窗口（Tauri，共用同一 UI） |
| `./run.sh all` | Web + 桌面一起开 |
| `./run.sh status` / `stop` | 查看状态 / 停止 |

## 30 秒发出第一个请求

1. 打开 <http://127.0.0.1:5173>，左侧是内置的「示例集合」。
2. 点击 **HTTP · httpbin → 获取请求回显**。
3. 点击右上角 **发送**。
4. 下方响应区显示 `200`、耗时与 JSON 高亮响应体 —— 完成！

## 桌面端（可选）

```bash
./run.sh gui
```

桌面端复用同一份界面与数据通道，HTTP 请求走 Tauri 原生网络栈，不依赖浏览器 CORS。

> **提示**：首次打开会自动创建两个环境（正式 / 本地）和一个覆盖全部协议的示例集合，可随时在「设置」中重置。