feat(desktop): 下线 Edge 企业策略安装(扩展已上架商店)

- 工具菜单去掉「安装浏览器插件(企业策略: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>
This commit is contained in:
liufumingren 2026-11-01 16:32:55 +08:00
parent 1dc3404eae
commit 6f52613e5e
9 changed files with 85 additions and 552 deletions

View File

@ -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-<version>.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`。
下载地址:`<desktopBaseUrl>/download/desktop/YuncangTraceSetup-<版本>.exe`(新客户端优先)

View File

@ -3,13 +3,15 @@
/**
* Chrome 插件正式包:打包 .crx + 生成 updates.xml,并发布到 nginx 静态目录
*
* 为什么需要它:
* - 浏览器只认**已签名**的扩展包,`chrome://extensions` 里「加载已解压」没法被策略/安装包注入;
* - 企业策略 `ExtensionInstallForcelist` 只接受 `<扩展ID>;<update_url>`,update_url 必须是一个
* 可访问的 XML(不是本地目录);
* 为什么还需要它:
* - 浏览器只认**已签名**的扩展包,需要给内网/离线机器一个可双击安装或自行加载的 `.crx`;
* - `updates.xml` 让这些机器能按 `<扩展ID>;<update_url>` 自动升级(
* 企业策略 `ExtensionInstallForcelist` 用的就是这个组合,客户端已不再写策略,改由 IT 自行下发);
* - 所以这里把仓库里的 `extension/` 打成 `.crx`,连同 `updates.xml` 一起放到
* `deployRoot/download/extension/`(nginx 对 updates.xml 关缓存,.crx 长缓存)。
*
* ⚠️ 正式分发早已改成:Edge 走加载项商店(已上架)、Chrome 走开发者模式加载安装目录里的 `extension/`。
*
* 产物(extension/out/):
* - `YuncangTraceExtension-<version>.crx` 扩展包(文件名带版本号,可以长缓存)
* - `updates.xml` 更新清单(`<app appid>` 就是扩展 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 });
}

View File

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

View File

@ -793,19 +793,15 @@ public partial class MainWindow : Window
}
}
/// <summary>
/// 「工具 → 安装浏览器插件(企业策略)」:写 Chrome/Edge 企业策略(UAC 一次),重启浏览器后自动安装
///
/// 扩展 ID 从后端 `/download/extension/updates.xml` 读(由打包私钥决定),
/// 这里不写死 —— 换私钥/换域名都不用改客户端。
/// </summary>
/// <summary>Edge 加载项商店的安装页(审核通过后可用;审核/未上线时打开会是 404,属正常)</summary>
/// <summary>Edge 加载项商店的安装页(已上架,点「获取」即可)</summary>
private const string ExtensionStoreUrl =
"https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj";
/// <summary>
/// 「工具 → 安装浏览器插件(Edge 应用商店)」:
/// 非受管 / 没有管理员权限的电脑上,企业策略会被浏览器拒绝,商店是唯一能一键装的路。
/// 「工具 → 安装浏览器插件(Edge 应用商店)」:用 msedge.exe 打开商店安装页。
///
/// Edge 扩展已上架商店,装了 Edge 就点「获取」,不需要开发者模式、不需要管理员权限,
/// 也不需要企业策略;Chrome 装不了 Edge 商店的扩展,走「复制插件路径(Chrome / 开发者模式)」。
/// </summary>
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);
}
}
/// <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);
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);
}
}
/// <summary>
/// 「工具 → 复制插件路径(开发者模式)」:插件随安装包释放到 &lt;安装目录&gt;\extension,

View File

@ -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 = <ID>;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`,然后重启浏览器。
### 自动更新怎么工作
```

View File

@ -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;
/// <summary>
/// 「工具 → 安装谷歌插件」:用**企业策略**把 Chrome / Edge 的扩展装上
///
/// 为什么不能像以前那样「复制解压目录 + 加载已解压」:
/// - 那只在开发者模式生效,每台机器要人手动点,Chrome 每次启动还会提示「请停用以开发者模式运行的扩展程序」;
/// - 策略安装(<c>ExtensionInstallForcelist</c>)只认 `<扩展ID>;<update_url>`,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,稳得多。
/// </summary>
public static class ExtensionInstaller
{
/// <summary>更新清单路径(相对后端地址)</summary>
private const string UpdatePath = "/download/extension/updates.xml";
/// <summary>允许安装来源的匹配串(非商店 CRX 必须放行,否则 Chrome 直接拒绝)</summary>
private const string SourcesSuffix = "/download/extension/*";
/// <summary>我们写的策略以后都带这个特征,卸载时按它精确匹配,不误删别人的策略</summary>
private const string OurMarker = "/download/extension/";
/// <summary>Chrome / Edge 的策略根(都支持 ExtensionInstallForcelist + ExtensionInstallSources)</summary>
private static readonly string[] BrowserPolicyRoots =
{
@"SOFTWARE\Policies\Google\Chrome",
@"SOFTWARE\Policies\Microsoft\Edge",
};
/// <summary>用户点了 UAC 的「否」</summary>
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<string> Targets { get; set; } = new();
}
/// <summary>
/// 装插件(**会弹一次 UAC**)
/// </summary>
/// <exception cref="OperationCanceledException">用户取消了 UAC 授权</exception>
/// <exception cref="InvalidOperationException">拉不到更新清单 / 策略没写进去</exception>
public static async Task<HelperResult> 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);
}
/// <summary>卸插件(**会弹一次 UAC**):只删带我们 URL 特征的那几条策略</summary>
public static Task<HelperResult> UninstallAsync(string serverBaseUrl, CancellationToken ct = default)
=> ApplyAsync(NormalizeBase(serverBaseUrl), string.Empty, install: false, ct);
/// <summary>更新清单地址(失败提示里要给用户看)</summary>
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;
}
/// <summary>拉 updates.xml,读 `<app appid="...">`</summary>
private static async Task<string> 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);
}
}
/// <summary>生成 .reg → runas 执行 reg import → 读注册表确认</summary>
private static async Task<HelperResult> 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);
}
}
/// <summary>拼 .reg 文本(空文本 = 没有要改的东西)</summary>
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;
}
/// <summary>
/// 生成某个策略键要写的行(安装 = 写入/复用值名;卸载 = 删除我们写的值)
///
/// 安装时**复用已有的值名**(值就是我们想要的,或值是旧的我们 URL),
/// 顺手把重复的历史值删掉 —— 否则每点一次「安装」都会多出一条一样的策略。
/// </summary>
private static List<string> 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<string>();
// ① 已经是目标值 → 直接用这个值名
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;
}
/// <summary>该策略键下的「值名 → 值」(读不到返回空字典)</summary>
private static Dictionary<string, string> PolicyValues(string policyPath)
{
var result = new Dictionary<string, string>(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;
}
/// <summary>找一个没被占用的值名</summary>
private static string PickFreeValueName(IEnumerable<string> used)
{
var taken = new HashSet<string>(used, StringComparer.OrdinalIgnoreCase);
for (var i = 1; i < 100; i++)
{
if (!taken.Contains(i.ToString())) return i.ToString();
}
return Guid.NewGuid().ToString("N");
}
/// <summary>装成功后该有的那条 forcelist 值在不在(读 HKLM 不需要管理员)</summary>
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;
}
/// <summary>还有没有我们写的策略(卸载后应为 false)</summary>
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;
}
/// <summary>.reg 字符串里的转义(反斜杠、引号)</summary>
private static string Escape(string value)
=> value.Replace("\\", "\\\\").Replace("\"", "\\\"");
private static void TryDelete(string path)
{
try
{
if (File.Exists(path)) File.Delete(path);
}
catch
{
// 临时文件删不掉不影响业务
}
}
}

View File

@ -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-<version>.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-<version>.crx`(文件名带版本号,长缓存)——
这条链路现在只用于**内网/离线分发**,客户端不再写企业策略;
- 正式分发:
- **Edge**:加载项商店(已上架)<https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj>,
桌面端「工具 → 安装浏览器插件(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 加载项商店**(可达、免费)。上架文案、权限说明、截图清单、审核应对

View File

@ -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 下发商店版)。
3. 现场分发话术:统一走 Edge 商店(点「获取」);Chrome 用户走开发者模式。

View File

@ -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 重新生成(商店版不受影响,它用商店自己的签名)。