manifest.json 控制什麼，以及 Extension.js 會改寫哪些進入點。然後判斷哪些行為可以放心交給自動化處理，哪些限制依然存在。
依需求開始
| 需求 | 先讀這個 |
|---|---|
| 了解一份 manifest 如何變成各瀏覽器專屬輸出 | manifest.json |
| 決定你的功能實際需要哪些權限 | 權限與 host 權限 |
| 在 popup、content script 與 background 之間傳遞資料 | Messaging |
| 持久化設定或快取執行階段資料 | Storage |
| 打造整合頁面的行為 | Content script |
| 打造事件驅動的全域擴充功能邏輯 | Background script／service worker |
| 安全地對頁面公開打包資產 | Web-accessible resources |
| 維持可預測的輸出路徑 | 可預期的路徑解析 |
本章節涵蓋什麼
- 光看 CLI 文件容易遺漏的撰寫合約。
- 由你的原始碼驅動、會影響擴充功能載入與重新載入方式的執行階段行為。
- 即使在打包之後仍然重要的瀏覽器擴充功能架構議題，例如權限、messaging、storage，以及 background、content script 與頁面情境之間的隔離。
- 無論你是手動開發還是搭配 AI 編碼代理人，都實用的指引。
重要的心智模型
Extension.js 在編譯、路徑標準化、manifest 改寫與開發體驗上幫上忙。它不會消除底層的瀏覽器擴充功能邊界：- Content script 仍受頁面情境限制。
- Background service worker 仍有生命週期限制。
- Web-accessible resources 仍需要明確開放。
- 權限仍決定擴充功能能做什麼。
- Messaging 與 storage 仍需要明確設計。
為新功能設定的好閱讀順序
- 從 manifest.json 開始，了解你正在宣告的擴充功能介面。
- 閱讀對應功能頁面，例如 content script 或 background。
- 加入支援元素：權限、messaging、storage 與 web-accessible resources。
- 在可預期的路徑解析中驗證路徑假設。
- 在進入 watch mode 變更進入點之前，先閱讀 dev 更新行為。
後續步驟
- 從 manifest.json 開始。
- 用 Content script 打造頁面整合。
- 在安全檢查清單中檢視執行階段邊界。