feat(console,admin): kiosk 不再点击穿透 + 压住任务栏；大屏控制页新增「局域网大屏」（链接/复制/二维码）dev_0.4.0
## ① 现场问题：kiosk 窗口点击穿透（原设计方向反了） `displays.js` 原来对多屏 kiosk 调 `setIgnoreMouseEvents(true)`，注释写的是 「防止现场误触」——但该 API 的语义是「本窗口忽略鼠标」，点击会**落到它后面的 窗口或桌面**，现场想防的误触正好变成误点别的东西；被忽略鼠标的窗口也点不活。 现在窗口**默认吞掉鼠标、不穿透**。 配置项**改名**为 `display.allowClickThrough`（缺省 false；显式 true 才穿透）。 **旧键 `display.ignoreMouse` 完全不读**——老机器的配置文件里还写着旧版模板留下的 `ignoreMouse: true`，而配置策略是「已存在不覆盖」，只改默认值等于老机器升级后 照样穿透；改名才能让默认值真正生效。启动时若发现旧键会记一条中文提示（只记一次）， 并在合并后的配置里把它剥掉，防止将来有人再读到那个陈年 true。 （不是自动改写用户配置文件：无法区分「操作员刻意写的 true」与「旧模板留下的 true」。） ## ② 现场问题：任务栏盖住 kiosk 窗口、被盖住后抢不回前台 原顺序是 `setKiosk(true)` 之后又 `setBounds(...)`，在 Windows 上会把窗口从真正的 全屏态拽回「恰好铺满该屏的无边框窗口」→ 不是 topmost，任务栏与拖过去的窗口都盖得住。 现在固定为 **先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后 `setAlwaysOnTop(true, 'screen-saver')`**（默认层级 `floating` 在 Windows 上仍画在任务栏下面），并加了 「已达标就不重复进出 kiosk」的守卫避免重排白闪；非 kiosk 分支会摘掉置顶。 Win 真机行为需现场复核，代码/桩级已验（含顺序与层级的断言）。 ## ③ 新功能：大屏控制页「局域网大屏」卡片 - 服务端新增 `GET /api/system/network`（recorder 及以上）：回本机可用局域网 IPv4 （排除回环/link-local/IPv6，去重，按 192.168/10/172.16-31 优先排序）+ 真实监听端口 + 路径；无地址回 `[]` 不报错。 - 卡片：每个地址一条可点击链接 + 复制按钮，第一个地址配二维码（148px）。 - **二维码是离线自实现的纯 TS 编码器**（版本 1–40 自动、ECC L/M/Q/H、8 种掩码择优）， 正确性用 **Python OpenCV 真解码**验收：29/29 条解出原文（含中文与边界）， SVG 渲染后再解码 4/4，并把验证过的矩阵冻结成仓库参照用例。 - 复制按**非安全上下文**处理：面板常从 `http://192.168.x.x` 打开，那里 `navigator.clipboard` 是 undefined，自动回退 `execCommand('copy')`。 ## ④ 真机联调抓出并修掉一个时序缺陷（真浏览器 + 真服务端） `DisplayPage` 的 `refreshLan()` 在挂载时跑，而 `auth` 是异步加载的——那一刻 `auth.readOnly` 必然为 true，卡片把「当前为只读访客」写进一个**普通 ref** 就返回了， 身份落定后没有任何东西再触发它：**管理员登录后卡片永远停在访客态， `/api/system/network` 一次都没被请求**。 改为「gate 由 computed 直接渲染 + watch gate 变 null 时重跑加载」，并补回归钉子。 （同时修正了一条把该错误结构当成正确行为的源码断言用例。） 端到端证据：真服务 + 局域网 IP（真非安全上下文）→ 卡片列出两个地址、点击复制变 「已复制」（走 execCommand 回退）→ 浏览器渲染的二维码截图经 cv2 解出 `http://10.50.101.85:19861/display`。 ## 文档 部署指南配置表与多屏行为、使用手册「大屏控制」与局域网设备段、devdocs 05/07/10/13、 升级说明新增 dev_0.4.0（含旧键废弃与启动提示）。**无数据迁移**，旧赛事包照常导入。 自检：服务端 13 包 ×2；前端 vue-tsc + 645 例 ×2 + build；Console 20 文件 + 68 例。
This commit is contained in:
AskaEth committed
1 parent
ed2c0b3f3c
commit
9ef68c2589
33 files changed
+2923
-95
No files matched your search
+6
-4
@@ -121,9 +121,9 @@ electron-builder 生成的卸载器结尾是 `RMDir /r $INSTDIR`，而**覆盖
|
||||
|
||||
| 场景 | 行为 |
|
||||
| --- | --- |
|
||||
| 只有一块屏 | 窗口化（屏幕 80% 大小、居中），不做多屏编排，**不跟随** `display-metrics-changed`（分辨率/缩放变化不重排，行为冻结）；`display-added` / `display-removed` 一直听着，电视插回来会自动排布回 kiosk。监听常驻、只有 `closeAll()`（服务停止 / 应用退出）才摘（回归测试见 `main/displays.test.js`）；`F11` 手动切换全屏，窗口级全屏状态经 `display-preload.js` 下发给页面，页面据此收起自绘标题栏 |
|
||||
| 只有一块屏 | 窗口化（屏幕 80% 大小、居中），不做多屏编排，**不跟随** `display-metrics-changed`（分辨率/缩放变化不重排，行为冻结）；`display-added` / `display-removed` 一直听着，电视插回来会自动排布回 kiosk。监听常驻、只有 `closeAll()`（服务停止 / 应用退出）才摘（回归测试见 `main/displays.test.js`）；`F11` 手动切换全屏，窗口级全屏状态经 `display-preload.js` 下发给页面，页面据此收起自绘标题栏。窗口化窗口**不置顶、不穿透**：F11 全屏完全由用户控制，置顶会把它变成一块收不掉、盖住一切的覆盖层 |
|
||||
| 模式与 URL | **必须永远一致**：模式（窗口化 / kiosk）记在窗口的 entry 上，谁改模式谁按新模式重载 URL。`layout()` 只对排布自己开的窗口套用全局 `single`，管理面板手动开的窗口保持自己的模式——否则会出现「窗口化窗口被改成 kiosk 全屏、URL 里还留着 `windowed=1`」这种页面认知与窗口真实模式脱钩、标题栏画反的问题（回归测试见 `main/displays.test.js`）|
|
||||
| 多块屏 | 除内置屏外的每块屏一个 kiosk 窗口，按 `display.bounds`（DIP）定位，窗口 `setIgnoreMouseEvents(true)`，光标由页面 CSS 隐藏 |
|
||||
| 多块屏 | 除内置屏外的每块屏一个 kiosk 窗口，按 `display.bounds`（DIP）定位，光标由页面 CSS 隐藏。窗口**默认吞掉鼠标、不穿透**：`setIgnoreMouseEvents(true)` 的语义是「本窗口忽略鼠标」，点击会落到它后面的窗口或桌面上（现场想防的误触反而变成误点别的东西），被忽略鼠标的窗口也点不活、抢不回前台；只有确实要把大屏当纯展示层、同一块屏上还要操作别的窗口时才显式配 `display.allowClickThrough: true`。这个开关是从 `display.ignoreMouse` **改名**来的：旧版默认穿透，而且旧版模板已经把 `ignoreMouse: true` 写进了现场机器的用户配置（`userpaths.js` 不覆盖用户文件），只改默认值救不了老机器——换个新键名，旧键自然失效；启动时若发现配置里还留着旧键，会在 `logs/console.log` 里记一条提示（只记一次），说明它已废弃、现在默认不穿透、想穿透该写哪个键。窗口**置顶在 `screen-saver` 层级**（Windows 上 `setAlwaysOnTop(true)` 的默认层级 `floating` 仍画在任务栏下面，只有 pop-up-menu 及以上才压得住任务栏），所以别的窗口拖到这块屏上盖不住它、任务栏也盖不住它，被盖住后点一下就能回到最前。调用顺序**必须**是「先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后置顶」：反过来会把窗口从真正的全屏态拽回「恰好铺满该屏的无边框窗口」，既不是 topmost、也压不住任务栏（回归测试见 `main/displays.test.js`）|
|
||||
| 选屏 | 运行时枚举，不写死坐标；`selection` 可选 `all-secondary`（默认，用 `display.internal` 排除内置屏）/ `all` / `specified` |
|
||||
| 页面锁定 | 每块屏各锁一页，URL 形如 `http://127.0.0.1:19540/display?page=standings&lock=1&screen=<id>&instance=<host>-<id>`，页序按 `display.pages` 轮转 |
|
||||
| 防熄屏 | Console 启动即生效，退出时释放；前台后台都算 |
|
||||
@@ -163,7 +163,8 @@ electron-builder 生成的卸载器结尾是 `RMDir /r $INSTDIR`，而**覆盖
|
||||
| `display.pages` | `["standings","medals","individual","results"]` | 按屏序轮转锁定；只填大屏支持的页名 |
|
||||
| `display.pageParam` | `page` | 页面 URL 参数名 |
|
||||
| `display.kiosk` | `true` | 多屏时是否 kiosk（单屏恒窗口化） |
|
||||
| `display.ignoreMouse` | `true` | 多屏窗口是否忽略鼠标 |
|
||||
| `display.allowClickThrough` | `false` | 多屏 kiosk 窗口是否**允许点击穿透**（`setIgnoreMouseEvents(true)`）。写 `true` 后该窗口忽略所有鼠标事件：点击落到它后面的窗口/桌面（现场误触会点到别的东西），大屏也点不活、被盖住后抢不回前台。只把大屏当纯展示层、且要在同一块屏上操作别的窗口时才开 |
|
||||
| `display.ignoreMouse` | — | **已废弃 → 见 `display.allowClickThrough`**。旧版默认 `true` 且被旧模板写进现场机器的用户配置，只改默认值救不了老机器，所以换了键名；本键现在**完全不读**，配置文件里留着它只会让启动日志多一条提示，不影响行为 |
|
||||
| `display.reloadEveryHours` | `24` | 定时重载兜底，0 = 关闭 |
|
||||
| `display.waitForServerMs` | `20000` | 服务端未就绪时开大屏的兜底等待 |
|
||||
| `display.backgroundColor` | `#0b0f1a` | 窗口底色，减少加载白闪 |
|
||||
@@ -171,7 +172,7 @@ electron-builder 生成的卸载器结尾是 `RMDir /r $INSTDIR`，而**覆盖
|
||||
| `admin.width` / `admin.height` | `1280` / `860` | 管理窗口初始尺寸（服务端管理面板窗口按 `width` 不小于 1100 取用） |
|
||||
| `log.maxLines` / `log.file` / `log.maxFileBytes` | `2000` / `logs/console.log` / `4194304` | 日志缓冲与文件；`log.file` 相对部署包根目录解析（不随配置搬到用户数据目录） |
|
||||
|
||||
配置缺项自动用内置默认值，文件不存在或 JSON 语法错误时回落到全默认值，并在管理窗口顶部给出提示。
|
||||
配置缺项自动用内置默认值，文件不存在或 JSON 语法错误时回落到全默认值，并在管理窗口顶部给出提示。配置里如果还留着已改名的旧键（目前是 `display.ignoreMouse`），启动时会在 `logs/console.log` 里记一条中文提示（只在启动记一次，不随大屏重排重复刷），说明该键已废弃、现在默认不穿透、要穿透该写哪个键；旧键的值一律忽略，**不会**被自动改写进用户的配置文件。
|
||||
|
||||
## 打包（electron-builder）
|
||||
|
||||
@@ -198,6 +199,7 @@ pnpm pack # 只出目录，不生成安装包，便于现场调试
|
||||
以下内容只做了静态语法检查，需要在 Windows + 真实多显示器环境跑一遍：
|
||||
|
||||
- 多屏 kiosk 定位与 `display-metrics-changed` 重排（改分辨率 / 缩放 / 插拔 HDMI）。
|
||||
- kiosk 窗口的置顶（`setAlwaysOnTop(true, 'screen-saver')`）与任务栏覆盖：能否稳定压住任务栏、别的窗口拖到该屏上会不会盖住它、点击后能否回到最前——`screen-saver` 层级在 Windows 上的实际效果只能在真机上验；`setKiosk` / `setBounds` 的先后顺序同理（Linux 开发机没有 Electron 运行时）。
|
||||
- 管理面板显示器菜单：真正的 kiosk 全屏 / 窗口化结果、`screen.getAllDisplays()` 的 `label` 与主屏判定、`display:list` 返回的 scaleFactor 是否与现场一致。
|
||||
- `powerSaveBlocker` 在长时间后台下的实际效果。
|
||||
- 托盘图标在 Windows 任务栏的显示效果（16px 缩放）。
|
||||
|
||||
+1
-1
@@ -19,7 +19,7 @@
|
||||
"pages": ["standings", "medals", "individual", "results"],
|
||||
"pageParam": "page",
|
||||
"kiosk": true,
|
||||
"ignoreMouse": true,
|
||||
"allowClickThrough": false,
|
||||
"reloadEveryHours": 24,
|
||||
"waitForServerMs": 20000,
|
||||
"backgroundColor": "#0b0f1a"
|
||||
|
||||
+54
-4
@@ -38,7 +38,16 @@ const DEFAULTS = {
|
||||
pages: ['standings', 'medals', 'individual', 'results'],
|
||||
pageParam: 'page',
|
||||
kiosk: true,
|
||||
ignoreMouse: true,
|
||||
// 多屏 kiosk 窗口是否**允许点击穿透**（写 true 才穿透）。默认 false = 窗口吞掉点击，
|
||||
// 可以点活、被盖住后能抢回前台。
|
||||
// 这个键是 display.ignoreMouse 改名来的，**为什么换键名而不是只改默认值**：
|
||||
// 旧版默认 true，而且旧版模板已经把 ignoreMouse: true 写进了现场机器的
|
||||
// <用户根>\console\config.json，userpaths.js 的策略是「已存在就绝不覆盖」——
|
||||
// 光把默认值改成 false 救不了老机器（文件里那个显式 true 会一直压着默认值），
|
||||
// 我们也没法区分「操作员刻意要穿透」和「旧模板留下的 true」（去改用户文件就是猜）。
|
||||
// 换个新键名，老文件里的旧键自然失效，现场不动配置文件就回到不穿透；
|
||||
// 确实要穿透的再显式写 allowClickThrough: true（旧键会触发一条启动提示，见 loadConfig）
|
||||
allowClickThrough: false,
|
||||
reloadEveryHours: 24,
|
||||
// 服务端迟迟没就绪时的兜底：超时后也把大屏开出来，避免现场一片黑
|
||||
waitForServerMs: 20000,
|
||||
@@ -83,12 +92,51 @@ function readJson(file) {
|
||||
}
|
||||
}
|
||||
|
||||
// 改名过的配置键：旧键 → 新键。只提示、**不自动迁移**——改现场机器上的配置文件不是
|
||||
// Console 该做的事，而且「操作员刻意写的」和「旧模板留下的」在文件里长得一模一样，猜错就改了人家的意图。
|
||||
const RENAMED_KEYS = {
|
||||
'display.ignoreMouse': 'display.allowClickThrough'
|
||||
}
|
||||
|
||||
// 看看持久化的配置文件里还留着哪些废弃键。读的是**文件里真实写了什么**（readJson 的原始值），
|
||||
// 不是 merge 之后的结果：merge 出来的值一律带 DEFAULTS，拿它判断会把每个键都当成「用户写过」。
|
||||
// 只在这里算一次、由 index.js 在启动时记一次，绝不在 layout/重排路径里判断，否则日志会被刷爆。
|
||||
function deprecatedKeyNotices(values) {
|
||||
const notices = []
|
||||
// 配置文件内容可能是 null / 数组 / 字符串（JSON 语法合法但不是对象），一律当作「没有旧键」
|
||||
if (!isPlainObject(values)) return notices
|
||||
for (const [oldKey, newKey] of Object.entries(RENAMED_KEYS)) {
|
||||
const [section, key] = oldKey.split('.')
|
||||
if (!isPlainObject(values[section]) || !(key in values[section])) continue
|
||||
notices.push(
|
||||
`配置项 ${oldKey} 已废弃、不再生效：本机配置文件里写的 ${key}: ${JSON.stringify(values[section][key])} 会被忽略。` +
|
||||
`大屏窗口现在默认「不穿透」，点击不会再漏到大屏后面的窗口或桌面；` +
|
||||
`要让大屏恢复点击穿透，请改用 ${newKey}: true`
|
||||
)
|
||||
}
|
||||
return notices
|
||||
}
|
||||
|
||||
// 把改名前的旧键从**合并后的配置**里删掉：要让「旧键失效」彻底一点，
|
||||
// 不能只做到「没人读它」——merge 是通用深合并，旧键会原样留在 cfg.values.display 里，
|
||||
// 以后谁再加一行读旧键的代码，就会读到老机器配置文件里那个陈年 true。
|
||||
// 只动这份内存里的配置，绝不写回用户文件（现场那份要原样留着，人自己决定怎么改）。
|
||||
function stripRenamedKeys(values) {
|
||||
for (const oldKey of Object.keys(RENAMED_KEYS)) {
|
||||
const [section, key] = oldKey.split('.')
|
||||
if (isPlainObject(values[section])) delete values[section][key]
|
||||
}
|
||||
return values
|
||||
}
|
||||
|
||||
function loadConfig(configPath) {
|
||||
const { values, warning } = readJson(configPath)
|
||||
return {
|
||||
path: configPath,
|
||||
values: merge(DEFAULTS, values),
|
||||
warning
|
||||
values: stripRenamedKeys(merge(DEFAULTS, values)),
|
||||
warning,
|
||||
// 提示按**文件里真实写了什么**算，所以传的是 readJson 的原始值，不是上面那份合并结果
|
||||
notices: deprecatedKeyNotices(values)
|
||||
}
|
||||
}
|
||||
|
||||
@@ -123,4 +171,6 @@ function resolveExecutable(exe, configPath, baseDir) {
|
||||
return { path: found || candidates[0], candidates: [...new Set(candidates)] }
|
||||
}
|
||||
|
||||
module.exports = { loadConfig, updateConfig, resolveExecutable }
|
||||
// DEFAULTS 一并导出：displays.test.js 用它断言「随包发布的默认值」本身
|
||||
// （例如 display.allowClickThrough 必须是不穿透），测试里自己写死一份就验不到默认值被改回去
|
||||
module.exports = { DEFAULTS, loadConfig, updateConfig, resolveExecutable }
|
||||
@@ -0,0 +1,87 @@
|
||||
'use strict'
|
||||
|
||||
const assert = require('node:assert/strict')
|
||||
const fs = require('node:fs')
|
||||
const os = require('node:os')
|
||||
const path = require('node:path')
|
||||
const test = require('node:test')
|
||||
|
||||
const { DEFAULTS, loadConfig } = require('./config')
|
||||
|
||||
function makeDir(t) {
|
||||
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'scoreboard-config-'))
|
||||
t.after(() => fs.rmSync(dir, { recursive: true, force: true }))
|
||||
return dir
|
||||
}
|
||||
|
||||
// 现场机器上那份用户配置：内容原样写进文件，读的也必须是文件里真实写了什么
|
||||
function loadWith(t, raw) {
|
||||
const dir = makeDir(t)
|
||||
const file = path.join(dir, 'config.json')
|
||||
fs.writeFileSync(file, typeof raw === 'string' ? raw : JSON.stringify(raw, null, 2), 'utf8')
|
||||
return loadConfig(file)
|
||||
}
|
||||
|
||||
test('缺省的 allowClickThrough 不穿透（默认值就是 false）', (t) => {
|
||||
assert.equal(DEFAULTS.display.allowClickThrough, false)
|
||||
const cfg = loadWith(t, { display: {} })
|
||||
assert.equal(cfg.values.display.allowClickThrough, false)
|
||||
assert.deepEqual(cfg.notices, [])
|
||||
})
|
||||
|
||||
test('显式写 allowClickThrough: true 才穿透，且不产生废弃提示', (t) => {
|
||||
const cfg = loadWith(t, { display: { allowClickThrough: true } })
|
||||
assert.equal(cfg.values.display.allowClickThrough, true)
|
||||
assert.deepEqual(cfg.notices, [])
|
||||
})
|
||||
|
||||
// 本次修复的核心回归钉子：老机器升级后，用户配置文件里那个旧版模板写下的
|
||||
// ignoreMouse: true 必须彻底失效（userpaths.js 不会覆盖用户文件，只能靠不读旧键）
|
||||
test('老配置里的旧键 ignoreMouse 已失效：既不生效、也不再是穿透开关', (t) => {
|
||||
const cfg = loadWith(t, { display: { ignoreMouse: true } })
|
||||
|
||||
assert.equal('ignoreMouse' in DEFAULTS.display, false, 'DEFAULTS 里不能再有旧键')
|
||||
assert.equal(cfg.values.display.allowClickThrough, false, '旧键 true 不能把穿透带回来')
|
||||
assert.equal(cfg.values.display.ignoreMouse, undefined, '旧键不该被 merge 进最终配置')
|
||||
|
||||
// 但必须留下一条一次性提示，让现场知道该改哪个键
|
||||
assert.equal(cfg.notices.length, 1)
|
||||
const [notice] = cfg.notices
|
||||
assert.match(notice, /display\.ignoreMouse/)
|
||||
assert.match(notice, /display\.allowClickThrough/)
|
||||
assert.match(notice, /废弃/, '要明说这个键已经不用了')
|
||||
assert.match(notice, /不穿透/, '要明说现在的默认是不穿透')
|
||||
assert.match(notice, /true/, '要给出「确实想穿透」的写法')
|
||||
})
|
||||
|
||||
test('旧键提示只跟着「文件里写了旧键」出现，缺省或新键都不提示', (t) => {
|
||||
// 旧版模板整份配置（现场最常见的形态）：只提示一次，不会按重排/每帧刷
|
||||
const legacyTemplate = loadWith(t, {
|
||||
display: { selection: 'all-secondary', kiosk: true, ignoreMouse: true }
|
||||
})
|
||||
assert.equal(legacyTemplate.notices.length, 1)
|
||||
|
||||
// 新模板（已去掉旧键、写上 new key）不再提示
|
||||
const currentTemplate = loadWith(t, {
|
||||
display: { selection: 'all-secondary', kiosk: true, allowClickThrough: false }
|
||||
})
|
||||
assert.deepEqual(currentTemplate.notices, [])
|
||||
|
||||
// 两个键都在：仍然按「有旧键」提示一次（提示说的是旧键不生效，与新键无关）
|
||||
const both = loadWith(t, { display: { ignoreMouse: true, allowClickThrough: true } })
|
||||
assert.equal(both.notices.length, 1)
|
||||
assert.equal(both.values.display.allowClickThrough, true, '新键显式 true 仍然算数')
|
||||
})
|
||||
|
||||
test('配置文件读不出来/内容不是对象时不报废弃键、也不炸', (t) => {
|
||||
const missing = loadConfig(path.join(makeDir(t), 'nope.json'))
|
||||
assert.deepEqual(missing.notices, [])
|
||||
assert.equal(missing.warning !== null, true)
|
||||
assert.equal(missing.values.display.allowClickThrough, false)
|
||||
|
||||
const broken = loadWith(t, '{ 这不是 JSON')
|
||||
assert.deepEqual(broken.notices, [])
|
||||
|
||||
assert.deepEqual(loadWith(t, 'null').notices, [])
|
||||
assert.deepEqual(loadWith(t, '[1,2,3]').notices, [])
|
||||
})
|
||||
@@ -11,6 +11,11 @@ const SELECTION = {
|
||||
SPECIFIED: 'specified'
|
||||
}
|
||||
|
||||
// 只比窗口矩形本身：getBounds() 在真实 Electron 里会多带几个键，比整对象会永远判不等
|
||||
function sameBounds(a, b) {
|
||||
return Boolean(a) && a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height
|
||||
}
|
||||
|
||||
// 大屏窗口管理：按显示器枚举结果开窗，绝不写死坐标。
|
||||
// 坐标一律用 DIP（display.bounds），页面内部再用 CSS 缩放适配，两边互不干扰。
|
||||
class DisplayManager {
|
||||
@@ -137,7 +142,9 @@ class DisplayManager {
|
||||
frame: false,
|
||||
// 与 Console 主窗口同一套兜底：个别平台会忽略 frame:false
|
||||
titleBarStyle: 'hidden',
|
||||
kiosk: !single && this.display.kiosk !== false,
|
||||
// 这里刻意不给 kiosk：进 kiosk 必须发生在 setBounds 之后，而 setBounds 与 kiosk
|
||||
// 的先后顺序是「压不压得住任务栏」的关键，只留 applyGeometry 一处去管，
|
||||
// 免得构造函数和 applyGeometry 各设一遍、顺序互相打架
|
||||
autoHideMenuBar: true,
|
||||
backgroundColor: this.display.backgroundColor || '#000000',
|
||||
title: `大屏 · ${page}`,
|
||||
@@ -152,8 +159,17 @@ class DisplayManager {
|
||||
}
|
||||
})
|
||||
|
||||
// 大屏页零交互控件；窗口层再兜一道，防止现场误触鼠标
|
||||
if (!single && this.display.ignoreMouse !== false) {
|
||||
// 大屏页没有可点的控件，但窗口**默认仍然吞掉鼠标**（不穿透）。
|
||||
// 这里原来是「默认 setIgnoreMouseEvents(true)」，方向恰好反了：
|
||||
// setIgnoreMouseEvents(true) 的语义不是「本窗口不吃误触」，而是「本窗口完全忽略鼠标」，
|
||||
// 点击会落到它后面的窗口或桌面上——现场想防的误触反而变成了误点别的东西；
|
||||
// 而且被忽略鼠标的窗口点不活、被盖住后也抢不回前台。
|
||||
// 只有确实要穿透（把大屏当纯展示层、同一块屏上还要操作别的窗口）才显式配
|
||||
// display.allowClickThrough: true，代价见 README。
|
||||
// 旧键 display.ignoreMouse 在这里**完全不读**：老机器的配置文件里还被旧版模板写着
|
||||
// ignoreMouse: true，读它就等于老机器升级后继续穿透（详见 config.js 的 DEFAULTS 注释）；
|
||||
// 旧键的存在与否由 config.js 在启动时提示一次，这里不掺和。
|
||||
if (!single && this.display.allowClickThrough === true) {
|
||||
win.setIgnoreMouseEvents(true)
|
||||
}
|
||||
|
||||
@@ -233,15 +249,46 @@ class DisplayManager {
|
||||
}
|
||||
}
|
||||
|
||||
// 把窗口摆到目标屏、并把窗口态调到目标模式。**这里的调用顺序是「大屏能不能压住任务栏」
|
||||
// 的全部理由**，动它之前先读下面 kiosk 分支的注释。
|
||||
applyGeometry(win, display, single) {
|
||||
if (!win || win.isDestroyed()) return
|
||||
if (single) {
|
||||
const bounds = this.geometryFor(display, single)
|
||||
const wantKiosk = !single && this.display.kiosk !== false
|
||||
|
||||
if (!wantKiosk) {
|
||||
// 窗口化（单屏调试态）与「多屏但 display.kiosk=false」：一律不置顶。
|
||||
// 单屏窗口化的 F11 全屏由用户自己控制，置顶会把它变成一块收不掉、盖住一切的覆盖层；
|
||||
// 从 kiosk 退回来的窗口也必须在这里把置顶摘掉，否则会带着 WS_EX_TOPMOST 留在窗口化态
|
||||
if (win.isKiosk()) win.setKiosk(false)
|
||||
if (win.isFullScreen()) win.setFullScreen(false)
|
||||
} else if (this.display.kiosk !== false) {
|
||||
win.setKiosk(true)
|
||||
win.setBounds(bounds)
|
||||
win.setAlwaysOnTop(false)
|
||||
return
|
||||
}
|
||||
win.setBounds(this.geometryFor(display, single))
|
||||
|
||||
// layout() 会因为插拔屏幕/改分辨率/改缩放在运行期反复调用；已经是对的状态就直接返回，
|
||||
// 否则每次重排都要退出再进入一次 kiosk，现场大屏会白闪一下
|
||||
if (win.isKiosk() && win.isAlwaysOnTop() && sameBounds(win.getBounds(), bounds)) return
|
||||
|
||||
// 顺序不能反，三条各自都是一次现场事故：
|
||||
// ① 已经在 kiosk 里就先退出。Windows 上对全屏窗口调 setBounds 会把它从真正的全屏态
|
||||
// 拽回「恰好铺满该屏的无边框窗口」；此时再 setKiosk(true)，Electron 侧会因为内部
|
||||
// 仍认为是 kiosk 而直接返回、什么都不做，窗口就永远停在那个假全屏态——它不是
|
||||
// topmost，任务栏（topmost）和任何拖到这块屏上的窗口都能画在它上面；
|
||||
// ② 先 setBounds 定位，后 setKiosk(true) 进全屏。这样窗口进 kiosk 时已经在正确的屏上，
|
||||
// 真正处于全屏态的窗口既压住任务栏，也不会被拖过来的窗口盖住；
|
||||
// ③ 置顶放最后，之后不许再有任何改动窗口几何/窗口态的调用，否则 topmost 可能又丢。
|
||||
if (win.isKiosk()) win.setKiosk(false)
|
||||
if (win.isFullScreen()) win.setFullScreen(false)
|
||||
win.setBounds(bounds)
|
||||
win.setKiosk(true)
|
||||
// 层级必须给 'screen-saver'：Windows 上只有 pop-up-menu 及以上才画在任务栏之上，
|
||||
// setAlwaysOnTop(true) 的默认层级 'floating' 仍然在任务栏下面。置顶之后别的窗口
|
||||
// 拖到这块屏上也盖不住它，点一下就能回到最前——大屏没有键盘，这是唯一的抢回前台手段。
|
||||
// 这里不需要再监听 blur 或起定时器补偿：topmost 是 z 序属性、与焦点无关，
|
||||
// 定时重设只会白白抢焦点，属于无因之果
|
||||
win.setAlwaysOnTop(true, 'screen-saver')
|
||||
}
|
||||
|
||||
loadPage(entry, display, page, single) {
|
||||
@@ -357,7 +404,7 @@ class DisplayManager {
|
||||
return { created: true, mode: this.modeOf(entry) }
|
||||
}
|
||||
|
||||
// 关掉某块屏上的大屏窗口：kiosk 窗口刻意忽略鼠标，误开后只能从这里收
|
||||
// 关掉某块屏上的大屏窗口：窗口默认置顶且压住任务栏，误开/要收场时只能从这里收
|
||||
closeDisplay(displayId) {
|
||||
const entry = this.windows.get(displayId)
|
||||
if (!entry) return false
|
||||
|
||||
@@ -47,6 +47,13 @@ class FakeBrowserWindow extends EventEmitter {
|
||||
this.destroyed = false
|
||||
this.kiosk = options.kiosk === true
|
||||
this.fullScreen = false
|
||||
// Electron 里 setIgnoreMouseEvents / setAlwaysOnTop 的默认态：不穿透、不置顶
|
||||
this.ignoreMouse = false
|
||||
this.alwaysOnTop = false
|
||||
this.alwaysOnTopLevel = null
|
||||
// 调用流水。坐标与窗口态的**先后顺序**本身就是被测行为（见 assertKioskOrder）：
|
||||
// 只看最终状态会漏掉「先进 kiosk 再 setBounds」这种被改回去的回归
|
||||
this.calls = []
|
||||
// 模拟真实 Electron 在切换瞬间回读到的旧值：设了它 isFullScreen() 就返回这个
|
||||
this.staleFullScreen = undefined
|
||||
this.bounds = { x: options.x, y: options.y, width: options.width, height: options.height }
|
||||
@@ -74,14 +81,19 @@ class FakeBrowserWindow extends EventEmitter {
|
||||
|
||||
setFullScreen(value) {
|
||||
this.fullScreen = value
|
||||
this.calls.push(['setFullScreen', value])
|
||||
}
|
||||
|
||||
isKiosk() {
|
||||
return this.kiosk
|
||||
}
|
||||
|
||||
// 真实 Electron 里 kiosk 就是窗口级全屏，两者同进同退，桩也照这个来，
|
||||
// 否则「kiosk 窗口其实是全屏」这层关系测不出来
|
||||
setKiosk(value) {
|
||||
this.kiosk = value
|
||||
this.fullScreen = value
|
||||
this.calls.push(['setKiosk', value])
|
||||
}
|
||||
|
||||
getBounds() {
|
||||
@@ -90,10 +102,22 @@ class FakeBrowserWindow extends EventEmitter {
|
||||
|
||||
setBounds(bounds) {
|
||||
this.bounds = bounds
|
||||
this.calls.push(['setBounds', { ...bounds }])
|
||||
}
|
||||
|
||||
isAlwaysOnTop() {
|
||||
return this.alwaysOnTop
|
||||
}
|
||||
|
||||
setAlwaysOnTop(value, level) {
|
||||
this.alwaysOnTop = value
|
||||
this.alwaysOnTopLevel = value ? level || 'floating' : null
|
||||
this.calls.push(['setAlwaysOnTop', value, level])
|
||||
}
|
||||
|
||||
setIgnoreMouseEvents(value) {
|
||||
this.ignoreMouse = value
|
||||
this.calls.push(['setIgnoreMouseEvents', value])
|
||||
}
|
||||
|
||||
show() {
|
||||
@@ -137,6 +161,12 @@ Module._load = function (request, parent, isMain) {
|
||||
}
|
||||
const { DisplayManager } = require('./displays')
|
||||
Module._load = originalLoad
|
||||
// 随包发布的内置默认值：用例要验「多屏 kiosk 默认不穿透」，就得拿**真的默认值**去跑，
|
||||
// 在测试里自己写死一份 false 是验不到 DEFAULTS/config.json 被改回 true 的
|
||||
const { DEFAULTS } = require('./config')
|
||||
// 随包的 config.json 模板（打包态首次启动复制到用户数据目录）是现场真正的默认值，
|
||||
// 只改代码里的 DEFAULTS 而漏了它，现场升级后仍然是穿透
|
||||
const shippedConfig = require('../config.json')
|
||||
|
||||
const WIDTH = 1920
|
||||
const HEIGHT = 1080
|
||||
@@ -145,7 +175,15 @@ function fakeDisplay(id, { internal = false } = {}) {
|
||||
return { id, label: `显示器 ${id}`, internal, bounds: { x: 0, y: 0, width: WIDTH, height: HEIGHT }, scaleFactor: 1 }
|
||||
}
|
||||
|
||||
function makeManager(t, { selection = 'all', kiosk = true } = {}) {
|
||||
// allowClickThrough 默认直接取 config.js 里的内置默认值（false = 不穿透），
|
||||
// 这样「默认值被改回 true」这件事本身会被用例抓住；要穿透的用例显式传 { allowClickThrough: true }。
|
||||
// legacy 用来注入旧机器配置文件里留下的老键（如 ignoreMouse: true），验「老键已失效」
|
||||
function makeManager(t, {
|
||||
selection = 'all',
|
||||
kiosk = true,
|
||||
allowClickThrough = DEFAULTS.display.allowClickThrough,
|
||||
legacy = {}
|
||||
} = {}) {
|
||||
fakeScreen.displays = []
|
||||
fakeScreen.primaryId = 1
|
||||
// 上一个用例若忘了收摊，残留的监听会串到这一个用例里
|
||||
@@ -160,9 +198,10 @@ function makeManager(t, { selection = 'all', kiosk = true } = {}) {
|
||||
pages: ['standings', 'medals'],
|
||||
pageParam: 'page',
|
||||
kiosk,
|
||||
ignoreMouse: true,
|
||||
allowClickThrough,
|
||||
reloadEveryHours: 0,
|
||||
backgroundColor: '#000000'
|
||||
backgroundColor: '#000000',
|
||||
...legacy
|
||||
}
|
||||
},
|
||||
server: { host: '0.0.0.0', port: 19540 },
|
||||
@@ -343,6 +382,181 @@ test('kiosk 窗口不挂 F11 处理', (t) => {
|
||||
assert.equal(manager.windows.get(2).win.webContents.listeners('before-input-event').length, 0)
|
||||
})
|
||||
|
||||
// —— 窗口层行为：能不能点穿、压不压得住任务栏 ——
|
||||
// 现场回归：① 大屏窗口默认 setIgnoreMouseEvents(true)，点击穿透到后面的窗口/桌面，
|
||||
// 「防误触」变成了「误点别的东西」，被穿透的窗口还点不活；
|
||||
// ② kiosk 窗口先 setKiosk(true) 再 setBounds，被 Windows 从真正的全屏态拽回
|
||||
// 「恰好铺满该屏的无边框窗口」，不是 topmost，任务栏与拖过来的窗口都能盖住它。
|
||||
// ①的开关键从 ignoreMouse 改名成了 allowClickThrough：旧键在老机器的用户配置里被写死着，
|
||||
// 只改默认值救不了它们，用例里的「老机器」就是带 ignoreMouse: true 进来的那份配置。
|
||||
|
||||
// 窗口调用流水里「最后一次」满足条件的调用下标；找不到返回 -1
|
||||
function lastCallIndex(win, name, match = () => true) {
|
||||
return win.calls.reduce((found, [called, ...args], index) => (
|
||||
called === name && match(...args) ? index : found
|
||||
), -1)
|
||||
}
|
||||
|
||||
// kiosk 窗口必须：先 setBounds 定位 → 再 setKiosk(true) → 最后置顶到 screen-saver。
|
||||
// 顺序反了就是上面 ② 那个事故；这里断言的是顺序而不是最终状态，正为此。
|
||||
function assertKioskOrder(win) {
|
||||
const boundsAt = lastCallIndex(win, 'setBounds')
|
||||
const kioskAt = lastCallIndex(win, 'setKiosk', (value) => value === true)
|
||||
assert.notEqual(kioskAt, -1, 'kiosk 窗口必须真的进过 kiosk')
|
||||
assert.ok(
|
||||
boundsAt !== -1 && boundsAt < kioskAt,
|
||||
`setBounds(#${boundsAt}) 必须在 setKiosk(true)(#${kioskAt}) 之前，实际调用流水：${JSON.stringify(win.calls)}`
|
||||
)
|
||||
|
||||
const topAt = lastCallIndex(win, 'setAlwaysOnTop', (value) => value === true)
|
||||
assert.ok(topAt > kioskAt, `进 kiosk 之后必须置顶，实际调用流水：${JSON.stringify(win.calls)}`)
|
||||
assert.equal(win.alwaysOnTopLevel, 'screen-saver', 'Windows 上只有 pop-up-menu 及以上才画在任务栏之上')
|
||||
}
|
||||
|
||||
test('新键缺省 = 不穿透：多屏 kiosk 不调 setIgnoreMouseEvents(true)', (t) => {
|
||||
// 先把「默认值本身」钉住：这份默认值改成 true，就等于把点击穿透又放回现场
|
||||
assert.equal(DEFAULTS.display.allowClickThrough, false, '内置默认值必须是「不穿透」')
|
||||
assert.equal(shippedConfig.display.allowClickThrough, false, '随包的 config.json 模板也必须是「不穿透」')
|
||||
assert.equal('ignoreMouse' in DEFAULTS.display, false, '旧键必须从 DEFAULTS 里消失，否则等于还在读它')
|
||||
|
||||
const manager = makeManager(t)
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true }), fakeDisplay(2)]
|
||||
|
||||
manager.enable()
|
||||
|
||||
for (const id of [1, 2]) {
|
||||
const win = manager.windows.get(id).win
|
||||
assert.equal(win.ignoreMouse, false, `display=${id} 默认必须吞掉鼠标：穿透会把点击送给后面的窗口/桌面`)
|
||||
assert.equal(lastCallIndex(win, 'setIgnoreMouseEvents', (value) => value === true), -1)
|
||||
}
|
||||
})
|
||||
|
||||
test('只有显式配 display.allowClickThrough=true 才穿透', (t) => {
|
||||
const manager = makeManager(t, { allowClickThrough: true })
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true }), fakeDisplay(2)]
|
||||
|
||||
manager.enable()
|
||||
|
||||
assert.deepEqual(
|
||||
manager.windows.get(2).win.calls.filter(([name]) => name === 'setIgnoreMouseEvents'),
|
||||
[['setIgnoreMouseEvents', true]]
|
||||
)
|
||||
})
|
||||
|
||||
test('回归钉子：老机器配置里留着 ignoreMouse: true 也不穿透（旧键已失效）', (t) => {
|
||||
// 这就是本次修复的核心：旧版模板把 ignoreMouse: true 写进了现场机器的用户配置，
|
||||
// 而 userpaths.js 不会覆盖用户文件——只要还读旧键，那台机器升级后照样穿透
|
||||
const manager = makeManager(t, { legacy: { ignoreMouse: true } })
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true }), fakeDisplay(2)]
|
||||
|
||||
manager.enable()
|
||||
|
||||
for (const id of [1, 2]) {
|
||||
const win = manager.windows.get(id).win
|
||||
assert.equal(win.ignoreMouse, false, `display=${id}：旧键 ignoreMouse 已废弃，不能让它把穿透带回来`)
|
||||
assert.equal(lastCallIndex(win, 'setIgnoreMouseEvents', (value) => value === true), -1)
|
||||
}
|
||||
|
||||
// 用例本身要确保旧键真的塞进了配置里，否则这条测试等于没测
|
||||
assert.equal('ignoreMouse' in manager.display, true)
|
||||
assert.equal(manager.display.allowClickThrough, false, '新键没被显式写成 true')
|
||||
})
|
||||
|
||||
test('单屏窗口化不受穿透开关影响：配了穿透也不穿透、也不置顶', (t) => {
|
||||
const manager = makeManager(t, { allowClickThrough: true })
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true })]
|
||||
|
||||
manager.enable()
|
||||
|
||||
const win = manager.windows.get(1).win
|
||||
assert.equal(win.ignoreMouse, false, '穿透这一行从来只管多屏 kiosk')
|
||||
assert.equal(lastCallIndex(win, 'setAlwaysOnTop', (value) => value === true), -1, '窗口化的 F11 全屏归用户管，不能置顶')
|
||||
assert.equal(win.isKiosk(), false)
|
||||
})
|
||||
|
||||
test('kiosk 窗口：先 setBounds 再 setKiosk(true)，最后置顶 screen-saver', (t) => {
|
||||
const manager = makeManager(t)
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true }), fakeDisplay(2)]
|
||||
|
||||
manager.enable()
|
||||
|
||||
for (const id of [1, 2]) {
|
||||
const win = manager.windows.get(id).win
|
||||
assertKioskOrder(win)
|
||||
assert.equal(win.isKiosk(), true)
|
||||
assert.equal(win.alwaysOnTop, true, '被别的窗口盖住后要能点回最前')
|
||||
}
|
||||
})
|
||||
|
||||
test('面板手动开的 kiosk 窗口同样置顶、不穿透', (t) => {
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
const external = fakeDisplay(2)
|
||||
fakeScreen.displays = [primary, external]
|
||||
|
||||
assert.deepEqual(manager.openOn(external, { page: 'medals', single: false }), { created: true, mode: 'kiosk' })
|
||||
|
||||
const win = manager.windows.get(2).win
|
||||
assertKioskOrder(win)
|
||||
assert.equal(win.ignoreMouse, false)
|
||||
})
|
||||
|
||||
test('kiosk 已是目标态时不重复进出 kiosk（重排不该让大屏白闪）', (t) => {
|
||||
const manager = makeManager(t)
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true }), fakeDisplay(2)]
|
||||
manager.enable()
|
||||
|
||||
const win = manager.windows.get(2).win
|
||||
const callsBefore = JSON.stringify(win.calls)
|
||||
|
||||
// 一次「屏幕没变」的重排：窗口态已经是目标态，就一个窗口调用都不该发生
|
||||
manager.layout()
|
||||
|
||||
assert.equal(JSON.stringify(win.calls), callsBefore)
|
||||
assertKioskOrder(win)
|
||||
})
|
||||
|
||||
test('插拔屏幕就地换模式：置顶跟着 kiosk 来回，顺序不变', (t) => {
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
fakeScreen.displays = [primary]
|
||||
manager.enable()
|
||||
|
||||
const win = manager.windows.get(1).win
|
||||
assert.equal(win.alwaysOnTop, false, '单屏窗口化不置顶')
|
||||
|
||||
// 插上电视：同一块屏上的窗口就地转 kiosk，必须补上置顶
|
||||
fakeScreen.displays = [primary, fakeDisplay(2)]
|
||||
manager.layout()
|
||||
assertModeConsistent(manager, 1, false)
|
||||
assertKioskOrder(win)
|
||||
|
||||
// 电视拔了：转回窗口化，置顶必须摘掉，否则窗口化态会继续盖住一切
|
||||
fakeScreen.displays = [primary]
|
||||
manager.layout()
|
||||
assertModeConsistent(manager, 1, true)
|
||||
assert.equal(win.alwaysOnTop, false)
|
||||
assert.equal(win.alwaysOnTopLevel, null)
|
||||
})
|
||||
|
||||
test('收窗路径不被置顶破坏：closeDisplay / closeAll 仍收得掉 kiosk 窗口', (t) => {
|
||||
const manager = makeManager(t)
|
||||
fakeScreen.displays = [fakeDisplay(1, { internal: true }), fakeDisplay(2)]
|
||||
manager.enable()
|
||||
|
||||
const external = manager.windows.get(2).win
|
||||
const primary = manager.windows.get(1).win
|
||||
assert.equal(manager.closeDisplay(2), true)
|
||||
assert.equal(external.isDestroyed(), true)
|
||||
assert.equal(manager.windows.has(2), false)
|
||||
assert.equal(manager.closeDisplay(2), false, '已经收掉的窗口不能再报成功')
|
||||
|
||||
manager.closeAll()
|
||||
assert.equal(primary.isDestroyed(), true)
|
||||
assert.equal(manager.windows.size, 0)
|
||||
assert.equal(manager.enabled, false)
|
||||
})
|
||||
|
||||
// 屏幕监听的三条不变式，对应审查日志模块13 [1] P1：
|
||||
// ① 任何一次「屏幕数量变化」都不能把监听永久摘掉（只有 closeAll 摘）
|
||||
// ② 事件到达后 600ms 防抖重排，从 1 块恢复 2 块要自动回到 kiosk，从 2 块变 1 块要收回窗口化
|
||||
|
||||
@@ -609,6 +609,10 @@ function main() {
|
||||
log.push('console', `用户数据目录：${userPaths.root}（Console 配置、服务端 config.yaml、rules 都在这里，覆盖安装不会丢）`)
|
||||
}
|
||||
if (cfg.warning) log.push('console', cfg.warning)
|
||||
// 配置里还留着改名前的旧键（如 display.ignoreMouse）：只在启动这里提示一次。
|
||||
// 判断与文案都在 config.js 的 loadConfig 里算好，这里只负责落日志——
|
||||
// 大屏重排路径（displays.js）绝不碰这件事，否则每次插拔屏幕都要刷一行
|
||||
for (const notice of cfg.notices) log.push('console', `警告：${notice}`)
|
||||
|
||||
const resolved = resolveExecutable(cfg.values.server.exe, cfg.path, bundleDir)
|
||||
exePath = resolved.path
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "scoreboard-console",
|
||||
"productName": "Scoreboard Console",
|
||||
"version": "0.3.0",
|
||||
"version": "0.4.0",
|
||||
"private": true,
|
||||
"author": "AskaEth",
|
||||
"description": "赛事积分榜 · 桌面宿主：守护 Go 服务端并把大屏投到扩展屏",
|
||||
|
||||
Reference in new issue
Block a user