SuperAPI AI 工具集

chrome-extensions

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:用于创建、修改、调试和理解 Chrome 扩展,按 Manifest V3 规范构建可发布到 Chrome 应用商店的扩展。

主要能力:该资料以“强制规则”形式列出扩展开发中最常见的失败点及正确做法,便于在编码时避免踩坑。涉及内容包括:图标引用必须指向真实存在的独立尺寸文件或完全省略;侧边栏需显式提供打开方式(如 chrome.action.onClicked + chrome.sidePanel.open,注意 openPanelOnActionClick 拼写);代码执行只能借助沙箱 iframe(sandbox 页面 + postMessage、Blob URL 或 srcdoc);读取 tab.url 需要 tabs 权限;统一使用 async/await;内容脚本批量操作 DOM 时用 requestAnimationFrame 分批并让出主线程;Service Worker 生命周期短,状态须存入 chrome.storage,定时用 chrome.alarms;chrome.identity 的扩展 ID 在开发与生产环境不同,可用 manifest 的 key 字段稳定 ID;上下文菜单操作后要给用户反馈;LanguageModel 提示 API 可在 Service Worker、弹窗和侧边栏使用;chrome.action 需要 manifest 中有 action 键;activeTab 仅在直接用户手势下生效,侧边栏内按钮无效;DevTools 面板路径相对扩展根目录;offscreen 文档仅能访问有限的 chrome API,需与服务端 Worker 通过消息分工;通知与角标图标必须是真实图片文件或运行时生成的 data URL;标签页捕获用状态锁避免重复启动;desktopCapture 需传目标标签页并具备 tabs 权限;userScripts 有四类易错点;chrome.windows 没有 query 方法;权限请求必须在消息监听器首行、await 之前调用。文档同时强调始终使用 Manifest V3,如用 background.service_worker 而非 background.scripts、chrome.action 而非 chrome.browserAction、host_permissions 与 permissions 分离、禁止内联脚本和事件处理器。

使用方式与适用场景:适合在编写或审查扩展代码时作为规则清单参照,也用于排查运行时错误。资料还包含发布部分的开头,具体发布步骤暂未提供。

限制:本文档为该技能页面公开文本的整理,未包含版本兼容时间表、收费或平台差异等额外事实;引用到的 reference 文件(如 icons.md、permissions.md、side-panel.md、csp-sandbox.md 等)内容未在资料中给出。