feat(desktop): 工具菜单按渠道分流——Edge 走商店、受管设备走企业策略

插件分发现在有两条线,菜单按浏览器/设备分流,避免现场走弯路:

- 新增「安装浏览器插件(Edge 应用商店)」:优先用 msedge.exe 打开商店安装页
  (mgdonmkicojkabgalgekobaoohaohfcj),点「获取」即可,不需要开发者模式/管理员权限;
  审核期打开会 404,弹窗里已说明;
- 原「安装谷歌插件」改为「安装浏览器插件(企业策略:Chrome / Edge)」,确认框补一句
  「电脑必须已纳管,否则浏览器会拒绝非商店来源扩展」;
- 策略安装失败时,弹窗从只能走开发者模式改为按浏览器给两条路(Edge→商店、Chrome→开发者模式);
- 「卸载谷歌插件」→「卸载浏览器插件(企业策略)」,其余文案统一去掉谷歌字样(Chrome 也叫不了谷歌);
- README:补商店优先、两个 ID(mgdon… / lkei…)不能混装、剪贴板重试改为后台 STA + 截止时间。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-01 05:02:12 +08:00
parent f94fd28f7b
commit 78a923235d
3 changed files with 127 additions and 28 deletions

View File

@ -25,9 +25,10 @@
<MenuItem Header="打开日志目录" Click="OpenLogFolder_Click" />
<MenuItem Header="清理日志" Click="ClearLogs_Click" />
<Separator />
<MenuItem Header="安装谷歌插件(Chrome / Edge)" Click="InstallExtension_Click" />
<MenuItem Header="卸载谷歌插件" Click="UninstallExtension_Click" />
<MenuItem Header="安装浏览器插件(Edge 应用商店)" Click="OpenExtensionStore_Click" />
<MenuItem Header="安装浏览器插件(企业策略:Chrome / Edge)" Click="InstallExtension_Click" />
<MenuItem Header="复制插件路径(开发者模式)" Click="CopyExtensionPath_Click" />
<MenuItem Header="卸载浏览器插件(企业策略)" Click="UninstallExtension_Click" />
<Separator />
<MenuItem Header="清理更新缓存" Click="ClearUpdateCache_Click" />
<Separator />

View File

@ -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
}
/// <summary>
/// 「工具 → 安装谷歌插件」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装
/// 「工具 → 安装浏览器插件(企业策略)」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装
///
/// 扩展 ID 从后端 `/download/extension/updates.xml` 读(由打包私钥决定),
/// 这里不写死 —— 换私钥/换域名都不用改客户端。
/// </summary>
/// <summary>Edge 加载项商店的安装页(审核通过后可用;审核/未上线时打开会是 404,属正常)</summary>
private const string ExtensionStoreUrl =
"https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj";
/// <summary>
/// 「工具 → 安装浏览器插件(Edge 应用商店)」:
/// 非受管 / 没有管理员权限的电脑上,企业策略会被浏览器拒绝,商店是唯一能一键装的路。
/// </summary>
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);
}
}
/// <summary>找 Edge 的可执行文件(没装返回 null)</summary>
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);
}
}
/// <summary>「工具 → 卸载谷歌插件」:删掉我们写的那几条策略(UAC 一次)</summary>
/// <summary>「工具 → 卸载浏览器插件(企业策略)」:删掉我们写的那几条策略(UAC 一次)</summary>
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)
{

View File

@ -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 = <ID>;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`。
### 摄像头识别结果 → 记录 + 安卓播报通知
在「工作台 → 绑定管理」里把某路摄像头设为**面单摄像头**(每个工作台只保留一路,散单/团购都能设)后,识别到的条码