logan
2bb4ef7a95
- 集成 tauri-plugin-opener：Cargo/lib.rs/capabilities/npm 四处接线，新增 src/openExternal.ts（桌面走 opener，浏览器回退 window.open，相对路径绝对化） - 关于页 4 个链接、活动栏官网菜单、代理错误横幅 2 处健康检查链接全部改走 openExternal，桌面端可正常跳转 - 设置→外观 主题顺序调整为 深色/浅色/跟随系统 - release 二进制重编并验证（浏览器实测关于页链接可开文档页） - 附带工作区中未提交的扁平化重构现状（另一会话进行中） - homepage 落地页与文档终检通过（8787 / 与 /docs 双 200）
49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
## 环境要求
|
||
|
||
| 组件 | 版本 | 用途 |
|
||
| --- | --- | --- |
|
||
| 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。
|
||
|
||
> **提示**：首次打开会自动创建两个环境（正式 / 本地）和一个覆盖全部协议的示例集合，可随时在「设置」中重置。
|