# extension/keys —— 扩展签名私钥(**已入库**) | 文件 | 说明 | | --- | --- | | `key.pem` | Chrome 扩展签名私钥。**决定扩展 ID**,`npm run extension:publish` 用它对 `.crx` 签名 | **当前扩展 ID**:`lkeibbccgdddjamahnkibopcpidhgggk` (= 公钥 SHA256 前 16 字节按 `a~p` 映射;可用 `extension/out/extension-id.txt` 核对) ## 为什么入库 私钥决定**扩展 ID**(自建 CRX 分发与内网安装时用;Edge 商店版是另一个 ID,走商店审核 `mgdonmkicojkabgalgekobaoohaohfcj`): - 私钥在 → 每次 `npm run extension:publish` 都是同一个 ID,内网分发的 `updates.xml` 长期有效; - 私钥丢 → 重新生成 → **ID 变了** → 已分发的 CRX 与 `updates.xml` 全部对不上,要重新发。 所以按「宁可入库也别丢」处理。⚠️ 代价是:**仓库必须保持私有**,能读这个仓库的人等于能签发 一个"官方更新"推给所有装了自建 CRX 的机器(浏览器信任这个私钥签的包)。 > 客户端**已不再**用它写企业策略(`ExtensionInstallForcelist` 功能已下线,Edge 上架商店后不需要), > 现在正式分发走商店 / 开发者模式。 ## 绝对不能随安装包发给客户 `desktop/YuncangTrace.LocalService.csproj` 已经把 `extension/keys/**` 和 `extension/out/**` 从输出/发布/安装包里排除了;改那个 `Content Include` 的 `Exclude` 时**别把这两条删掉**。 ## 换机器 / 重建 - 正常:`git clone` 下来就有 `key.pem`,直接 `npm run extension:publish` 即可; - 想换一把新的(**会让扩展 ID 变化**):删掉 `key.pem` 再发布,脚本会自动生成; 之后已分发的内网 `updates.xml` 要对新的 CRX 重新生成(商店版不受影响,它用商店自己的签名)。