From 6f52613e5e5d2e5a56ca52a769442d2cdb34fb8b Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sun, 1 Nov 2026 16:32:55 +0800 Subject: [PATCH] =?UTF-8?q?feat(desktop):=20=E4=B8=8B=E7=BA=BF=20Edge=20?= =?UTF-8?q?=E4=BC=81=E4=B8=9A=E7=AD=96=E7=95=A5=E5=AE=89=E8=A3=85=EF=BC=88?= =?UTF-8?q?=E6=89=A9=E5=B1=95=E5=B7=B2=E4=B8=8A=E6=9E=B6=E5=95=86=E5=BA=97?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 工具菜单去掉「安装浏览器插件(企业策略:Chrome / Edge)」「卸载浏览器插件(企业策略)」, 删除 Services/ExtensionInstaller.cs(.reg 生成 + 提权导入 + 注册表校验) - 只保留「安装浏览器插件(Edge 应用商店)」与「复制插件路径(Chrome / 开发者模式)」; 商店弹窗去掉「审核中会 404」的说法,Chrome 用户直接引导到开发者模式 - 文档同步(桌面 README / 后端 README / extension README / STORE-SUBMISSION / keys README): 写清老机器上残留的 HKLM 策略怎么手工清理,避免和商店版同时注入 - extension:publish(.crx + updates.xml)保留,仅给内网/离线分发用 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- backend/README.md | 16 +- backend/scripts/deploy/publish-extension.cjs | 17 +- desktop/MainWindow.xaml | 4 +- desktop/MainWindow.xaml.cs | 86 +--- desktop/README.md | 41 +- desktop/Services/ExtensionInstaller.cs | 393 ------------------- extension/README.md | 29 +- extension/STORE-SUBMISSION.md | 30 +- extension/keys/README.md | 21 +- 9 files changed, 85 insertions(+), 552 deletions(-) delete mode 100644 desktop/Services/ExtensionInstaller.cs diff --git a/backend/README.md b/backend/README.md index 4da24da..b2f7b4f 100644 --- a/backend/README.md +++ b/backend/README.md @@ -294,7 +294,8 @@ npm run db:deploy:prod # 基线表 + 全部未执行迁移(幂等,可反 发布说明: > ⚠️ `npm run deploy` **只发后端 + 前端 + nginx**:桌面端安装包(`npm run desktop:publish`)和 -> Chrome 插件(`npm run extension:publish`)是**两条独立命令**,不会跟着 deploy 走。 +> Chrome 插件(`npm run extension:publish`)是**两条独立命令**,不会跟着 deploy 走(Edge 扩展已上架商店, +> 这条 `.crx` + `updates.xml` 链路现在只给内网/离线分发用)。 > 三者的远端目录互不重叠(`/download/desktop/`、`/download/extension/`),可以各自单独发布。 - 前端构建产物单独上传到 `deployRoot/frontend`,由 **nginx 直接托管**(SPA 回退到 `index.html`);上一版保留在 `frontend.prev`,`npm run rollback` 会连前端一起切回。 @@ -332,8 +333,8 @@ npm run desktop:publish -- --target=Msi # 只出 MSI(不发 EXE) (路径不能改:老客户端写死 `/download/version.json`;先传安装包,再原子替换 `version.json`); - nginx 的 `/download/` 静态托管该目录:`version.json` 不缓存,安装包长缓存; - `desktop/installer/package.config.json` 的 Production `serverBaseUrl` 必须是 `https://`,安装包内嵌的接口 / 下载地址会跟着变; -- **谷歌插件一起打进包**:`extension/` 发布到 `<安装目录>\extension`;正式分发走企业策略 - (`npm run extension:publish` + 菜单「工具 → 安装谷歌插件」,见下节); +- **浏览器插件一起打进包**:`extension/` 发布到 `<安装目录>\extension`(开发者模式加载用); + 正式分发:Edge 走加载项商店、Chrome 走开发者模式,客户端**不再写企业策略**(见下节); - 不会重启 Egg、不会重新发布后端、不会跑数据库迁移; ### Chrome 插件正式包(.crx + updates.xml) @@ -355,10 +356,11 @@ npm run extension:publish -- --version=1.2.0 --skip-nginx - 产物:`YuncangTraceExtension-.crx`、`updates.xml`、`extension-id.txt`; - 上传到 `deployRoot/download/extension/`;nginx 对 **`updates.xml` 关缓存**(浏览器靠它自动升级), `.crx` 文件名带版本号、走长缓存; -- 扩展 ID 由 `extension/keys/key.pem` 决定(首次运行自动生成,**必须备份**,换了 ID 就变, - 已下发到客户机的策略全部失效); -- 客户机侧:桌面端「工具 → 安装谷歌插件」写 `ExtensionInstallForcelist` + `ExtensionInstallSources` - (Chrome 与 Edge 各一份,HKLM),重启浏览器即自动安装; +- 扩展 ID 由 `extension/keys/key.pem` 决定(首次运行自动生成,**必须备份**,换了 ID 就变); +- ⚠️ 客户端**已不再**用企业策略装自建 CRX:Edge 扩展上架商店后该功能已下线,桌面端没有 + 「一键写策略」的入口。这条 `updates.xml` + `.crx` 链路保留给**内网/离线分发**; +- 正式分发:Edge 用桌面端「工具 → 安装浏览器插件(Edge 应用商店)」点「获取」; + Chrome 用「工具 → 复制插件路径(Chrome / 开发者模式)」到 `chrome://extensions` 加载已解压的扩展程序; - 前置:.NET 8 SDK、WiX 5.0.2(`dotnet tool install --global wix --version 5.0.2`)、Inno Setup 6(`winget install --id JRSoftware.InnoSetup`,出 EXE 用)、`desktop/native/ffmpeg/ffmpeg.exe`。 下载地址:`/download/desktop/YuncangTraceSetup-<版本>.exe`(新客户端优先) diff --git a/backend/scripts/deploy/publish-extension.cjs b/backend/scripts/deploy/publish-extension.cjs index b802af2..de794b6 100644 --- a/backend/scripts/deploy/publish-extension.cjs +++ b/backend/scripts/deploy/publish-extension.cjs @@ -3,13 +3,15 @@ /** * Chrome 插件正式包:打包 .crx + 生成 updates.xml,并发布到 nginx 静态目录 * - * 为什么需要它: - * - 浏览器只认**已签名**的扩展包,`chrome://extensions` 里「加载已解压」没法被策略/安装包注入; - * - 企业策略 `ExtensionInstallForcelist` 只接受 `<扩展ID>;`,update_url 必须是一个 - * 可访问的 XML(不是本地目录); + * 为什么还需要它: + * - 浏览器只认**已签名**的扩展包,需要给内网/离线机器一个可双击安装或自行加载的 `.crx`; + * - `updates.xml` 让这些机器能按 `<扩展ID>;` 自动升级( + * 企业策略 `ExtensionInstallForcelist` 用的就是这个组合,客户端已不再写策略,改由 IT 自行下发); * - 所以这里把仓库里的 `extension/` 打成 `.crx`,连同 `updates.xml` 一起放到 * `deployRoot/download/extension/`(nginx 对 updates.xml 关缓存,.crx 长缓存)。 * + * ⚠️ 正式分发早已改成:Edge 走加载项商店(已上架)、Chrome 走开发者模式加载安装目录里的 `extension/`。 + * * 产物(extension/out/): * - `YuncangTraceExtension-.crx` 扩展包(文件名带版本号,可以长缓存) * - `updates.xml` 更新清单(`` 就是扩展 ID) @@ -287,9 +289,10 @@ async function main() { if (!options.skipNginx) refreshNginx(config); console.log(''); - console.log('发布完成。客户机「工具 → 安装谷歌插件」会写入策略:'); - console.log(` ExtensionInstallForcelist = ${id};${updateUrl}`); - console.log(` ExtensionInstallSources = ${baseUrl}/download/extension/*`); + console.log('发布完成(内网/离线分发用,客户端已不再写企业策略):'); + console.log(` 扩展 ID = ${id}`); + console.log(` 更新地址 = ${updateUrl}`); + console.log(` .crx = ${baseUrl}/download/extension/`); } finally { fs.rmSync(workDir, { recursive: true, force: true }); } diff --git a/desktop/MainWindow.xaml b/desktop/MainWindow.xaml index 9e461fe..ecb1b7d 100644 --- a/desktop/MainWindow.xaml +++ b/desktop/MainWindow.xaml @@ -26,9 +26,7 @@ - - - + diff --git a/desktop/MainWindow.xaml.cs b/desktop/MainWindow.xaml.cs index b1d2c7b..968e0d5 100644 --- a/desktop/MainWindow.xaml.cs +++ b/desktop/MainWindow.xaml.cs @@ -793,19 +793,15 @@ public partial class MainWindow : Window } } - /// - /// 「工具 → 安装浏览器插件(企业策略)」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装 - /// - /// 扩展 ID 从后端 `/download/extension/updates.xml` 读(由打包私钥决定), - /// 这里不写死 —— 换私钥/换域名都不用改客户端。 - /// - /// Edge 加载项商店的安装页(审核通过后可用;审核/未上线时打开会是 404,属正常) + /// Edge 加载项商店的安装页(已上架,点「获取」即可) private const string ExtensionStoreUrl = "https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj"; /// - /// 「工具 → 安装浏览器插件(Edge 应用商店)」: - /// 非受管 / 没有管理员权限的电脑上,企业策略会被浏览器拒绝,商店是唯一能一键装的路。 + /// 「工具 → 安装浏览器插件(Edge 应用商店)」:用 msedge.exe 打开商店安装页。 + /// + /// Edge 扩展已上架商店,装了 Edge 就点「获取」,不需要开发者模式、不需要管理员权限, + /// 也不需要企业策略;Chrome 装不了 Edge 商店的扩展,走「复制插件路径(Chrome / 开发者模式)」。 /// private void OpenExtensionStore_Click(object sender, RoutedEventArgs e) { @@ -829,7 +825,8 @@ public partial class MainWindow : Window "已打开「云仓视频溯源 · 单号注入」的 Edge 加载项页面。\n\n" + "· 点「获取」→「添加扩展」,几秒就装好,不需要开发者模式,也不需要管理员权限;\n" + "· 这个页面只对 Microsoft Edge 有效(Chrome 装不了 Edge 商店的扩展);\n" - + "· 如果页面显示 404,说明商店还在审核中——先用企业策略或开发者模式。", + + "· 用 Chrome 的话:菜单「复制插件路径(Chrome / 开发者模式)」," + + "再到 chrome://extensions 打开开发者模式、加载已解压的扩展程序。", "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); } catch (Exception ex) @@ -859,75 +856,6 @@ public partial class MainWindow : Window 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); - if (confirm != MessageBoxResult.OK) return; - - try - { - var result = await ExtensionInstaller.InstallAsync(_settings.ServerBaseUrl).ConfigureAwait(true); - AppLog.Write($"[extension] 插件策略已写入:{string.Join("、", result.Targets)}(id={result.Id})"); - - MessageBox.Show(this, - $"已为 {string.Join("、", result.Targets)} 写入策略。\n\n" - + $"扩展 ID:{result.Id}\n更新地址:{result.UpdateUrl}\n\n" - + "请完全退出并重新打开浏览器;在 chrome://extensions 里应能看到该插件,并显示「由你的组织管理」。", - "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); - } - catch (OperationCanceledException) - { - MessageBox.Show(this, "已取消管理员授权,浏览器策略没有改动。", - "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); - } - catch (Exception ex) - { - AppLog.Write($"[extension] 安装插件失败:{ex.Message}"); - MessageBox.Show(this, - $"安装失败:{ex.Message}\n\n" - + "没有管理员权限、或电脑没纳管时,浏览器会拒绝企业策略。改用这两条路:\n" - + "· 用 Edge:菜单「安装浏览器插件(Edge 应用商店)」→ 点「获取」;\n" - + "· 用 Chrome:菜单「复制插件路径(开发者模式)」→ chrome://extensions 加载已解压的扩展程序。", - "安装浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning); - } - } - - /// 「工具 → 卸载浏览器插件(企业策略)」:删掉我们写的那几条策略(UAC 一次) - private async void UninstallExtension_Click(object sender, RoutedEventArgs e) - { - var confirm = MessageBox.Show(this, - "将移除 Chrome / Edge 里由本软件写入的插件策略,重启浏览器后插件会被卸载。\n\n继续吗?", - "卸载浏览器插件", MessageBoxButton.OKCancel, MessageBoxImage.Question); - if (confirm != MessageBoxResult.OK) return; - - try - { - var result = await ExtensionInstaller.UninstallAsync(_settings.ServerBaseUrl).ConfigureAwait(true); - AppLog.Write($"[extension] 插件策略已移除:{(result.Targets.Count == 0 ? "没有找到" : string.Join("、", result.Targets))}"); - - MessageBox.Show(this, - result.Targets.Count == 0 - ? "没有找到本软件写入的插件策略(可能本来就没装)。" - : "已移除插件策略,重启浏览器后插件会被卸载。", - "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); - } - catch (OperationCanceledException) - { - MessageBox.Show(this, "已取消管理员授权,浏览器策略没有改动。", - "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Information); - } - catch (Exception ex) - { - AppLog.Write($"[extension] 卸载插件失败:{ex.Message}"); - MessageBox.Show(this, $"卸载失败:{ex.Message}", "卸载浏览器插件", MessageBoxButton.OK, MessageBoxImage.Warning); - } - } /// /// 「工具 → 复制插件路径(开发者模式)」:插件随安装包释放到 <安装目录>\extension, diff --git a/desktop/README.md b/desktop/README.md index ecfb8df..5f05cbe 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -243,45 +243,36 @@ cd desktop\installer > 安装包与版本信息都归到后端 `desktop` 子目录:下载地址 `<域名>/download/desktop/YuncangTraceSetup-x.y.z.exe`(新客户端) > 和 `.msi`(老客户端),版本信息仍是 `<域名>/download/version.json`(老客户端写死了这个地址,不能改)。 -### 谷歌浏览器插件 +### 浏览器插件 仓库根目录的 `extension/dist`(压缩产物)会一起打进 MSI / EXE,安装后固定在 **`<安装目录>\extension`** (perUser 安装即 `%LOCALAPPDATA%\Programs\YuncangTrace\extension`)。 -**首选:Edge 加载项商店(非受管电脑也能装)** —— +**Edge:加载项商店(已上架)** —— - 菜单「工具 → **安装浏览器插件(Edge 应用商店)**」:装了 Edge 就用 `msedge.exe` 打开 - `https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj`, - 用户点「获取」即可;**不需要开发者模式,也不需要管理员权限**; -- 这个链接**审核通过后**才有效(审核中打开是 404);商店版扩展 ID 是 `mgdonmkicojkabgalgekobaoohaohfcj`; -- 只对 Edge 有效:Chrome 装不了 Edge 商店的扩展,请走下面的企业策略或开发者模式。 + `https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj`,点「获取」即可; + **不需要开发者模式、不需要管理员权限,也不写任何策略**; +- 商店版扩展 ID:`mgdonmkicojkabgalgekobaoohaohfcj`;装好后由 Edge 商店自己更新; +- 只对 Edge 有效:Chrome 装不了 Edge 商店的扩展,用下面的开发者模式。 -**受管设备:企业策略安装(零开发者模式)** —— `Services/ExtensionInstaller.cs`: +**Chrome:开发者模式** —— -- 菜单「工具 → **安装浏览器插件(企业策略: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/` 的那几条,不影响别人写的策略; -- 前提:发布端已执行过 `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`)复制到剪贴板; +- 菜单「工具 → 复制插件路径(Chrome / 开发者模式)」直接把该目录的 **Windows 路径**(如 `C:\Users\xxx\AppData\Local\Programs\YuncangTrace\extension`)复制到剪贴板; 写剪贴板全程在后台 STA 线程、带截止时间退避重试(WPF → WinForms → 补 `OleFlushClipboard`), 被远程桌面(实测 BilldDesk)/ 输入法 / 剪贴板工具占用时不会卡住界面、也不会误报; **复制前先核对内容**:剪贴板里已经是这个路径就直接算成功;确实写不进去才提示,并告知是哪个进程占着,可选「打开记事本」手动抄写; - 用户打开 `chrome://extensions` → 打开「开发者模式」→「加载已解压的扩展程序」→ 粘贴路径即可; - 卸载时该目录随安装包一起删除; +> ⚠️ **企业策略安装已下线**(`ExtensionInstallForcelist`,菜单里的「安装/卸载浏览器插件(企业策略)」 +> 和 `Services/ExtensionInstaller.cs` 一起删掉了):Edge 上架商店后不再需要它。 +> 老版本写在客户机 HKLM 里的策略**不会自己消失** —— 那些机器的 `chrome://extensions` 里会留一个 +> 「由你的组织管理」的旧同名插件(自建 CRX,ID `lkei…`),和商店版同时装会注入两遍。手动清理: +> 删掉 `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist` 与 +> `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallForcelist` 下值里带 +> `/download/extension/` 的项,以及同级的 `ExtensionInstallSources`,然后重启浏览器。 + ### 自动更新怎么工作 ``` diff --git a/desktop/Services/ExtensionInstaller.cs b/desktop/Services/ExtensionInstaller.cs deleted file mode 100644 index 9443876..0000000 --- a/desktop/Services/ExtensionInstaller.cs +++ /dev/null @@ -1,393 +0,0 @@ -using System; -using System.Collections.Generic; -using System.ComponentModel; -using System.Diagnostics; -using System.IO; -using System.Linq; -using System.Net.Http; -using System.Text; -using System.Threading; -using System.Threading.Tasks; -using System.Xml.Linq; -using Microsoft.Win32; - -namespace YuncangTrace.LocalService.Services; - -/// -/// 「工具 → 安装谷歌插件」:用**企业策略**把 Chrome / Edge 的扩展装上 -/// -/// 为什么不能像以前那样「复制解压目录 + 加载已解压」: -/// - 那只在开发者模式生效,每台机器要人手动点,Chrome 每次启动还会提示「请停用以开发者模式运行的扩展程序」; -/// - 策略安装(ExtensionInstallForcelist)只认 `<扩展ID>;`,update_url 必须是 -/// 一个可访问的 XML(我们自己的 `/download/extension/updates.xml`),**不认本地目录**。 -/// -/// 实现方式(**不依赖进程间回传结果**): -/// 1. 去后端拉 `updates.xml` 读出扩展 ID; -/// 2. 生成一个 `.reg` 文件(写 HKLM 策略); -/// 3. runas 执行 `reg.exe import`(一次 UAC); -/// 4. **直接读注册表**确认写没写进去 —— 成功与否以注册表为准,不看子进程输出。 -/// -/// ⚠️ 早期版本用「runas 起自己 + 临时文件回传结果」,现场出现过 -/// 「提权进程退出码 0 但结果文件没写」→ 装不上。reg import 只有一步动作、没有 IPC,稳得多。 -/// -public static class ExtensionInstaller -{ - /// 更新清单路径(相对后端地址) - private const string UpdatePath = "/download/extension/updates.xml"; - - /// 允许安装来源的匹配串(非商店 CRX 必须放行,否则 Chrome 直接拒绝) - private const string SourcesSuffix = "/download/extension/*"; - - /// 我们写的策略以后都带这个特征,卸载时按它精确匹配,不误删别人的策略 - private const string OurMarker = "/download/extension/"; - - /// Chrome / Edge 的策略根(都支持 ExtensionInstallForcelist + ExtensionInstallSources) - private static readonly string[] BrowserPolicyRoots = - { - @"SOFTWARE\Policies\Google\Chrome", - @"SOFTWARE\Policies\Microsoft\Edge", - }; - - /// 用户点了 UAC 的「否」 - private const int ErrorCancelled = 1223; - - public sealed class HelperResult - { - public bool Ok { get; set; } - public string? Error { get; set; } - public string? Id { get; set; } - public string? UpdateUrl { get; set; } - public List Targets { get; set; } = new(); - } - - /// - /// 装插件(**会弹一次 UAC**) - /// - /// 用户取消了 UAC 授权 - /// 拉不到更新清单 / 策略没写进去 - public static async Task InstallAsync(string serverBaseUrl, CancellationToken ct = default) - { - var baseUrl = NormalizeBase(serverBaseUrl); - var id = await FetchExtensionIdAsync(baseUrl, ct).ConfigureAwait(false); - return await ApplyAsync(baseUrl, id, install: true, ct).ConfigureAwait(false); - } - - /// 卸插件(**会弹一次 UAC**):只删带我们 URL 特征的那几条策略 - public static Task UninstallAsync(string serverBaseUrl, CancellationToken ct = default) - => ApplyAsync(NormalizeBase(serverBaseUrl), string.Empty, install: false, ct); - - /// 更新清单地址(失败提示里要给用户看) - public static string UpdateUrlOf(string serverBaseUrl) => NormalizeBase(serverBaseUrl) + UpdatePath; - - private static string NormalizeBase(string serverBaseUrl) - { - var value = (serverBaseUrl ?? string.Empty).Trim().TrimEnd('/'); - if (value.Length == 0) throw new InvalidOperationException("后端地址为空,无法安装插件"); - return value; - } - - /// 拉 updates.xml,读 `` - private static async Task FetchExtensionIdAsync(string baseUrl, CancellationToken ct) - { - var url = baseUrl + UpdatePath; - using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(10) }; - - string xml; - try - { - xml = await http.GetStringAsync(url, ct).ConfigureAwait(false); - } - catch (HttpRequestException ex) - { - throw new InvalidOperationException( - $"拿不到插件更新清单({url}):{ex.Message}\n\n" - + "服务端还没发布过插件包?先执行 backend 的 npm run extension:publish。", ex); - } - - try - { - var id = XDocument.Parse(xml) - .Descendants() - .FirstOrDefault(element => element.Name.LocalName == "app") - ?.Attribute("appid")?.Value?.Trim(); - - if (string.IsNullOrEmpty(id) || id.Length != 32) - { - throw new InvalidOperationException($"更新清单里没有有效的 appid({url})"); - } - return id; - } - catch (Exception ex) when (ex is not InvalidOperationException) - { - throw new InvalidOperationException($"解析插件更新清单失败({url}):{ex.Message}", ex); - } - } - - /// 生成 .reg → runas 执行 reg import → 读注册表确认 - private static async Task ApplyAsync(string baseUrl, string id, bool install, CancellationToken ct) - { - var regFile = Path.Combine(Path.GetTempPath(), $"yuncang_ext_{Guid.NewGuid():N}.reg"); - var regText = BuildReg(baseUrl, id, install); - - if (regText.Length == 0) - { - // 卸载时没有任何我们写的值:直接算成功 - AppLog.Write("[extension] 没有找到本软件写入的策略,无需提权"); - return new HelperResult { Ok = true, Id = id, UpdateUrl = baseUrl + UpdatePath }; - } - - File.WriteAllText(regFile, regText, Encoding.Unicode); - - var regExe = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "reg.exe"); - var psi = new ProcessStartInfo(regExe, $"import \"{regFile}\"") - { - UseShellExecute = true, // runas 只能走 ShellExecute - Verb = "runas", - WindowStyle = ProcessWindowStyle.Hidden, - CreateNoWindow = true, - }; - - AppLog.Write($"[extension] 提权导入策略({(install ? "安装" : "卸载")}):{psi.FileName} {psi.Arguments}"); - - try - { - using var process = await Task.Run(() => Process.Start(psi), ct).ConfigureAwait(false) - ?? throw new InvalidOperationException("提权进程启动失败"); - - await process.WaitForExitAsync(ct).ConfigureAwait(false); - - // 以注册表实际状态为准(reg 的退出码在不同系统上不完全可靠) - var ok = install ? HasExactPolicy(id, baseUrl) : !HasAnyOfOurPolicy(); - if (!ok) - { - AppLog.Write($"[extension] reg import 退出码 {process.ExitCode},但注册表未生效({regText})"); - throw new InvalidOperationException( - $"策略没有写进注册表(reg import 退出码 {process.ExitCode})。\n\n" - + "可能被安全软件拦截了注册表写入;也可以手动导入下面这个文件后重试:\n" - + regFile); - } - - return new HelperResult - { - Ok = true, - Id = id, - UpdateUrl = baseUrl + UpdatePath, - Targets = BrowserPolicyRoots.Select(root => root.EndsWith("Chrome", StringComparison.OrdinalIgnoreCase) ? "Chrome" : "Edge").ToList(), - }; - } - catch (Win32Exception ex) when (ex.NativeErrorCode == ErrorCancelled) - { - throw new OperationCanceledException("已取消管理员授权,浏览器策略没有改动"); - } - finally - { - TryDelete(regFile); - } - } - - /// 拼 .reg 文本(空文本 = 没有要改的东西) - private static string BuildReg(string baseUrl, string id, bool install) - { - var updateUrl = baseUrl + UpdatePath; - var sources = baseUrl + SourcesSuffix; - - var builder = new StringBuilder(); - var hasContent = false; - - foreach (var root in BrowserPolicyRoots) - { - var forcelistPath = root + @"\ExtensionInstallForcelist"; - var sourcesPath = root + @"\ExtensionInstallSources"; - - var forcelistLines = BuildValueLines(forcelistPath, $"{id};{updateUrl}", install); - var sourcesLines = BuildValueLines(sourcesPath, sources, install); - - if (forcelistLines.Count == 0 && sourcesLines.Count == 0) continue; - - if (!hasContent) - { - builder.AppendLine("Windows Registry Editor Version 5.00"); - hasContent = true; - } - - if (forcelistLines.Count > 0) - { - builder.AppendLine(); - builder.AppendLine($"[HKEY_LOCAL_MACHINE\\{forcelistPath}]"); - foreach (var line in forcelistLines) builder.AppendLine(line); - } - - if (sourcesLines.Count > 0) - { - builder.AppendLine(); - builder.AppendLine($"[HKEY_LOCAL_MACHINE\\{sourcesPath}]"); - foreach (var line in sourcesLines) builder.AppendLine(line); - } - } - - return hasContent ? builder.ToString() : string.Empty; - } - - /// - /// 生成某个策略键要写的行(安装 = 写入/复用值名;卸载 = 删除我们写的值) - /// - /// 安装时**复用已有的值名**(值就是我们想要的,或值是旧的我们 URL), - /// 顺手把重复的历史值删掉 —— 否则每点一次「安装」都会多出一条一样的策略。 - /// - private static List BuildValueLines(string policyPath, string desiredValue, bool install) - { - var existing = PolicyValues(policyPath); - - if (!install) - { - return existing - .Where(item => item.Value.Contains(OurMarker, StringComparison.OrdinalIgnoreCase)) - .Select(item => $"\"{item.Key}\"=-") - .ToList(); - } - - var lines = new List(); - - // ① 已经是目标值 → 直接用这个值名 - var target = existing - .FirstOrDefault(item => string.Equals(item.Value.Trim(), desiredValue, StringComparison.OrdinalIgnoreCase)) - .Key; - - // ② 否则复用「我们写的旧值」那个名字(比如域名换过) - if (target is null) - { - target = existing - .FirstOrDefault(item => item.Value.Contains(OurMarker, StringComparison.OrdinalIgnoreCase)) - .Key; - } - - // ③ 都没有才找一个空号(默认 "1",被别人占了就顺延) - target ??= PickFreeValueName(existing.Keys); - - lines.Add($"\"{target}\"=\"{Escape(desiredValue)}\""); - - // 清掉重复的历史条目(同一个扩展我们可能写过多条) - foreach (var item in existing) - { - if (string.Equals(item.Key, target, StringComparison.OrdinalIgnoreCase)) continue; - if (!item.Value.Contains(OurMarker, StringComparison.OrdinalIgnoreCase)) continue; - lines.Add($"\"{item.Key}\"=-"); - } - - return lines; - } - - /// 该策略键下的「值名 → 值」(读不到返回空字典) - private static Dictionary PolicyValues(string policyPath) - { - var result = new Dictionary(StringComparer.OrdinalIgnoreCase); - try - { - using var baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry64); - using var key = baseKey.OpenSubKey(policyPath); - if (key is null) return result; - - foreach (var name in key.GetValueNames()) - { - if (key.GetValue(name) is string text) result[name] = text; - } - } - catch - { - // 读不到就当没有 - } - return result; - } - - /// 找一个没被占用的值名 - private static string PickFreeValueName(IEnumerable used) - { - var taken = new HashSet(used, StringComparer.OrdinalIgnoreCase); - for (var i = 1; i < 100; i++) - { - if (!taken.Contains(i.ToString())) return i.ToString(); - } - return Guid.NewGuid().ToString("N"); - } - - /// 装成功后该有的那条 forcelist 值在不在(读 HKLM 不需要管理员) - private static bool HasExactPolicy(string id, string baseUrl) - { - if (id.Length == 0) return false; - var expected = $"{id};{baseUrl}{UpdatePath}"; - - foreach (var root in BrowserPolicyRoots) - { - foreach (var view in new[] { RegistryView.Registry64, RegistryView.Registry32 }) - { - try - { - using var baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, view); - using var key = baseKey.OpenSubKey(root + @"\ExtensionInstallForcelist"); - if (key is null) continue; - - foreach (var name in key.GetValueNames()) - { - if (key.GetValue(name) is string text - && string.Equals(text.Trim(), expected, StringComparison.OrdinalIgnoreCase)) - { - return true; - } - } - } - catch - { - // 读不到就当没有 - } - } - } - return false; - } - - /// 还有没有我们写的策略(卸载后应为 false) - private static bool HasAnyOfOurPolicy() - { - foreach (var root in BrowserPolicyRoots) - { - foreach (var view in new[] { RegistryView.Registry64, RegistryView.Registry32 }) - { - try - { - using var baseKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, view); - using var key = baseKey.OpenSubKey(root + @"\ExtensionInstallForcelist"); - if (key is null) continue; - - foreach (var name in key.GetValueNames()) - { - if (key.GetValue(name) is string text - && text.Contains(OurMarker, StringComparison.OrdinalIgnoreCase)) - { - return true; - } - } - } - catch - { - // 读不到就当没有 - } - } - } - return false; - } - - /// .reg 字符串里的转义(反斜杠、引号) - private static string Escape(string value) - => value.Replace("\\", "\\\\").Replace("\"", "\\\""); - - private static void TryDelete(string path) - { - try - { - if (File.Exists(path)) File.Delete(path); - } - catch - { - // 临时文件删不掉不影响业务 - } - } -} diff --git a/extension/README.md b/extension/README.md index 8d8200f..0923376 100644 --- a/extension/README.md +++ b/extension/README.md @@ -35,7 +35,7 @@ Chrome / Edge 扩展(**Manifest V3 + 原生 JS,零构建**)。 --- -## 0.1 打包与分发(企业策略安装) +## 0.1 打包与分发 浏览器**不认「加载已解压」之外的本地目录**,所以正式分发必须打包成签名好的 `.crx`: @@ -55,19 +55,22 @@ npm run extension:zip # 压缩 + 出商店上传包(extension/out/*.zip 而且 Chrome/Edge 商店要求提交的代码可读;压缩后已经去掉全部注释、缩短了标识符, 真正需要保密的东西也不在插件里(前缀/正则/站点全部由服务端下发,私钥从不进包)。 -- 私钥 `extension/keys/key.pem`(首次运行自动生成,**务必单独备份**):它决定**扩展 ID**, - 换了私钥 = 换了 ID = 已经下发到客户机的策略全部失效; -- 服务器上:`/download/extension/updates.xml`(**不缓存**,浏览器靠它自动升级)、 - `/download/extension/YuncangTraceExtension-.crx`(文件名带版本号,长缓存); -- 客户机:桌面端「工具 → **安装谷歌插件**」→ 允许一次 UAC → 写 HKLM 策略: - ``` - Chrome/Edge ExtensionInstallForcelist = <扩展ID>;https://<域名>/download/extension/updates.xml - Chrome/Edge ExtensionInstallSources = https://<域名>/download/extension/* - ``` - 重启浏览器即自动装好(`chrome://extensions` 里显示「由你的组织管理」)。 - 「工具 → 卸载谷歌插件」只会删掉值里带 `/download/extension/` 的那几条,不动别的策略。 +- 私钥 `extension/keys/key.pem`(首次运行自动生成,**务必单独备份**):它决定**扩展 ID**; +- 服务器上:`/download/extension/updates.xml`(**不缓存**)、 + `/download/extension/YuncangTraceExtension-.crx`(文件名带版本号,长缓存)—— + 这条链路现在只用于**内网/离线分发**,客户端不再写企业策略; +- 正式分发: + - **Edge**:加载项商店(已上架), + 桌面端「工具 → 安装浏览器插件(Edge 应用商店)」直接打开,点「获取」即可; + - **Chrome**:桌面端「工具 → 复制插件路径(Chrome / 开发者模式)」,到 `chrome://extensions` + 开开发者模式、加载已解压的扩展程序。 -没有管理员权限的机器仍可用「工具 → 复制插件路径(开发者模式)」手动加载(拿到的是安装目录里的压缩版)。 +> ⚠️ 早期版本用 `ExtensionInstallForcelist` 写 HKLM 策略装自建 CRX(ID `lkei…`),**该功能已下线**。 +> 用过旧版本的机器策略仍在,会和商店版同时注入 —— 手动删掉 `...\Policies\Google\Chrome\ExtensionInstallForcelist` +> 与 `...\Policies\Microsoft\Edge\ExtensionInstallForcelist` 里值带 `/download/extension/` 的项 +> 及同级 `ExtensionInstallSources`,重启浏览器即可。 + +没有管理员权限的机器仍可用「工具 → 复制插件路径(Chrome / 开发者模式)」手动加载(拿到的是安装目录里的压缩版)。 > 国内环境下 **Chrome 应用商店连不上**(实测 `chromewebstore.google.com`、`clients2.google.com` 均超时), > 官方分发走 **Edge 加载项商店**(可达、免费)。上架文案、权限说明、截图清单、审核应对 diff --git a/extension/STORE-SUBMISSION.md b/extension/STORE-SUBMISSION.md index 3bce869..ce4cab5 100644 --- a/extension/STORE-SUBMISSION.md +++ b/extension/STORE-SUBMISSION.md @@ -10,12 +10,14 @@ | 路线 | 覆盖谁 | 国内可用 | 现状 | |---|---|---|---| -| **Edge 加载项商店** | 所有 Edge 用户,**非受管/非开发者模式也能一键装** | ✅ | 待上架(免费) | -| 企业策略 + 自建 CRX | 仅**受管设备**(加域 / Intune / 组策略) | ✅ | 已实现:菜单「安装谷歌插件」 | -| 开发者模式手动加载 | 任何 Chromium 内核浏览器 | ✅ | 已实现:菜单「复制插件路径(开发者模式)」 | +| **Edge 加载项商店** | 所有 Edge 用户,**非受管/非开发者模式也能一键装** | ✅ | **已上架**(免费) | +| 开发者模式手动加载 | 任何 Chromium 内核浏览器 | ✅ | 已实现:菜单「复制插件路径(Chrome / 开发者模式)」 | 非受管电脑上 `ExtensionInstallForcelist` 会被 Chrome/Edge 拒绝(`[BLOCKED]`,提示"此设备并非由你的组织管理"), -所以**普通员工电脑只有商店这条路**。 +所以**普通员工电脑只有商店这条路**;受管设备同样直接装商店版(IT 也能统一下发商店扩展)。 + +> 企业策略 + 自建 CRX 这条路线已下线:桌面端的「安装/卸载浏览器插件(企业策略)」菜单 +> 和 `Services/ExtensionInstaller.cs` 都已移除。 ## 1. 上架前检查清单 @@ -145,19 +147,20 @@ Policy: https://pack.wms.gztbyc.com/extension-privacy.html 1. **扩展 ID 会变**:商店用微软的密钥签名,ID 不再是 `lkeibbccgdddjamahnkibopcpidhgggk`(那是 `extension/keys/key.pem` 算出来的自建 ID)。 - 商店版:用户在 Edge 加载项页面点「获取」即可,**不需要**写策略; - - 自建 CRX(受管设备):继续用现有 ID 与 `updates.xml`,两条线互不影响。 + - 自建 CRX:只保留给内网/离线分发(`updates.xml` 仍会发布),客户端不再提供一键安装入口。 2. **升级流程**:改代码 → 改 `manifest.json` 的 `version` → `cd backend && npm run extension:zip` → - 在 Partner Center 上传新 zip → 审核通过后用户自动升级(Edge 端的自建 CRX 仍走 `npm run extension:publish`)。 + 在 Partner Center 上传新 zip → 审核通过后用户自动升级。 3. 商店版和自建 CRX 版是**两个不同 ID 的扩展**,同一浏览器都装会同时注入、页面被标记两遍—— - 过渡期务必先「工具 → 卸载谷歌插件」清掉旧策略,再装商店版。详见第 9 节。 + 用过旧版企业策略的机器要先手工清掉 HKLM 里那几条 `ExtensionInstallForcelist` / + `ExtensionInstallSources`(见 `desktop/README.md` 的「浏览器插件」一节),再装商店版。 ## 7. 现场操作对照 | 场景 | 操作 | |---|---| | 员工电脑(非受管)、用 Edge | 打开加载项商店页面 → 「获取」 | -| 员工电脑(加域 / 受管) | 桌面端「工具 → 安装谷歌插件」(写 HKLM 策略 + 自建 CRX) | -| 临时/无管理员权限 | 桌面端「工具 → 复制插件路径(开发者模式)」→ `edge://extensions` 加载已解压 | +| 员工电脑(加域 / 受管) | 同上,直接装商店版(也可由 IT 统一下发商店扩展) | +| 临时/无管理员权限 | 桌面端「工具 → 复制插件路径(Chrome / 开发者模式)」→ `chrome://extensions` 加载已解压 | | 国产 Chromium 浏览器(360/QQ/搜狗) | 多数支持"加载已解压的扩展程序",用同一条路径 | ## 8. 提交时逐字段对照表(Package 上传之后) @@ -218,16 +221,17 @@ PwIDAQAB | 版本 | 扩展 ID | 由谁签名 | 装法 | |---|---|---|---| -| 自建 CRX(企业策略) | `lkeibbccgdddjamahnkibopcpidhgggk` | 我们的 `extension/keys/key.pem` | 桌面端「工具 → 安装谷歌插件」写 HKLM 策略 | +| 自建 CRX(内网/离线) | `lkeibbccgdddjamahnkibopcpidhgggk` | 我们的 `extension/keys/key.pem` | 客户端不再提供入口(企业策略已下线) | | Edge 商店版 | `mgdonmkicojkabgalgekobaoohaohfcj` | 微软密钥(上表公钥) | 用户在加载项商店点「获取」 | - 用上面那把公钥实测推导,得到的正是 `mgdon…`,确认它就是商店的签名公钥; - **CRX 的 ID 由签名密钥决定**,别试图用 manifest 的 `key` 字段把两个 ID 统一(会与签名密钥冲突); -- 两个 ID = 两个独立扩展(配置、注入各自一套)。过渡期先「卸载谷歌插件」再装商店版; -- 目前自建 ID `lkei…` 只在开发机上装过(非受管电脑的策略安装本来就被浏览器拒绝),所以切到商店版几乎零成本。 +- 两个 ID = 两个独立扩展(配置、注入各自一套)。老机器如果被旧版策略装过自建 CRX, + 先按桌面端 README 的说明清掉 HKLM 策略再装商店版; +- 目前自建 ID `lkei…` 只在开发机上装过(非受管电脑的策略安装本来就被浏览器拒绝),所以切到商店版几乎零成本; ### 发布后的接入动作(TODO) 1. 把安装页 URL 填进桌面端「工具」菜单:新增「安装浏览器插件(商店)」→ 用默认浏览器打开该链接; 2. 链接可用性自查:`curl -I https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj` 返回 200 即上线; -3. 现场分发话术:非受管电脑 → 商店安装;受管电脑 → 企业策略自建 CRX(或让 IT 下发商店版)。 \ No newline at end of file +3. 现场分发话术:统一走 Edge 商店(点「获取」);Chrome 用户走开发者模式。 \ No newline at end of file diff --git a/extension/keys/README.md b/extension/keys/README.md index 578f2a0..66f67cb 100644 --- a/extension/keys/README.md +++ b/extension/keys/README.md @@ -9,20 +9,17 @@ ## 为什么入库 -桌面端「工具 → 安装谷歌插件」会在客户机写一条企业策略: +私钥决定**扩展 ID**(自建 CRX 分发与内网安装时用;Edge 商店版是另一个 ID,走商店审核 +`mgdonmkicojkabgalgekobaoohaohfcj`): -``` -HKLM\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist - 1 = lkeibbccgdddjamahnkibopcpidhgggk;https://<域名>/download/extension/updates.xml -``` - -策略里写死了**扩展 ID**,而 ID 由这把私钥唯一决定: - -- 私钥在 → 每次发布都是同一个 ID,客户机策略长期有效; -- 私钥丢 → 重新生成 → **ID 变了** → 已下发到所有客户机的策略全部失效(要重新点一次安装)。 +- 私钥在 → 每次 `npm run extension:publish` 都是同一个 ID,内网分发的 `updates.xml` 长期有效; +- 私钥丢 → 重新生成 → **ID 变了** → 已分发的 CRX 与 `updates.xml` 全部对不上,要重新发。 所以按「宁可入库也别丢」处理。⚠️ 代价是:**仓库必须保持私有**,能读这个仓库的人等于能签发 -一个"官方更新"推给所有客户机(Chrome 信任这个私钥签的包)。 +一个"官方更新"推给所有装了自建 CRX 的机器(浏览器信任这个私钥签的包)。 + +> 客户端**已不再**用它写企业策略(`ExtensionInstallForcelist` 功能已下线,Edge 上架商店后不需要), +> 现在正式分发走商店 / 开发者模式。 ## 绝对不能随安装包发给客户 @@ -33,4 +30,4 @@ HKLM\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist - 正常:`git clone` 下来就有 `key.pem`,直接 `npm run extension:publish` 即可; - 想换一把新的(**会让扩展 ID 变化**):删掉 `key.pem` 再发布,脚本会自动生成; - 之后客户机需要重新执行一次「工具 → 安装谷歌插件」(旧的 forcelist 值会被同名校验覆盖)。 + 之后已分发的内网 `updates.xml` 要对新的 CRX 重新生成(商店版不受影响,它用商店自己的签名)。