分层架构与构建链路
平台将业务声明、策略编译、构建输出和浏览器运行时分开。这样一套缓存安全基线可以服务不同框架，业务应用不需要持有 Service Worker 实现。
text
业务应用（界面和业务逻辑）
│ PwaIdentity + PwaInstallMetadata + PwaPolicy
▼
宿主绑定（Vue / React）── 页面侧生命周期
│
├── 构建适配器（Vite）
│ ├── contracts：类型、schema、诊断
│ ├── core：编译 PwaPlan
│ └── build-verifier：核对最终产物
│
└── 运行时
├── client-runtime：注册、安装、更新、登出
└── sw-runtime：请求判断、离线与恢复
└── engine-workbox：缓存执行细节从声明到产物
- 应用提供身份、安装信息、策略和宿主构建产物。
contracts校验输入；core合并平台基线并生成可审计的PwaPlan。- Vite 适配器根据计划生成 manifest、平台 worker、恢复 worker、离线页和预缓存清单，并向页面交付
virtual:pwa-config。 - 构建末尾的校验器核对声明的资源与实际产物；上线后仍要额外核查响应头、保留期和浏览器证据。
依赖只向下流动。契约层不知道 Vue、React 或浏览器；worker 不引入框架及应用服务端代码。Workbox 是内部引擎，业务应用通过 PwaPolicy 声明意图，而不是配置 Workbox。
公开入口与内部实现
业务项目通常直接用 @pwa-platform/vite 和一个框架绑定。内部包虽然随公开包分发为传递依赖，却不是业务配置入口。完整选择见包与公开入口。
关键设计理由
- 身份与策略分开：身份决定浏览器和 URL 所有权，策略允许业务逐次发布调整缓存意图。
- 编译计划而非直接执行策略：构建和运行时消费同一份规则结果，便于检查和审计。
- 默认拒绝缓存：新增或未分类请求不会因为一条宽泛允许规则而悄悄进入缓存。
- 等待确认更新：避免旧页面仍运行时新 worker 自动接管，减少混合版本风险。