SuperAPI AI 工具集

wxt

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:本技能提供 WXT 浏览器扩展框架的开发模式参考,用于处理入口点发现、清单生成、浏览器目标、存储、内容脚本、后台 Service Worker 生命周期与构建产物等影响正确性的问题。

主要能力与约定:入口点位于 src/entrypoints 下,深度为零或一层;后台 Service Worker 使用 defineBackground,内容脚本使用 defineContentScript。由于 WXT 在构建时会在 Node 中导入入口点模块,浏览器 API 的运行时逻辑必须放在入口点 main 函数内部;后台 main 不要声明为 async,异步初始化应在其内部启动。跨浏览器 API 应使用浏览器标志与特性检测,而非仅依赖类型。

清单、存储与命令:在 wxt.config.ts 中显式声明 permissions 与 host_permissions;使用 @wxt-dev/storage 并采用带区域前缀的键,同时包含 storage 权限。主机权限应尽量收窄,仅在确实需要所有标签页 URL 或图标时才使用 <all_urls>。本地脚本为 WXT 命令:wxt prepare、wxt build、wxt zip,以及 -b firefox 等浏览器标志。在仓库根目录优先使用 Tab Manager 应用已有的 Bun 脚本,而非其他包管理器替代方案。

适用场景:Epicenter 中 apps/tab-manager 以侧边栏优先,当前没有 popup 和内容脚本,后台 Service Worker 极简,仅从扩展操作打开侧边栏。

限制:当上述细节影响正确性时,可针对 wxt-dev/wxt 提出窄范围问题,并对照本地 wxt.config.ts 与生成产物验证决定性细节。资料未提供收费、价格、平台支持范围等更多信息。