AskaEth
c97d3150c9
## 判断失误的修正（主人现场实测出来的） 主人现场是 **169.254 自动配置网段**（没有 DHCP，设备靠链路本地地址互访）， 平板实测能访问 `http://169.254.79.190:19540/display`；而卡片一开始把链路本地地址 **排除**了，于是显示「未检测到局域网地址」。 根因：`usableLanIPv4` 排除了 `IsLinkLocalUnicast()`，理由写的是「169.254 说明没拿到 IP」 ——那是**对网络健不健康的猜测**，不是**地址能不能用的事实**。 现改为按**地址类别**判定（`ipv4Scope`，全部用标准库谓词，**代码里没有任何网段字面量**）： 只排除「作为对端访问目标没有意义」的四类（回环 / 未指定 / 组播 / 广播）， 链路本地与私网、全局一样进候选，只**排在最后**并带说明 「自动配置地址：本网段没有 DHCP，同网段设备可以互相访问」。 新增**反硬编码护栏用例**：函数体内不得出现 `x.x.x.x` 字面量，且必须用满 6 个谓词。 顺带修掉新用例抓出的真 bug：`ipv4Scope(nil)` 曾落进 default 被当成「可用的 global」， 而 IPv6 的 `To4()` 正是 nil → 「只有 IPv6 的网卡」会被误判成有可用地址。 ## 三层兜底（离线现场必须拿得到地址） 1. **严格轮**：接口 up 且非回环； 2. **宽松轮**：严格轮为空时不再要求 up 位（某些驱动/虚拟网卡读不到），命中标 `confidence: low`； 3. **默认路由探测**：两轮皆空时用 `net.Dial("udp4", …)` 问出本机源地址 （UDP connect 只查路由表、不握手不发包，离线安全；TCP 会等 SYN 超时，不能用），标 `confidence: route`。 接口同时回 `scope`（private/global/link-local）与 `skipped`（被跳过的网卡 + 原因， code 收敛为 no-address / only-ipv6 / not-up / loopback——link-local 不再是「被跳过」的理由）。 ## 手填入口（最后一道保险） 自动检测不到、或不是现场要用的网段时，操作员把 `ipconfig` 里的地址填进卡片， 立刻生成链接 + 二维码；排在第一条、带「手动」徽标、可删除、localStorage 持久化、 四条就地校验文案（空/含空格/不像 IP/重复），IPv6 也支持。 ## 自检工具 `debug/诊断/局域网地址自检.exe` + 说明：只读、不写文件、不需管理员， 打印系统给 Go 看的网卡列表（含类别）、默认路由探测结果与可用大屏地址。 （正是它把现场定性成 169.254 网段的。） ## 真浏览器验证（四场景，非源码断言） 链接本地地址出链接+二维码+说明句 / 空态列出被跳过网卡并折叠（5 条 + 等共 N 块）/ low 与 route 两种来源提示各占一行互不顶掉 / 手填地址排第一并刷新不丢 —— 全部通过，0 页面错误。 ## 文档 使用手册 §9、部署指南 7.5/7.9、上线检查清单（**防火墙放行入站 19540** 与 「另一台设备能打开局域网大屏」两条新增）、常见问题 Q101、升级说明 dev_0.5.0； devdocs 05/07/13 同步（含这次误判的来龙去脉与「Get-NetAdapter 显示 Up ≠ 有 IP」）。 **没有数据迁移**，旧赛事包照常导入。 自检：服务端 13 包 ×2；前端 vue-tsc + 680 例 ×2 + build；Console 20 文件 + 68 例。
86 lines
2.0 KiB
JSON
86 lines
2.0 KiB
JSON
{
|
|
"name": "scoreboard-console",
|
|
"productName": "Scoreboard Console",
|
|
"version": "0.5.0",
|
|
"private": true,
|
|
"author": "AskaEth",
|
|
"description": "赛事积分榜 · 桌面宿主：守护 Go 服务端并把大屏投到扩展屏",
|
|
"main": "main/index.js",
|
|
"scripts": {
|
|
"start": "electron .",
|
|
"check": "node scripts/check-syntax.js",
|
|
"dist": "electron-builder --win --x64",
|
|
"pack": "electron-builder --dir"
|
|
},
|
|
"devDependencies": {
|
|
"electron": "^38.0.0",
|
|
"electron-builder": "^26.0.12"
|
|
},
|
|
"build": {
|
|
"appId": "top.yeij.scoreboard.console",
|
|
"productName": "Scoreboard Console",
|
|
"directories": {
|
|
"output": "../dist/console",
|
|
"buildResources": "resources"
|
|
},
|
|
"files": [
|
|
"main/**/*",
|
|
"renderer/**/*",
|
|
"config.json",
|
|
"package.json"
|
|
],
|
|
"extraFiles": [
|
|
{
|
|
"from": "../dist/scoreboard.exe",
|
|
"to": "scoreboard.exe",
|
|
"filter": ["**/*"]
|
|
},
|
|
{
|
|
"from": "../config.yaml",
|
|
"to": "config.yaml"
|
|
},
|
|
{
|
|
"from": "config.json",
|
|
"to": "config.json"
|
|
},
|
|
{
|
|
"from": "scoreboard.png",
|
|
"to": "scoreboard.png"
|
|
},
|
|
{
|
|
"from": "../rules",
|
|
"to": "rules"
|
|
},
|
|
{
|
|
"from": "extra",
|
|
"to": ".",
|
|
"filter": ["**/*", "!.gitkeep"]
|
|
}
|
|
],
|
|
"win": {
|
|
"executableName": "Scoreboard_Console",
|
|
"icon": "resources/icon.ico",
|
|
"target": [
|
|
{
|
|
"target": "nsis",
|
|
"arch": ["x64"]
|
|
},
|
|
{
|
|
"target": "zip",
|
|
"arch": ["x64"]
|
|
}
|
|
],
|
|
"artifactName": "${productName}-${version}-${arch}.${ext}"
|
|
},
|
|
"nsis": {
|
|
"oneClick": false,
|
|
"allowToChangeInstallationDirectory": true,
|
|
"createDesktopShortcut": true,
|
|
"shortcutName": "赛事积分榜",
|
|
"license": "../LICENSE",
|
|
"include": "resources/installer-custom.nsh",
|
|
"language": "2052"
|
|
}
|
|
}
|
|
}
|