manifest.json 控制什么、Extension.js 会重写哪些入口。然后再决定哪些行为可以放心地自动化，哪些约束仍需要你自己处理。
按需开始
本节包含什么
- 单看 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 构建页面集成。
- 在 安全清单 中回顾运行时边界。