# Electron 桌面端

## 本地开发

```bash
pnpm electron:dev
```

该命令会同时启动 Vite 开发服务器和 Electron，支持前端热更新。

## Windows 打包

```bash
pnpm electron:build
```

也可以直接双击项目根目录的 `build-electron.cmd`。它会自动检查 Node.js/pnpm，在依赖缺失时执行安装，随后构建 Electron 安装包并在成功后打开输出目录。

对应的命令行入口为：

```bash
pnpm electron:package:auto
```

安装包输出到 `release/`。只生成免安装目录用于调试时，可运行：

```bash
pnpm electron:build:dir
```

## API 地址

打包后的应用右上角提供“接口环境”切换器，支持：

- 测试服：`http://8.153.108.90:9996`
- 正式服：`https://event.yuedongsports.com`

选择结果保存在本机，下次启动会继续使用上一次的环境。切换环境时应用会清除当前登录状态，防止跨环境复用 Token。
Electron 的登录 Token 使用窗口级 `sessionStorage` 保存，以兼容 `ydevent://` 自定义协议；关闭应用后需要重新登录。
接口环境面板位于右下角，可点击“收起”隐藏为贴边小按钮；收起状态会被保存。

启动应用前也可以通过环境变量覆盖地址：

```powershell
$env:ELECTRON_TEST_API_URL = 'http://localhost:9996'
$env:ELECTRON_API_ENV = 'test'
pnpm electron:dev
```

可用的覆盖变量为 `ELECTRON_TEST_API_URL` 和 `ELECTRON_PRODUCTION_API_URL`。

## 成绩投屏

Electron 中打开成绩或检录投屏时，会创建独立的无边框全屏窗口。存在多块显示器时，窗口自动放到主操作窗口以外的另一块屏幕；只有一块显示器时，则在当前屏幕全屏显示。