diff --git a/desktop/MainWindow.xaml b/desktop/MainWindow.xaml index cccc3d0..9e461fe 100644 --- a/desktop/MainWindow.xaml +++ b/desktop/MainWindow.xaml @@ -25,9 +25,10 @@ - - + + + diff --git a/desktop/MainWindow.xaml.cs b/desktop/MainWindow.xaml.cs index 2b55a5d..b1d2c7b 100644 --- a/desktop/MainWindow.xaml.cs +++ b/desktop/MainWindow.xaml.cs @@ -1,4 +1,4 @@ -using System; +using System; using System.Collections.Concurrent; using System.Collections.Generic; using System.ComponentModel; @@ -794,19 +794,80 @@ public partial class MainWindow : Window } /// - /// 「工具 → 安装谷歌插件」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装 + /// 「工具 → 安装浏览器插件(企业策略)」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装 /// /// 扩展 ID 从后端 `/download/extension/updates.xml` 读(由打包私钥决定), /// 这里不写死 —— 换私钥/换域名都不用改客户端。 /// + /// Edge 加载项商店的安装页(审核通过后可用;审核/未上线时打开会是 404,属正常) + private const string ExtensionStoreUrl = + "https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj"; + + /// + /// 「工具 → 安装浏览器插件(Edge 应用商店)」: + /// 非受管 / 没有管理员权限的电脑上,企业策略会被浏览器拒绝,商店是唯一能一键装的路。 + /// + private void OpenExtensionStore_Click(object sender, RoutedEventArgs e) + { + try + { + AppLog.Write($"打开 Edge 加载项商店页:{ExtensionStoreUrl}"); + + // 装了 Edge 就用 Edge 打开:这个页面只对 Edge 有效,默认浏览器是 Chrome 时点「获取」也装不上 + var edge = FindEdgePath(); + if (edge != null) + { + Process.Start(new ProcessStartInfo(edge, ExtensionStoreUrl) { UseShellExecute = true }); + } + else + { + AppLog.Write("没找到 msedge.exe,用默认浏览器打开商店页(可能是 Chrome,装不了,需手动换 Edge)"); + Process.Start(new ProcessStartInfo(ExtensionStoreUrl) { UseShellExecute = true }); + } + + MessageBox.Show(this, + "已打开「云仓视频溯源 · 单号注入」的 Edge 加载项页面。\n\n" + + "· 点「获取」→「添加扩展」,几秒就装好,不需要开发者模式,也不需要管理员权限;\n" + + "· 这个页面只对 Microsoft Edge 有效(Chrome 装不了 Edge 商店的扩展);\n" + + "· 如果页面显示 404,说明商店还在审核中——先用企业策略或开发者模式。", + "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); + } + catch (Exception ex) + { + AppLog.Write($"打开插件商店页失败:{ex.Message}"); + MessageBox.Show(this, + $"打开商店页面失败:{ex.Message}\n\n请手动在 Edge 里访问:\n{ExtensionStoreUrl}", + "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning); + } + } + + /// 找 Edge 的可执行文件(没装返回 null) + private static string? FindEdgePath() + { + string[] candidates = + [ + Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ProgramFilesX86), @"Microsoft\Edge\Application\msedge.exe"), + Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles), @"Microsoft\Edge\Application\msedge.exe"), + Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), @"Microsoft\Edge\Application\msedge.exe"), + ]; + + foreach (var path in candidates) + { + if (File.Exists(path)) return path; + } + + return null; + } + private async void InstallExtension_Click(object sender, RoutedEventArgs e) { var confirm = MessageBox.Show(this, "将为 Chrome 和 Edge 写入企业策略,重启浏览器后自动安装「云仓视频溯源 · 单号注入」插件。\n\n" + "· 需要允许一次管理员权限(UAC);\n" + + "· 电脑必须已纳管(加域 / Intune 等),否则浏览器会拒绝非商店来源的扩展;\n" + "· 装好后插件由浏览器自己更新,不用再手动「加载已解压」;\n" - + "· 想撤销:同一菜单「卸载谷歌插件」。\n\n继续吗?", - "安装谷歌插件", MessageBoxButton.OKCancel, MessageBoxImage.Question); + + "· 想撤销:同一菜单「卸载浏览器插件(企业策略)」。\n\n继续吗?", + "安装浏览器插件", MessageBoxButton.OKCancel, MessageBoxImage.Question); if (confirm != MessageBoxResult.OK) return; try @@ -818,29 +879,31 @@ public partial class MainWindow : Window $"已为 {string.Join("、", result.Targets)} 写入策略。\n\n" + $"扩展 ID:{result.Id}\n更新地址:{result.UpdateUrl}\n\n" + "请完全退出并重新打开浏览器;在 chrome://extensions 里应能看到该插件,并显示「由你的组织管理」。", - "安装谷歌插件", MessageBoxButton.OK, MessageBoxImage.Information); + "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); } catch (OperationCanceledException) { MessageBox.Show(this, "已取消管理员授权,浏览器策略没有改动。", - "安装谷歌插件", MessageBoxButton.OK, MessageBoxImage.Information); + "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); } catch (Exception ex) { AppLog.Write($"[extension] 安装插件失败:{ex.Message}"); MessageBox.Show(this, $"安装失败:{ex.Message}\n\n" - + "没有管理员权限的机器只能走开发者模式:用「工具 → 复制插件路径(开发者模式)」手动加载。", - "安装谷歌插件", MessageBoxButton.OK, MessageBoxImage.Warning); + + "没有管理员权限、或电脑没纳管时,浏览器会拒绝企业策略。改用这两条路:\n" + + "· 用 Edge:菜单「安装浏览器插件(Edge 应用商店)」→ 点「获取」;\n" + + "· 用 Chrome:菜单「复制插件路径(开发者模式)」→ chrome://extensions 加载已解压的扩展程序。", + "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning); } } - /// 「工具 → 卸载谷歌插件」:删掉我们写的那几条策略(UAC 一次) + /// 「工具 → 卸载浏览器插件(企业策略)」:删掉我们写的那几条策略(UAC 一次) private async void UninstallExtension_Click(object sender, RoutedEventArgs e) { var confirm = MessageBox.Show(this, "将移除 Chrome / Edge 里由本软件写入的插件策略,重启浏览器后插件会被卸载。\n\n继续吗?", - "卸载谷歌插件", MessageBoxButton.OKCancel, MessageBoxImage.Question); + "卸载浏览器插件", MessageBoxButton.OKCancel, MessageBoxImage.Question); if (confirm != MessageBoxResult.OK) return; try @@ -852,17 +915,17 @@ public partial class MainWindow : Window result.Targets.Count == 0 ? "没有找到本软件写入的插件策略(可能本来就没装)。" : "已移除插件策略,重启浏览器后插件会被卸载。", - "卸载谷歌插件", MessageBoxButton.OK, MessageBoxImage.Information); + "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); } catch (OperationCanceledException) { MessageBox.Show(this, "已取消管理员授权,浏览器策略没有改动。", - "卸载谷歌插件", MessageBoxButton.OK, MessageBoxImage.Information); + "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); } catch (Exception ex) { AppLog.Write($"[extension] 卸载插件失败:{ex.Message}"); - MessageBox.Show(this, $"卸载失败:{ex.Message}", "卸载谷歌插件", MessageBoxButton.OK, MessageBoxImage.Warning); + MessageBox.Show(this, $"卸载失败:{ex.Message}", "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning); } } @@ -876,22 +939,22 @@ public partial class MainWindow : Window if (!Directory.Exists(path)) { MessageBox.Show(this, - $"没有找到谷歌插件目录:\n\n{path}\n\n请安装最新版本后再试。", - "复制谷歌插件地址", MessageBoxButton.OK, MessageBoxImage.Warning); + $"没有找到插件目录:\n\n{path}\n\n请安装最新版本后再试。", + "复制插件路径", MessageBoxButton.OK, MessageBoxImage.Warning); return; } // 剪贴板被别的程序占着时写入会重试几秒,放到后台做,别把界面卡住 if (await Task.Run(() => TrySetClipboardText(path))) { - AppLog.Write($"已复制谷歌插件地址:{path}"); + AppLog.Write($"已复制插件路径:{path}"); MessageBox.Show(this, $"已复制插件路径:\n\n{path}\n\n打开 chrome://extensions → 打开「开发者模式」→「加载已解压的扩展程序」→ 粘贴该路径。", - "复制谷歌插件地址", MessageBoxButton.OK, MessageBoxImage.Information); + "复制插件路径", MessageBoxButton.OK, MessageBoxImage.Information); return; } - AppLog.Write($"复制谷歌插件地址失败(剪贴板被其他程序占用):{path}"); + AppLog.Write($"复制插件路径失败(剪贴板被其他程序占用):{path}"); var holder = GetClipboardHolderName(); AppLog.Write(holder == null ? "没查到占用剪贴板的进程" @@ -905,7 +968,7 @@ public partial class MainWindow : Window $"· 关掉{owner},或稍等一两秒再点一次「复制插件路径(开发者模式)」;\n" + "· 远程桌面里遇到的话,在远程机器上重启 rdpclip.exe 后重试。\n\n" + "要打开记事本显示这个路径吗(方便对照抄写)?", - "复制谷歌插件地址", MessageBoxButton.YesNo, MessageBoxImage.Warning); + "复制插件路径", MessageBoxButton.YesNo, MessageBoxImage.Warning); if (openNotepad == MessageBoxResult.Yes) { diff --git a/desktop/README.md b/desktop/README.md index 86f023c..fc08fc6 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -245,28 +245,40 @@ cd desktop\installer ### 谷歌浏览器插件 -仓库根目录的 `extension/` 会一起打进 MSI / EXE,安装后固定在 **`<安装目录>\extension`** +仓库根目录的 `extension/dist`(压缩产物)会一起打进 MSI / EXE,安装后固定在 **`<安装目录>\extension`** (perUser 安装即 `%LOCALAPPDATA%\Programs\YuncangTrace\extension`)。 -**推荐:企业策略安装(零开发者模式)** —— `Services/ExtensionInstaller.cs`: +**首选:Edge 加载项商店(非受管电脑也能装)** —— -- 菜单「工具 → **安装谷歌插件(Chrome / Edge)**」:先拉后端 `/download/extension/updates.xml` +- 菜单「工具 → **安装浏览器插件(Edge 应用商店)**」:装了 Edge 就用 `msedge.exe` 打开 + `https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj`, + 用户点「获取」即可;**不需要开发者模式,也不需要管理员权限**; +- 这个链接**审核通过后**才有效(审核中打开是 404);商店版扩展 ID 是 `mgdonmkicojkabgalgekobaoohaohfcj`; +- 只对 Edge 有效:Chrome 装不了 Edge 商店的扩展,请走下面的企业策略或开发者模式。 + +**受管设备:企业策略安装(零开发者模式)** —— `Services/ExtensionInstaller.cs`: + +- 菜单「工具 → **安装浏览器插件(企业策略:Chrome / Edge)**」:先拉后端 `/download/extension/updates.xml` 读出扩展 ID,再生成 `.reg` 文件、**runas 执行 `reg import`** 写 HKLM 策略(Chrome + Edge), 最后**读注册表**确认结果(不依赖子进程回传,早期用「提权起自己 + 临时文件回传」现场踩过 「退出码 0 但结果文件没写」的坑): - `ExtensionInstallForcelist = ;https://<域名>/download/extension/updates.xml` - `ExtensionInstallSources = https://<域名>/download/extension/*` - 重启浏览器后自动装好,之后由 `updates.xml` 自己升级;`chrome://extensions` 里显示「由你的组织管理」; -- 菜单「工具 → **卸载谷歌插件**」:只删值里带 `/download/extension/` 的那几条,不影响别人写的策略; +- 菜单「工具 → **卸载浏览器插件(企业策略)**」:只删值里带 `/download/extension/` 的那几条,不影响别人写的策略; - 前提:发布端已执行过 `cd backend && npm run extension:publish`(产出 `.crx` + `updates.xml`); 扩展 ID 由 `extension/keys/key.pem` 决定,**换私钥 = 换 ID = 已下发策略失效**,私钥务必备份; -- 提权失败(没有管理员权限)时提示用户走下面的开发者模式。 +- 提权失败 / 设备未纳管时,弹窗会直接引导到「Edge 商店」或「开发者模式」两条路。 + +> ⚠️ 商店版(`mgdon…`)与自建 CRX(`lkei…`)是**两个不同 ID 的扩展**:同一浏览器都装会同时注入、 +> 页面被标记两遍。从自建 CRX 切到商店版前,先点「卸载浏览器插件(企业策略)」。 **兜底:开发者模式** —— - 菜单「工具 → 复制插件路径(开发者模式)」直接把该目录的 **Windows 路径**(如 `C:\Users\xxx\AppData\Local\Programs\YuncangTrace\extension`)复制到剪贴板; - 写剪贴板会重试(WPF → WinForms,各 3 次 ×150ms),被输入法/剪贴板工具/远程桌面占用时不会直接报 `CLIPBRD_E_CANT_OPEN`; - 仍然失败会提示原因,并可以选「打开记事本」把路径显示出来手动抄写; + 写剪贴板全程在后台 STA 线程、带截止时间退避重试(WPF → WinForms → 补 `OleFlushClipboard`), + 被远程桌面(实测 BilldDesk)/ 输入法 / 剪贴板工具占用时不会卡住界面、也不会误报; + **复制前先核对内容**:剪贴板里已经是这个路径就直接算成功;确实写不进去才提示,并告知是哪个进程占着,可选「打开记事本」手动抄写; - 用户打开 `chrome://extensions` → 打开「开发者模式」→「加载已解压的扩展程序」→ 粘贴路径即可; - 卸载时该目录随安装包一起删除; @@ -897,6 +909,29 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧( ⚠️ 配置快照里含录像机密码:只放内存,不落盘、不写日志、界面文案也不显示。 +### 工作台 OSD 字幕(摄像头名 + 运单号) + +「设备服务」开启后(后台服务模式 / 界面模式都会跑),会按**工作台**维护录像机的 OSD 通道名: + +| 时机 | 写什么 | +| --- | --- | +| 扫到运单号(扫码枪 / 面单识别,连续重复命中都算「在扫」) | 该工作台**所有摄像头**:`摄像头名 + 空格 + 运单号`(如 `2号线面单 SF1164748936737`) | +| **运单号没变** | **不重写**(连续扫描只续在场计时) | +| 连续 **60 秒**没有任何命中 | 全部还原成**工作台名称** | + +- 配置来源:`GET /api/scanner/workstations`(设备令牌)——只下发**绑了本机扫码通道**的工作台, + 每项带本机通道、全部绑定摄像头(名称 / 录像机通道号 / 录像机凭据); + 启动拉一次 + 每 1 分钟兜底,服务端推 `labelScan.refresh`(改工作台/摄像头绑定时会推)立即重拉; +- 写的是**录像机通道名**(`NET_DVR_SET_PICCFG_V30` 读-改-写整包 + 回读校验), + 所以实时流、回放、下载的录像里都带这段字;摄像头本身不改; +- 字段只有 **31 字节(GBK)**:超长时先压摄像头名、保住完整运单号(见 `OsdText`); +- 每次写设备配置要 1~3 秒,写入在**单线程队列**里串行执行(不阻塞扫码/识别), + 失败按 5s→10s→20s→40s→60s 退避;配置里被移除的摄像机会先还原一次工作台名再忘掉; +- 状态在 `agent-status.json` 的 `Osd`(每路摄像头的当前文本 / 最近写入时间 / 错误,**不含密码**)。 + +> ⚠️ 改通道名 = 改录像机上的通道名:NVR 本机界面、其他客户端、以及我们「拉取通道」读到的名字都会变。 +> 服务停止时**不主动清 OSD**(下次启动会按配置还原成工作台名);要动态的长文本字幕只能本地 `ffmpeg drawtext`。 + ### 摄像头识别结果 → 记录 + 安卓播报通知 在「工作台 → 绑定管理」里把某路摄像头设为**面单摄像头**(每个工作台只保留一路,散单/团购都能设)后,识别到的条码