用途:在编写新的 Chrome 扩展代码、从 Manifest V2 迁移到 V3、优化 Service Worker 生命周期与状态管理、实现内容脚本、排查扩展性能问题时参考使用。
主要能力:提供 8 大类按影响优先级排序的规则。1)Service Worker 生命周期(关键,sw-):用 chrome.storage 持久化状态、避免人为保活、用 chrome.alarms 替代定时器、异步消息返回 true、顶层注册监听器、用 offscreen 文档访问 DOM。2)内容脚本优化(关键,content-):使用具体 URL 匹配、document_idle 注入、优先程序化注入、控制脚本体积、批量 DOM 操作、用 MutationObserver 替代轮询。3)消息传递(高,msg-):频繁通信使用 port、精简负载、高频事件去抖、检查 runtime.lastError、避免向所有标签页广播。4)存储操作(高,storage-):批量读写、选对存储类型、缓存常用值、临时数据用 storage.session、避免存储大二进制块。5)网络与权限(中高,net-):用 declarativeNetRequest 替代 webRequest、最小权限、优先 activeTab、避免修改 CSP。6)内存管理(中,mem-):清理监听器、避免游离 DOM 引用与闭包泄漏、清理定时器、使用 WeakMap/WeakSet。7)UI 性能(中,ui-):精简弹窗体积、先渲染缓存数据、批量更新角标、选项页懒加载。8)API 用法(中低,api-):优先 Promise、精确查询标签页、避免循环内冗余调用、遵守 alarms 最小周期、处理上下文失效、使用 declarativeContent。
使用方式:按需阅读各参考文件;完整规则汇编见 AGENTS.md,分类定义见 references/_sections.md,新规则模板见 assets/templates/_template.md,版本信息见 metadata.json。
限制:资料未提供安装命令、具体代码示例细节、价格或平台支持范围等信息。