YD_Event.Web/ELECTRON.md

Electron 桌面端

本地开发

pnpm electron:dev

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

Windows 打包

pnpm electron:build

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

对应的命令行入口为：

pnpm electron:package:auto

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

pnpm electron:build:dir

API 地址

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

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

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

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

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