Skip to content

pupu v0.2.11

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 Sep 06:52
· 7 commits to main since this release
v0.2.11
aaf117c

本版本起不再提供 .crx —— 原因是它是没用的一类产物，而不是我们打包有问题。

为什么移除 .crx

把自签名 CRX 拖进 Chrome / Edge 会得到：

包无效："CRX_REQUIRED_PROOF_MISSING"。

Chromium 会校验 CRX 内的 proof 是否由 Chrome 应用商店的私钥签名（依据 components/crx_file/crx_verifier.cc：
off-store 来源的 CRX 按 CRX3_WITH_PUBLISHER_PROOF 校验），自签名 CRX 永远不可能满足，
因此拖拽 / 双击 / 普通安装流程一律失败，且文件会被浏览器自动清除。

  • 加 manifest 的 key 字段、或加 update_url 都不解决；
  • 唯一可行路径是机器级强制企业策略（ExtensionInstallAllowlist + ExtensionInstallSources，recommended 会被忽略）；
  • 想彻底摆脱「开发者模式」，唯一途径是上架 Chrome Web Store / Edge 加载项商店。

早期版本把它当作「可直接安装」的产物并在文档里写成推荐方式，这是错误的说法，现已全面更正；
历史 Release（v0.2.5 ～ v0.2.10）里的 .crx 附件也已一并移除，避免其他人继续踩这个坑。

CRX 的打包能力仍保留（pnpm crx / pnpm verify:crx），CI 也会用临时密钥做冒烟测试，
保证这条路径不会失修；将来要做企业策略自托管或上架时会用到它。

📦 安装

  1. 下载下方的 pupu-v0.2.11.zip 并解压（解压后目录中应能直接看到 manifest.json）
  2. 打开 chrome://extensions（Edge 为 edge://extensions），开启右上角「开发者模式」
  3. 点击「加载已解压的扩展程序」，选择解压出的目录

扩展 ID 为 nffpajdealkjpdmjjboneelajanbboig（由签名密钥决定，各版本固定不变）。

🛠 工程调整

  • 本地构建不再产出 zip / crx：pnpm build 只输出可直接「加载已解压」的 build/chrome-mv3-prod/；
    打包由 CI 独占（本地需打包时用 pnpm build:ci）。顺带移除了本地构建里的 npm version patch
    —— 它会自建提交与标签，与「改版本 → 提交 → 打标签」的发版流程冲突
  • 版本号维护已全自动化：扩展内「关于」页取自构建时 manifest，官网/文档站在部署时注入最新标签版本，
    README 徽章动态读取；发布流程还会校验标签与 package.json 一致，不一致直接失败

完整的优化审计与决策记录见 OPTIMIZATION.md（其中 P4-1 记录了本次 CRX 结论与教训）。

Assets 3
Loading