fix(pwa): service worker 在 dev 环境自毁，修复缓存旧 bundle 导致的无限刷新

cache-first 的 sw.js 会把 dev server 的非哈希 JS 钉死在 CacheStorage，
dev server 重启后旧 bundle 请求已不存在的 hot-update.json，404 后
HMR 客户端整页 reload，陷入无限刷新且无法自愈。

- sw.js：localhost/127.0.0.1/::1 上自毁（清缓存 + 注销），CACHE_NAME 升至 v2
- register-pwa.js：dev 环境不注册并清理残留注册
- rspress.config.ts：head 内联清理脚本（内联不经过 SW 拦截，
  即使页面处于毫秒级 reload 循环也能在若干次内胜出打破循环）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0112yBeEEYT8tyywNbypwXkN

Author: sunnylqm

site/pages/public/register-pwa.js

@@ -3,6 +3,18 @@
     return;
   }
 
+  // Don't register the SW on dev origins (its cache-first strategy pins stale
+  // dev bundles); also clean up any previously installed registration.
+  var DEV_HOSTNAMES = ['localhost', '127.0.0.1', '::1', '[::1]'];
+  if (DEV_HOSTNAMES.indexOf(location.hostname) !== -1) {
+    navigator.serviceWorker.getRegistrations().then(function (registrations) {
+      registrations.forEach(function (registration) {
+        registration.unregister();
+      });
+    });
+    return;
+  }
+
   window.addEventListener('load', function () {
     navigator.serviceWorker.register('/sw.js').catch(function (error) {
       console.warn('PWA registration failed:', error);

site/pages/public/sw.js

@@ -1,68 +1,95 @@
-const CACHE_NAME = 'pushy-site-v1';
+const CACHE_NAME = 'pushy-site-v2';
 const PRECACHE_URLS = ['/', '/manifest.webmanifest', '/images/logo.svg'];
 
-self.addEventListener('install', (event) => {
-  event.waitUntil(
-    caches
-      .open(CACHE_NAME)
-      .then((cache) => cache.addAll(PRECACHE_URLS))
-      .then(() => self.skipWaiting()),
-  );
-});
+// Never cache on dev origins: the dev server's JS URLs are not content-hashed,
+// so a cache-first SW pins a stale bundle whose HMR hash no longer exists on
+// the server, causing an infinite 404 → reload loop. This branch self-destructs
+// (clears caches + unregisters) so previously poisoned browsers heal on the
+// next service-worker update check.
+const DEV_HOSTNAMES = ['localhost', '127.0.0.1', '::1', '[::1]'];
 
-self.addEventListener('activate', (event) => {
-  event.waitUntil(
-    caches
-      .keys()
-      .then((keys) =>
-        Promise.all(
-          keys
-            .filter((key) => key !== CACHE_NAME)
-            .map((key) => caches.delete(key)),
-        ),
-      )
-      .then(() => self.clients.claim()),
-  );
-});
+if (DEV_HOSTNAMES.includes(self.location.hostname)) {
+  self.addEventListener('install', () => self.skipWaiting());
+  self.addEventListener('activate', (event) => {
+    event.waitUntil(
+      caches
+        .keys()
+        .then((keys) => Promise.all(keys.map((key) => caches.delete(key))))
+        .then(() => self.registration.unregister())
+        .then(() => self.clients.matchAll({ type: 'window' }))
+        .then((clients) => {
+          for (const client of clients) {
+            client.navigate(client.url).catch(() => {});
+          }
+        }),
+    );
+  });
+} else {
+  self.addEventListener('install', (event) => {
+    event.waitUntil(
+      caches
+        .open(CACHE_NAME)
+        .then((cache) => cache.addAll(PRECACHE_URLS))
+        .then(() => self.skipWaiting()),
+    );
+  });
 
-self.addEventListener('fetch', (event) => {
-  const { request } = event;
+  self.addEventListener('activate', (event) => {
+    event.waitUntil(
+      caches
+        .keys()
+        .then((keys) =>
+          Promise.all(
+            keys
+              .filter((key) => key !== CACHE_NAME)
+              .map((key) => caches.delete(key)),
+          ),
+        )
+        .then(() => self.clients.claim()),
+    );
+  });
 
-  if (request.method !== 'GET') {
-    return;
-  }
+  self.addEventListener('fetch', (event) => {
+    const { request } = event;
 
-  const url = new URL(request.url);
-  if (url.origin !== self.location.origin) {
-    return;
-  }
+    if (request.method !== 'GET') {
+      return;
+    }
 
-  if (request.mode === 'navigate') {
-    event.respondWith(
-      fetch(request)
-        .then((response) => {
-          const copy = response.clone();
-          caches.open(CACHE_NAME).then((cache) => cache.put(request, copy));
-          return response;
-        })
-        .catch(() => caches.match(request).then((cached) => cached || caches.match('/'))),
-    );
-    return;
-  }
+    const url = new URL(request.url);
+    if (url.origin !== self.location.origin) {
+      return;
+    }
 
-  event.respondWith(
-    caches.match(request).then((cached) => {
-      if (cached) {
-        return cached;
-      }
+    if (request.mode === 'navigate') {
+      event.respondWith(
+        fetch(request)
+          .then((response) => {
+            const copy = response.clone();
+            caches.open(CACHE_NAME).then((cache) => cache.put(request, copy));
+            return response;
+          })
+          .catch(() =>
+            caches.match(request).then((cached) => cached || caches.match('/')),
+          ),
+      );
+      return;
+    }
 
-      return fetch(request).then((response) => {
-        if (response.ok) {
-          const copy = response.clone();
-          caches.open(CACHE_NAME).then((cache) => cache.put(request, copy));
+    event.respondWith(
+      caches.match(request).then((cached) => {
+        if (cached) {
+          return cached;
         }
-        return response;
-      });
-    }),
-  );
-});
+
+        return fetch(request).then((response) => {
+          if (response.ok) {
+            const copy = response.clone();
+            caches.open(CACHE_NAME).then((cache) => cache.put(request, copy));
+          }
+          return response;
+        });
+      }),
+    );
+  });
+}

site/rspress.config.ts

@@ -95,6 +95,15 @@ export default defineConfig({
             content: 'Pushy',
           },
         },
+        {
+          // Inline (not SW-interceptable) dev-only cleanup: unregister any
+          // previously installed service worker and drop its caches, so dev
+          // pages can never get stuck on a stale cached bundle.
+          tag: 'script',
+          append: false,
+          children:
+            "(function(){var h=location.hostname;if(h!=='localhost'&&h!=='127.0.0.1'&&h!=='::1'&&h!=='[::1]')return;if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then(function(rs){rs.forEach(function(r){r.unregister()})})}if('caches' in window){caches.keys().then(function(ks){ks.forEach(function(k){caches.delete(k)})})}})();",
+        },
         {
           tag: 'script',
           attrs: {