AskaEth
793d2ac064
用户实机反馈：单屏窗口化窗口按 F11 全屏后标题栏不消失，退回窗口化反而没标题栏，
表现与预期完全相反。
根因不在标题栏，而在 Console 侧的窗口模式管理：entry 没记录窗口是以什么模式建的，
layout() 每次排布都拿「整机是否单屏」的 single 去覆盖每个已存在窗口的几何与模式
（!single 时会 win.setKiosk(true) + 铺满），而页面 URL 里的 windowed=1 是建窗时定死的、
loadPage 只在页码变化时才重载 —— 于是窗口的真实模式与页面认知脱钩：
窗口化窗口被改成 kiosk 全屏而 URL 仍带 windowed=1（全屏却画标题栏），反向亦然。
修复：建立并保证「窗口几何/模式 ↔ URL 的 windowed 必须永远一致」
- entry 记 { win, page, single, manual, reloadTimer }
- createWindow(..., manual=false)；openOn() 传 manual=true（手动开的窗口不被排布改模式）
- layout() 的 existing 分支：target = manual ? entry.single : single，applyGeometry 与
loadPage 都用同一个 target，且 modeChanged || page 变了都要重载 URL
- 删掉 isKioskWindow()（用 isFullScreen() 反推会把「窗口化窗口被 F11 全屏」误报成 kiosk），
换成 modeOf(entry)
- F11 通信时序：enter/leave-full-screen 回调里不再回读 win.isFullScreen()（切换瞬间可能读到
旧值，页面会收到相反状态），改为下发事件本身的确定值；F11 直接下发算出来的 next
回归测试 console/main/displays.test.js（8 例，assertModeConsistent 四处自洽）。
反向对照：修复前的 displays.js 跑同一份测试是 1 pass / 7 fail。
Console 语法检查 18 个文件、node --test 28 例全过。
Scoreboard · 赛事积分榜系统
一套局域网内部署的赛事成绩与积分系统：一个服务端 + 两个界面，后台一改数据，前台大屏实时跟着变。
| 界面 | 地址 | 用途 |
|---|---|---|
| 实时积分大屏 | /display |
只读、无人值守；成绩发布后 1 秒内更新 |
| 管理面板 | /admin |
录入、发布成绩，控制大屏；未登录可只读查看全部赛事数据 |
功能概览
- 四个榜：总积分榜、团体奖牌榜、个人积分奖牌榜、分项成绩表
- 录入即上屏：成绩录入 → 发布 → 大屏即时更新
- 可追溯、可撤销：草稿不上屏；发布后纠错走「撤销发布 → 改 → 重新发布」，全程留痕
- 变更历史：仿 Git 图谱，一眼看清成绩是怎么变成现在这样的
- 现场公开：积分明细可下钻，争议时一键推送到大屏
- 全屏公告：推送后先全屏显示（5–120 秒），随即常驻大屏底部公告栏，直到替换或清除
- 小项类型齐全：个人 / 团体 / 对抗比赛 / 个人+团体（同一个项目同时按个人与团体通道记分）
- 多显示器：支持多屏各锁一页（kiosk 全屏），也能在管理端为指定显示器单独开窗或收窗
- 规则可配置：积分规则以规则包（YAML）描述，可导入导出、跨赛事复用
- 运动员名册：启用 / 停用 / 彻底删除三档——「停用」保留全部历史数据、随时可启用；「彻底删除」把人员档案连同他名下的报名、成绩与积分流水一起删掉且不可恢复，并自动按新排序重算受影响小项的排名与积分（大屏同步更新）
- 参赛单位名册：启用 / 停用 / 彻底删除三档——「停用」保留全部历史数据、随时可启用；「彻底删除」是假删除，只把单位从列表里移除（界面上没有恢复入口），它的报名、成绩、积分流水与名下运动员全部保留，积分榜不会变化；报名表里再次用到该单位编码会让它自动恢复
- 赛事独立存档：每个赛事一个独立项目目录，整包可导出/导入（含会标、背景图、单位 logo 与上传的字体），并可在管理端页内一键切换当前赛事
- 结果导出：Excel 总表、全部分项、分项成绩表、单位积分明细可分别导出
- 单位 logo：积分榜、奖牌榜、分项成绩表与个人榜都会显示参赛单位 logo
- 大屏字体可配：标题字体与正文字体可在「系统设置 → 赛事信息 → 字体」里从四款内置字体中选，或上传自己的字体（ttf / otf / woff / woff2，单个不超过 20 MiB）；只作用于大屏，加载失败自动回落默认字体，字体文件随赛事项目包一起导出/导入
快速开始
- 解压部署包
- 双击
Scoreboard_Console.exe（现场推荐：守护服务端、把大屏投到扩展屏、防熄屏、开机自启） - 浏览器打开终端提示的地址
大屏 http://<主机IP>:19540/display
管理面板 http://<主机IP>:19540/admin
也可以直接双击
scoreboard.exe（Linux 下执行./scoreboard）只跑服务端，大屏投放与进程守护需自行接管。完全离线运行，不依赖外网，不需要安装任何运行时。
文档
- 上线检查清单：比赛当天照着走一遍的核对表（含交付物、目标机、首次启动、赛事项目包与规则包导入、大屏与公告、备份与回退）
- 部署指南：运行环境、安装与首次启动、端口与配置、大屏接线、赛事项目包导入/切换、备份恢复、故障排查
- 使用手册：角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
- 报名名单导入规范：报名表该用什么格式、11 列逐列怎么填、个人/团体/「个人+团体」三种项目的填法、常见报错对照（可直接发给各单位填表人）
- 常见问题（FAQ）：账号、成绩与积分、大屏、数据备份、导出导入
- 规则包格式：见 rules/README.md
许可证
MIT