1 files changed, 140 insertions, 0 deletions
diff --git a/sw.js b/sw.js
new file mode 100644
index 0000000..106a0f1
--- /dev/null
+++ b/sw.js
@@ -0,0 +1,140 @@
+/*
+ * Mayx的博客 · 离线模式 Service Worker
+ *
+ * 两种模式（由 Cache Storage 中是否存在就绪标记决定）：
+ * - 在线模式（默认，无标记）：所有请求原样转发网络，SW 形同虚设。
+ * - 离线模式（/offline.html 启用后写入标记）：同源 GET 请求缓存优先，
+ *   缓存未命中且清单里没有的路径才回源网络，实现断网阅读。
+ *
+ * 版本控制：压缩包 /MayxBlog.7z 的 content-length 即版本号（每次重新部署
+ * 都会变化）。SW 激活时、以及导航请求按 RECHECK_INTERVAL 节流复核；
+ * 一旦发现线上压缩包与已缓存版本不一致，立即清空缓存 → 自动回退在线模式。
+ * 网络不可用时复核失败，保留缓存（离线阅读本来就是离线模式的目的）。
+ */
+
+const CACHE_NAME = 'mayxblog-offline-v1';
+const READY_KEY = '/__offline_manifest__';
+const ARCHIVE_URL = '/MayxBlog.7z';
+const RECHECK_INTERVAL = 5 * 60 * 1000;
+
+let lastRecheck = 0;
+
+self.addEventListener('install', () => {
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys()
+      .then((keys) =>
+        Promise.all(keys.filter((k) => k !== CACHE_NAME).map((k) => caches.delete(k)))
+      )
+      .then(verifyPayloadVersion)
+      .then(() => self.clients.claim())
+  );
+});
+
+/*
+ * HEAD 请求不被下面的 fetch 处理器拦截，这里读到的一定是线上真实压缩包，
+ * 而不是缓存里的 quine 副本。网络失败返回 null，调用方选择信任现有缓存。
+ */
+async function payloadSize() {
+  try {
+    const response = await fetch(ARCHIVE_URL, { method: 'HEAD', cache: 'no-store' });
+    if (!response.ok) return null;
+    const size = Number(response.headers.get('content-length'));
+    return Number.isFinite(size) && size > 0 ? size : null;
+  } catch {
+    return null;
+  }
+}
+
+/*
+ * 就绪标记同时是清单：记录了解包写入的所有路径。没有它就无法区分
+ * “站点本来就没有这个页面”和“缓存条目被浏览器回收了”。
+ */
+async function readManifest(cache) {
+  const hit = await cache.match(READY_KEY);
+  if (!hit) return null;
+  const meta = await hit.json().catch(() => null);
+  if (!meta || !Array.isArray(meta.keys) || !meta.keys.length) return null;
+  return meta;
+}
+
+/* 压缩包更新 → 清空缓存（即回退在线模式）；返回是否发生了失效。 */
+async function verifyPayloadVersion() {
+  const cache = await caches.open(CACHE_NAME);
+  const meta = await readManifest(cache);
+  if (!meta) return false;
+  const size = await payloadSize();
+  if (size && meta.payloadSize !== size) {
+    await caches.delete(CACHE_NAME);
+    return true;
+  }
+  return false;
+}
+
+/* 服务器对目录索引的处理与 Jekyll 产物一致，这里补齐候选路径。 */
+function candidatesFor(pathname) {
+  const keys = [pathname];
+  if (pathname.endsWith('/')) {
+    keys.push(pathname + 'index.html');
+  } else {
+    keys.push(pathname + '/index.html');
+    keys.push(pathname + '.html');
+  }
+  return keys;
+}
+
+self.addEventListener('fetch', (event) => {
+  const request = event.request;
+  if (request.method !== 'GET') return; // HEAD 等直通网络（版本探测依赖这一点）
+
+  const url = new URL(request.url);
+  if (url.origin !== self.location.origin) return; // 跨域请求不干预
+
+  // 显式 no-store 的请求（重新下载压缩包等）绕过缓存，避免吃到旧的 quine 副本
+  if (request.cache === 'no-store') return;
+
+  event.respondWith(respond(request, url, event));
+});
+
+async function respond(request, url, event) {
+  const cache = await caches.open(CACHE_NAME);
+
+  // 导航请求顺带做节流版本复核；失效发生在后台，本次响应不受影响，
+  // 下一次请求自然落入在线模式。
+  if (request.mode === 'navigate' && Date.now() - lastRecheck > RECHECK_INTERVAL) {
+    lastRecheck = Date.now();
+    event.waitUntil(verifyPayloadVersion());
+  }
+
+  const candidates = candidatesFor(url.pathname);
+  for (const key of candidates) {
+    const hit = await cache.match(key);
+    if (hit) return hit;
+  }
+
+  const meta = await readManifest(cache);
+  if (!meta) return fetch(request); // 在线模式：纯转发
+
+  // 清单承诺过这个路径但缓存里没有 → 条目被浏览器回收，缓存已不可信，
+  // 整体作废并回退在线模式。
+  if (candidates.some((key) => meta.keys.includes(key))) {
+    await caches.delete(CACHE_NAME);
+    return fetch(request);
+  }
+
+  // 清单之外的路径回源网络；断网时的导航请求用站点 404 页兜底。
+  try {
+    return await fetch(request);
+  } catch (error) {
+    if (request.mode === 'navigate') {
+      const notFound = await cache.match('/404.html');
+      if (notFound) {
+        return new Response(notFound.body, { status: 404, headers: notFound.headers });
+      }
+    }
+    throw error;
+  }
+}