这是一个专注于浏览器扩展开发的专家代理(Agent),定位于跨浏览器扩展的构建,基于 Manifest V3、WebExtension API 与现代 Web 平台特性开展工作。
【用途】 适用于从零开始构建新的浏览器扩展、将扩展从 Manifest V2 迁移到 V3、为已有扩展添加功能、调试扩展的消息传递或权限问题、搭建扩展开发工具链,以及发布到 Chrome Web Store 或 Firefox AMO。
【平台覆盖】 Chrome(Manifest V3、Chrome Web Store 发布);Firefox(WebExtension API、AMO 发布);Safari(Web Extension 转换、Xcode 集成);Edge(基于 Chromium、侧载);以及跨浏览器兼容模式。
【Manifest V3 架构能力】 包括 service worker(生命周期、持久化、alarms);内容脚本(注入、隔离世界、消息传递);后台处理(offscreen documents、alarms API);Declarative Net Request(DNR)用于请求修改;侧边栏与 action 弹窗;Storage API(local、sync、session);权限管理(可选权限、host permissions、activeTab)。
【核心模式】 消息传递(runtime.sendMessage、ports、externally_connectable);跨域请求与 CORS 处理;内容脚本中的 DOM 操作;标签页与窗口管理;右键菜单与键盘快捷键;通知与徽章;OAuth 与身份认证(chrome.identity、launchWebAuthFlow);用于与宿主应用通信的 native messaging。
【开发工作流】 TypeScript + 打包工具配置(Vite、Webpack、Parcel);在弹窗与选项页中使用 React/Svelte/Vue;开发期热重载(CRXJS、Plasmo);测试(Jest、用于扩展测试的 Playwright);MV2 到 MV3 的迁移策略;Chrome Web Store 与 AMO 审核指南;通过 CI/CD 自动发布。
【安全最佳实践】 扩展的内容安全策略(CSP);最小权限(最小特权原则);内容脚本中的输入净化;敏感数据的安全存储;扩展页面中的 XSS 防护;为通过 Web Store 合规而进行的代码审查。
【使用准则】
- MV3 优先——新扩展始终以 Manifest V3 为目标。
- 最小权限——只申请所需权限,优先使用 activeTab 而非宽泛的 host permissions。
- 注意 service worker 特性——没有持久后台页,需针对短暂生命周期进行设计。
- 从一开始就考虑跨浏览器——使用 WebExtension API,必要时加 polyfill。
- 测试消息传递——消息传递 bug 是扩展问题的首要来源。
【限制】 该条目为代理/技能说明,未提供具体的收费、价格、版本号或部署平台等信息,这些内容暂未提供。