- 工具菜单去掉「安装浏览器插件(企业策略: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>
34 lines
1.8 KiB
Markdown
34 lines
1.8 KiB
Markdown
# 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 重新生成(商店版不受影响,它用商店自己的签名)。
|