网页剪藏插件商店提交

Chrome、Edge 和 Firefox 的上架由官方仓库工作流 Submit Web Clipper 提交。它和 bun run release 分开。正式 GitHub Release 发布后会异步触发商店工作流；商店提交不阻塞 GitHub Release，审核结果也不会改变已发布的 Release。

扩展使用 apps/extension/package.json 中的独立版本号，不跟随根目录 package.json 的主应用版本。仅发布扩展时，合并后手动运行工作流，选择 main 并留空 release_tag 即可，不必另发主应用的 GitHub Release。

Edge 用户安装的是 Chrome 网上应用店商品 gjadpfmanienmlofajibkfkkpfdkclgo。一次 Chrome 提交覆盖这个商品。Firefox 单独提交到 edgeever-web-clipper。这条工作流不向 Microsoft Edge 附加组件网站发布。

工作流会构建安装包、上传并提交审核。它不能代替商店审核。用户会留在各自商店最后一个已通过的版本，直到 Chrome 和 Mozilla 分别审核完成。已经上传过的版本号不能重复使用。提交改动前要先提高 apps/extension/package.json 里的版本。

调用任何商店接口前，命令会把 Firefox 审核源码 ZIP 解压到干净目录，使用冻结的锁文件安装依赖并重新构建。每个产物文件的 SHA-256 必须与提交版本一致，否则停止提交。源码包包含插件引用的 Web 共享 UI 组件；构建 CI 会监听这些依赖的变化，并执行相同的重建检查。两个工作流均使用检出代码中根目录 package.json 指定的 Bun 版本。

运行

打开 https://github.com/tianma-if/edgeever/actions/workflows/extension-store.yml，选择 Run workflow。Firefox 更新说明留空时，使用一行版本说明；也可以贴上希望 Mozilla 展示的说明。dry_run 只构建安装包，不会调用商店。

本机环境里已经放好下面的凭据时，也可以直接运行：

bun run publish:extension -- --dry-run
bun run publish:extension -- --notes "这次改了什么。"

--platform chrome 或 --platform firefox 可以只重试一个商店。Chrome 上同一个版本已经在审核中时，会保持原提交。Firefox 上同一个版本正在审核但还没有源码包时，下一次运行会补上源码包。

Actions 日志和 Summary 会分别报告每个商店的提交动作、API 状态、已确认的公开版本（如有）、失败阶段，以及 API 返回的详细错误或警告。submitted / already-submitted 表示已提交审核，不代表正式上架；STAGED 表示审核通过但仍待发布。只有 API 确认的公开版本或 PUBLISHED 状态才会标记为已上架。工作流不会等待后续审核结果。诊断信息会隐藏凭据和私密审核说明，过长的错误响应会明确标记为截断。API 只返回通用错误时，仍需打开报告中的开发者后台链接查看 API 未公开的具体缺项。修复单个商店的问题后，仅重试对应平台即可。

凭据

把这些 Actions secrets 加到 tianma-if/edgeever。Fork 不会运行这个 Job。

Chrome 可以使用服务账号，也可以使用 refresh token。服务账号不会过几天就失效：

在 Google Cloud 启用 Chrome Web Store API，并创建一个服务账号。不要给它额外的项目角色。
在 Chrome 网上应用店开发者后台的 Account 里添加这个服务账号邮箱。一个发布者只能登记一个服务账号。
创建 JSON 密钥，把整个文件存为 CHROME_WEB_STORE_SERVICE_ACCOUNT_JSON。

refresh token 这条替代路径使用 CHROME_WEB_STORE_CLIENT_ID、 CHROME_WEB_STORE_CLIENT_SECRET 和 CHROME_WEB_STORE_REFRESH_TOKEN，范围是 https://www.googleapis.com/auth/chromewebstore。Google 账号需要开启两步验证。 OAuth 客户端如果停留在测试状态，refresh token 会在七天后失效，所以要把同意屏幕发布出去，或者改用服务账号。

Firefox 使用 https://addons.mozilla.org/developers/addon/api/key/ 生成的 API 密钥：

AMO_JWT_ISSUER
AMO_JWT_SECRET

下面两个可选 secret 会写进 Firefox 给审核员的说明：

EDGE_EVER_REVIEW_INSTANCE_URL
EDGE_EVER_REVIEW_API_TOKEN

Chrome 的上传接口没有更新说明字段。Chrome 的商店简介和隐私披露保持后台里上次保存的内容。权限或公开介绍发生变化时，先在后台修改。Firefox 会把工作流里的说明作为 en-US 版本说明，并附上 apps/extension/SOURCE_BUILD.md 里的构建步骤。

当前 Firefox 商品使用许可证 AGPL-3.0-only。工作流每次提交版本都会带上这个许可证。

4.6 KiB Raw Permalink Blame History Unescape Escape

网页剪藏插件商店提交

运行

凭据

4.6 KiB

Raw Permalink Blame History