manifest.json 控制什么、Extension.js 会重写哪些入口。然后再决定哪些行为可以放心地自动化，哪些约束仍需要你自己处理。
按需开始
| 需求 | 先阅读这里 |
|---|---|
| 理解一份 manifest 如何变成各浏览器特定的产物 | manifest.json |
| 判断你的功能实际需要哪些权限 | 权限与主机权限 |
| 在 popup、content script 与 background 之间传数据 | 消息通信 |
| 持久化设置或缓存运行时数据 | 存储 |
| 构建与页面集成的功能 | Content script |
| 构建事件驱动的扩展级逻辑 | Background 脚本 / service worker |
| 安全地把打包资源暴露给页面 | Web-accessible 资源 |
| 保持输出路径可预测 | 可预测的路径解析 |
本节包含什么
- 单看 CLI 文档容易遗漏的编写契约。
- 由你的源码驱动、并会影响扩展加载与重载方式的运行时行为。
- 即使打包之后仍然存在的浏览器扩展架构问题，比如权限、消息通信、存储，以及 background、content script 和页面上下文之间的边界。
- 适用于手动开发或借助 AI 编码助手的实用指引。
重要的心智模型
Extension.js 会帮你处理编译、路径归一、manifest 重写以及开发体验。但它并不会消除浏览器扩展底层的边界：- Content script 仍然在受限的页面上下文中运行。
- 后台 service worker 仍然有生命周期限制。
- Web-accessible 资源仍然需要显式暴露。
- 权限仍然决定扩展可以做什么。
- 消息通信和存储仍然需要显式设计。
适合新功能的阅读顺序
- 先阅读 manifest.json，了解你声明的扩展表面。
- 阅读功能专属的页面，比如 content script 或 background。
- 补齐支撑性内容：权限、消息通信、存储 与 web-accessible 资源。
- 在 可预测的路径解析 中验证路径假设。
- 在活动监听模式下变更入口之前，先回顾 dev 更新行为。
下一步
- 从 manifest.json 开始。
- 用 Content script 构建页面集成。
- 在 安全清单 中回顾运行时边界。