SuperAPI AI 工具集

build-chrome-extension

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:构建、调试、打包并发布 Chrome Manifest V3 扩展,重点处理可重启的 service worker、隔离的 content script、最小权限与 Web Store 审核就绪。适用触发场景包括:新建 MV3 扩展或基于 WXT、Plasmo、CRXJS、Vite 脚手架;编辑或生成 manifest_version 3 的 manifest.json(service_worker、content_scripts、host_permissions、action、side_panel);实现或调试 chrome.runtime、storage、alarms、scripting、tabs、declarativeNetRequest、sidePanel、offscreen;修复 MV3 service worker 生命周期问题(空闲终止、顶层监听注册、异步 onMessage、alarms 替代 setInterval);ISOLATED 与 MAIN world 桥接、通过 service worker 路由跨域请求;MV2 迁移 MV3;校验 dist/ 或 .output/chrome-mv3/ 并打包审核。不适用于 Firefox/Safari/跨浏览器 polyfill、通用浏览器自动化、发布 npm 包或其他平台扩展。主要能力与默认约定:仅用 manifest_version 3;新项目默认 WXT;持久状态用 chrome.storage.local/session;后台为事件驱动 service worker,监听器在顶层同步注册;定时用 chrome.alarms(periodInMinutes ≥ 0.5);网络修改用 declarativeNetRequest;权限最小化,优先 optional_permissions 与 optional_host_permissions。使用方式:先明确扩展界面与所需 Chrome API 和权限,再脚手架或适配现有仓库,按 contexts 实现代码,用脚本校验构建产物,最后打包。加载目录须为构建产物:WXT .output/chrome-mv3-dev/ 或 .output/chrome-mv3/;Plasmo build/chrome-mv3-*;CRXJS/Vite dist/。打包前运行:scripts/check-mv3-manifest.sh dist 与 scripts/preflight-extension.sh dist。限制:不得为新工作生成或保留 MV2;不在 Chrome 中加载 src/;service worker 模块级全局不保存持久状态;不依赖 setTimeout/setInterval 维持存活;不用阻塞式 webRequest;不无故申请 <all_urls>;不通过未认证的 content script 消息暴露后台任意 fetch;不发布远程可执行代码。打包 zip 从构建输出目录内部创建,使 manifest.json 位于根目录,并准备隐私说明、逐权限理由与审核测试说明。其它细节暂未提供。