liufumingren 11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00
..

extension/keys —— 扩展签名私钥(已入库)

文件 说明
key.pem Chrome 扩展签名私钥。决定扩展 ID,npm run extension:publish 用它对 .crx 签名

当前扩展 ID:lkeibbccgdddjamahnkibopcpidhgggk (= 公钥 SHA256 前 16 字节按 a~p 映射;可用 extension/out/extension-id.txt 核对)

为什么入库

桌面端「工具 → 安装谷歌插件」会在客户机写一条企业策略:

HKLM\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist
    1 = lkeibbccgdddjamahnkibopcpidhgggk;https://<域名>/download/extension/updates.xml

策略里写死了扩展 ID,而 ID 由这把私钥唯一决定:

  • 私钥在 → 每次发布都是同一个 ID,客户机策略长期有效;
  • 私钥丢 → 重新生成 → ID 变了 → 已下发到所有客户机的策略全部失效(要重新点一次安装)。

所以按「宁可入库也别丢」处理。⚠️ 代价是:仓库必须保持私有,能读这个仓库的人等于能签发 一个"官方更新"推给所有客户机(Chrome 信任这个私钥签的包)。

绝对不能随安装包发给客户

desktop/YuncangTrace.LocalService.csproj 已经把 extension/keys/** 和 extension/out/** 从输出/发布/安装包里排除了;改那个 Content Include 的 Exclude 时别把这两条删掉。

换机器 / 重建

  • 正常:git clone 下来就有 key.pem,直接 npm run extension:publish 即可;
  • 想换一把新的(会让扩展 ID 变化):删掉 key.pem 再发布,脚本会自动生成; 之后客户机需要重新执行一次「工具 → 安装谷歌插件」(旧的 forcelist 值会被同名校验覆盖)。