图片外链改成 inline 后点开变成坏图:sw.js 的导航分支默认把同源导航当 HTML, resp.text() 把整张 PNG 解成替换字符再 new Response 回去,浏览器只看到空白; 它“残缺重试一次”的行为还让日志里每点一次出现两条 public-file 取用。 - 跳过名单补 /p/:公网短链是二进制 + 带 TTL 的 bearer 能力,不该接管也不该缓存 - 导航分支加硬约束:Content-Type 不是 text/html 就原样透传,不再按文本重建 - 该兜底不依赖路径枚举,其它同源二进制直链导航同样受保护 sw.js 不在预缓存清单里,无需升 CACHE_VERSION;刷新页面即可生效。
136 lines
6.1 KiB
JavaScript
136 lines
6.1 KiB
JavaScript
// Agent 任务台 Service Worker
|
||
// 策略:HTML 与代码资源(CSS/JS 等)网络优先(保证改动/登录态即时生效),失败回退缓存(离线兜底);
|
||
// 图片与 JSON(manifest/图标,内容稳定)缓存优先,命中本地缓存直接返回,省流量、弱网加载快。
|
||
// CACHE_VERSION 仅作缓存命名空间:改 CSS/JS 无需手动升级;改图片/JSON 才需要升它刷新旧缓存。
|
||
|
||
const CACHE_VERSION = 'agent-v2';
|
||
const STATIC_CACHE = `${CACHE_VERSION}-static`;
|
||
const RUNTIME_CACHE = `${CACHE_VERSION}-runtime`;
|
||
|
||
// PRECACHE_URLS: 仅预缓存图片与 JSON——这些是缓存优先的资源,安装时直接落盘秒开,离线也能用。
|
||
// HTML/CSS/JS 不预缓存:网络优先策略每次在线都会写入 RUNTIME_CACHE,
|
||
// STATIC_CACHE 的旧版反而会在 caches.match() 离线回退时遮蔽更新。
|
||
const PRECACHE_URLS = [
|
||
'/manifest.json',
|
||
'/icons/icon-192.png',
|
||
'/icons/icon-512.png',
|
||
'/icons/apple-touch-icon.png'
|
||
];
|
||
|
||
self.addEventListener('install', (event) => {
|
||
event.waitUntil(
|
||
caches.open(STATIC_CACHE).then((cache) =>
|
||
// addAll 任一失败会整体失败,逐个 add 更稳
|
||
Promise.all(
|
||
PRECACHE_URLS.map((url) =>
|
||
cache.add(url).catch((err) => console.warn('[SW] precache fail', url, err))
|
||
)
|
||
)
|
||
)
|
||
);
|
||
self.skipWaiting();
|
||
});
|
||
|
||
self.addEventListener('activate', (event) => {
|
||
event.waitUntil(
|
||
caches.keys().then((keys) =>
|
||
Promise.all(
|
||
keys.filter((k) => !k.startsWith(CACHE_VERSION)).map((k) => caches.delete(k))
|
||
)
|
||
)
|
||
);
|
||
self.clients.claim();
|
||
});
|
||
|
||
self.addEventListener('fetch', (event) => {
|
||
const { request } = event;
|
||
if (request.method !== 'GET') return;
|
||
|
||
const url = new URL(request.url);
|
||
// 只处理同源
|
||
if (url.origin !== self.location.origin) return;
|
||
|
||
// 跳过 API/SSE/预览/交付取件,避免缓存动态数据(预览页需实时;/f/ 同链内容会随重新 save 变化)。
|
||
// /p/ 是公网短链(图片/文件直链):内容是二进制、带 TTL 的 bearer 能力,既不能当 HTML 文本重建,
|
||
// 也不该进缓存。漏掉它时点开图片外链会先被“导航”分支 fetch 两次、再按文本重建,结果是一张坏图,
|
||
// 日志里表现为每点一次成对出现两条 public-file 取用记录。
|
||
if (url.pathname.startsWith('/api/') || url.pathname.startsWith('/sse') || url.pathname.startsWith('/preview')
|
||
|| url.pathname.startsWith('/f/') || url.pathname.startsWith('/p/')) return;
|
||
|
||
// vendor 预览页发出的根绝对请求(fetch('/') 自刷新、EventSource('/events') 等,Referer 是预览页):
|
||
// 内容随文档变化,既不缓存,也不能把 office 文档页写进 '/' 这类 SPA 缓存键。
|
||
if (request.referrer) {
|
||
try {
|
||
const rp = new URL(request.referrer).pathname;
|
||
if (rp === '/preview' || rp.startsWith('/preview/')) return;
|
||
} catch (_) {}
|
||
}
|
||
|
||
// HTML/登录页:网络优先
|
||
if (request.mode === 'navigate' || request.destination === 'document') {
|
||
// 静态站文件是绑定挂载、外部工具改动非原子:刷新时机撞上写入瞬间会拿到半截 HTML
|
||
// (脚本/样式缺一半 → 无样式裸首页假象)。读成文本校验收尾标签,残破则稍候重试一次;
|
||
// 两次都残破也照常返回,只有 ok 的快照才进缓存(残破页进缓存会被离线兜底永久化)。
|
||
event.respondWith((async () => {
|
||
let last = null;
|
||
for (let i = 0; i < 2; i++) {
|
||
try {
|
||
const resp = await fetch(request);
|
||
if (!resp.ok || resp.type !== 'basic') return resp;
|
||
// 非 HTML 的导航(图片/PDF 等直链):二进制不能按文本重建,原样透传;
|
||
// 否则 resp.text() 会把像素解成替换字符,页面只剩空白/乱码。
|
||
if (!/text\/html/i.test(resp.headers.get('content-type') || '')) return resp;
|
||
last = { txt: await resp.text(), resp };
|
||
} catch (e) {
|
||
if (last) break; // 已有残破快照:降级返回它
|
||
if (i === 1) throw e;
|
||
await new Promise((r) => setTimeout(r, 250));
|
||
continue;
|
||
}
|
||
if (/<\/html>\s*$/i.test(last.txt)) break;
|
||
if (i === 0) await new Promise((r) => setTimeout(r, 250));
|
||
}
|
||
const h = new Headers(last.resp.headers);
|
||
// 重建响应体后 Content-Length 已失真,连同二进制透传头一并剔除(也是 Response 构造禁设项)
|
||
['content-length', 'content-encoding', 'content-transfer-encoding'].forEach((k) => h.delete(k));
|
||
const out = new Response(last.txt, { status: last.resp.status, statusText: last.resp.statusText, headers: h });
|
||
const complete = /<\/html>\s*$/i.test(last.txt);
|
||
if (complete) caches.open(RUNTIME_CACHE).then((cache) => cache.put(request, out.clone()));
|
||
return out;
|
||
})().catch(() => caches.match(request).then((r) => r || caches.match('/'))));
|
||
return;
|
||
}
|
||
|
||
// 图片与 JSON(manifest/图标等,内容稳定):缓存优先,命中即直接返回省流量;
|
||
// 未命中走网络并写入缓存。这类资源改动后需升 CACHE_VERSION 刷新旧缓存。
|
||
if (/\.(png|jpe?g|gif|webp|svg|ico|avif|bmp)$/i.test(url.pathname) || /\.json$/i.test(url.pathname)) {
|
||
event.respondWith(
|
||
caches.match(request).then((cached) => {
|
||
if (cached) return cached;
|
||
return fetch(request).then((resp) => {
|
||
if (resp && resp.status === 200 && resp.type === 'basic') {
|
||
const copy = resp.clone();
|
||
caches.open(RUNTIME_CACHE).then((cache) => cache.put(request, copy));
|
||
}
|
||
return resp;
|
||
});
|
||
})
|
||
);
|
||
return;
|
||
}
|
||
|
||
// 其余静态资源:网络优先(改完即生效),失败回退缓存(离线/断网可用)
|
||
event.respondWith(
|
||
fetch(request).then((resp) => {
|
||
if (resp && resp.status === 200 && resp.type === 'basic') {
|
||
const copy = resp.clone();
|
||
caches.open(RUNTIME_CACHE).then((cache) => cache.put(request, copy));
|
||
}
|
||
return resp;
|
||
}).catch(() => caches.match(request))
|
||
);
|
||
});
|
||
|
||
self.addEventListener('message', (event) => {
|
||
if (event.data === 'SKIP_WAITING') self.skipWaiting();
|
||
}); |