# 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 值会被同名校验覆盖)。