SuperAPI AI 工具集

browser-extension

编程与开发

查看项目

更新于 10-16 06:44

技能介绍

用途:这是一个用于构建现代浏览器扩展的专项技能,目标版本为2025/2026级扩展,全部基于Manifest V3,无例外。

主要能力与要点:

  1. Manifest V3架构:后台使用service_worker而非持久页面;禁止远程代码与unsafe-eval;权限遵循最小授权,尽量用optional_permissions;UI优先使用action;推荐用chrome.sidePanel提供常驻侧边栏,如chrome.sidePanel.setOptions({ path: 'sidepanel.html', enabled: true })。
  2. 持久化引擎(防终止):Service Worker不持久,空闲约30秒后终止。禁止依赖全局变量或内存状态,状态变更须立即写入chrome.storage或IndexedDB;瞬态会话数据用chrome.storage.session,大数据与用户持久数据用IndexedDB或chrome.storage.local;用chrome.alarms每1-5分钟唤醒做后台同步;必要时用offscreen API处理DOM解析、重计算或保持存活。
  3. 安全:内容脚本视为不可信环境,经chrome.runtime.sendMessage传给Service Worker的数据必须净化;优先用declarativeNetRequest做请求拦截与头部修改,仅在Firefox等需要动态规则时以webRequest作回退。
  4. 设计与UI:本技能不负责视觉设计,要求参照frontend-design技能(8点网格、玻璃拟态、原子化设计2.0、弹窗交互低于400ms)。
  5. 审计流程:构建须通过manifest-auditor.js(MV3合规与CSP安全、权限不过宽)、persistence-check.js(Service Worker心跳与状态完整性)、asset-master.js(图标尺寸与资源优化),并运行playwright测试确认路径通过。审计检查项包括:是否MV3合规、Service Worker能否优雅处理终止并保存状态、权限是否最小化、UI是否有frontend-design的叙事优先脚本支撑。

限制:资料未提供具体安装命令、依赖版本、定价、平台范围与实测效果,暂未提供。