Agent Skills
返回列表
💻

Chrome 扩展开发(Manifest V3)

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-chrome-extension。

技能介绍

要解决什么问题

Manifest V3 把后台页换成 Service Worker、砍掉 webRequest 阻塞能力、并收紧远程代码与权限规则。很多扩展在「SW 莫名被杀、异步消息没回应、内容脚本里 fetch 被 CSP 拦掉、商店审核因 host_permissions 拖几周」这些点上反复踩坑,而官方文档又分散在十几个主题里,缺少一份按「该在哪类上下文写代码」组织的工程视角。

技能如何组织与使用

本技能以 路由文档 为入口:先读总览里的架构规则与决策树,再按需打开对应参考文件,避免一次性吞下全部 API。

  • 执行上下文:扩展最多五种上下文,跨上下文交互一律走消息传递;对照 references/execution-contexts.md 弄清各上下文的权限、寿命与硬性限制。
  • Service Worker:默认约 30 秒无活动即终止;状态写入 chrome.storage,监听器必须在顶层同步注册,周期性任务用 chrome.alarms 而非长 setTimeout。
  • 内容脚本与网络:内容脚本受页面 CSP/CORS 约束;受限站点上请求 API 时,通过 SW 做 CSP bypass relay(见 references/network-csp.md)。
  • 消息层:chrome.runtime.sendMessage 覆盖大多数一问一答;异步 listener 必须 return true,否则是 MV3 里最常见的消息类 bug(详见 references/messaging-rpc.md)。
  • 权限与上架:宽泛 host_permissions 易触发人工审核;优先 activeTab + optional_permissions;改请求头/拦截用 declarativeNetRequest,不要用已移除阻塞能力的 webRequest。

从零搭建可按技能内工作流:最小权限 manifest.json → TypeScript/构建 → SW 顶层监听 → 内容脚本与 UI(popup/side panel)→ 接线消息 → 专门测 SW 终止 → 走 references/publishing.md 上架。

边界与注意点

技能聚焦 Chrome + Manifest V3 的工程实现与商店流程,不替代 Firefox/Safari 扩展模型。文中明确禁止 eval、远程脚本、在 SW 里用 localStorage,以及假设内容脚本在扩展更新后仍存活;动效 DOM 类能力需考虑 Offscreen document 等变通方案。

使用场景

  • MV2 扩展要改成 MV3,需把 webRequest 阻塞改成 declarativeNetRequest 并重写后台逻辑
  • 在银行/企业内网页的内容脚本里调自家 API,总被页面 CSP 拦截,需要设计经 SW 转发的请求链路
  • Popup 点按钮后 SW 有时已休眠,消息无响应,要按规范实现异步 listener 与状态持久化
  • 首次上架 CWS,manifest 里写了 `<all_urls>`,审核卡住,需要收缩为 activeTab 与可选权限方案

适合人员

  • 维护公司内部 Chrome 插件的工程师,要在不改变产品能力的前提下完成 MV3 合规改造
  • 写过前端但没做过扩展的开发者,需要用 TypeScript 搭构建并从 manifest 到消息层搭出可调试的骨架
  • 负责扩展上架与迭代的负责人,需要对照权限策略缩短审核周期并处理 content script 更新孤儿化
  • 在页面注入脚本做数据采集或 DOM 增强的扩展作者,需要分清 isolated world 与页面 JS 桥接三层通信