五、经验总结（可带走的原则）
- 多套加载机制共存时先划 ownership（Webpack script / Observer / SW / SystemJS）；再写 retry，否则请求量按乘积涨。
- ESM 失败是可缓存状态：必须以 URL 变化策略显性打破，而不是仅靠「换一种 DOM API」。
- Vite 改动态 import 宁晚勿早：当前实现是
writeBundle后改写 +es-module-lexer+MagicString，保住__vitePreload/__vite__mapDeps/ 异步 CSS 拓扑；experimental.renderBuiltUrl/renderDynamicImport应明确当作早期、已否决的方案看待。 - Vite：
vite:preloadError必须preventDefault()，载荷读payload，否则 CSS 预加载失败会 throw，阻断后续__RF__.load()；当前页面实现只阻止这次 throw，不把 preload 事件直接记成一条旧 Resolver failure。 - Vite
base与 rulebase不一致时别开构建闸门：用shouldRewriteUrls（两侧ensureTrailingSlash后再比） 一刀切掉「误入 CDN URL 拼装」的工程事故。 - 不要用
cloneNode换新 script src；新建元素 + 属性白名单 + SRI 策略。 getAttribute(src)维系与配置前缀的一致性，避免/vs 绝对 URL 玄学。- CDN 前缀与文件名拼接用
joinAssetPrefix，避免prod+js/x.js→prodjs。 - Webpack：CSS chunk 除 Observer 外，须在 RuntimeModule 抑制 CSS 类 loader 的 reject，否则
import()仍失败；遍历__webpack_require__.f中非j，不限死miniCss键名。 - SystemJS 与 Observer必须登记 URL 互斥。
- SW legacy Resolver 才保留
isFallback→urls前缀命中的语义；页面侧当前由RecoveryCoordinator管理恢复，不应再把那套匹配顺序、重复 rulebase优先级或 per-rule circuit 当成公开页面语义。 - 页面侧
rf:error是终态信号，不是稳定 reason 字符串协议：要判断是否真正进入回退链，优先看rf:retry/rf:fallback；旧Resolver的no-match/rules-exhausted讨论应限制在历史或 SW 语境。 - SW 默认路径必须与 scope 对齐：默认
scope: '/'就输出/rf-sw.js，不要把Service-Worker-Allowed变成默认部署负担。 - SW 配置不要只靠页面
postMessage：早期图片/字体/CSS 子资源可能先于消息发生，构建期应把 manifest 预置进 SW 文件。 - opaque response 是策略问题，不是实现细节：默认保守不当失败；若要通过 CORS 探测处理可读的跨源 HTTP 错误，显式启用
fallbackOnOpaque，但 CORS 不可用时 opaque 仍会被接受。 - SW 本地调试必须看 origin：
localhost、127.0.0.1、局域网 IP 是不同 origin；局域网 IP 的 HTTP 不是 secure context，SW 不会注册。 - 验证视觉资源要验真实加载：图片看
naturalWidth，字体看document.fonts.check()，背景图结合 Network/SW 事件；toBeVisible()只能证明 DOM 存在。 - 规则只用 string rule
base：不再依赖 RegExp / 函数 match；SW preload 预置的是可 JSON 序列化的配置。 - SW 事件要按
clientId定向：同一个 SW 控制多个 tab 时，广播会污染观测和业务 hook。 - SW 的最终失败应返回
Response.error()：补发rf:error但不伪造内容响应，让资源语义仍像真实 network error。 - SW 内 circuit 不应共享页面
localStorage：SW 是跨客户端上下文，页面侧跨 tab 熔断状态不应反向污染 SW fetch 决策。 - 要全集拦截与任意资源：倾向 SW；要 Webpack+Vite+cross-browser 一致运行时语义：插件 +
__RF__+ Observer更合适。