该技能面向使用 Manifest V3 构建 Chrome 扩展的开发场景,可作为开发与迁移扩展时的指导。用途包括:从零设计并构建扩展、将 Manifest V2 扩展迁移到 V3、实现 Service Worker、内容脚本、弹窗与选项页,以及调试跨上下文通信和调用扩展 API(storage、permissions、alarms、side panel)。不适用于 Safari App Extensions、未使用 WebExtensions API 的 Firefox 开发,以及不涉及扩展 API 的普通网页开发。
主要约定与能力:仅使用 Manifest V3,优先 Service Worker 而非背景页;明确区分 Service Worker、内容脚本和 UI 上下文;用 chrome.runtime.sendMessage 与 chrome.tabs.sendMessage 进行消息传递,并使用 responseCallback;权限遵循最小权限原则,尽量使用 optional_permissions;持久化数据用 chrome.storage.local 或 chrome.storage.sync,而非 localStorage;网络过滤与修改使用 declarativeNetRequest。
用法要点:manifest 需声明 manifest_version、action.default_popup、background.service_worker、content_scripts 及 permissions 等字段。示例策略中,背景脚本通过 chrome.runtime.onMessage.addListener 接收消息并返回 true 以保持异步响应通道。最佳实践包括用 chrome.runtime.onInstalled 做初始化、在 manifest 配置后使用现代 ES 模块、对内容脚本的外部输入先校验,避免 innerHTML 和 eval(),且不要阻塞 Service Worker 主线程。
限制与排错:背景 Service Worker 是临时的,计划任务应使用 chrome.alarms,避免 setTimeout 或 setInterval 被终止。输出不能替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应先请求澄清。