Files
kicer ae8ed6bb25 Service Worker 放行 /p/ 二进制直链:图片外链不再被当 HTML 文本重建
图片外链改成 inline 后点开变成坏图:sw.js 的导航分支默认把同源导航当 HTML,
resp.text() 把整张 PNG 解成替换字符再 new Response 回去,浏览器只看到空白;
它“残缺重试一次”的行为还让日志里每点一次出现两条 public-file 取用。

- 跳过名单补 /p/:公网短链是二进制 + 带 TTL 的 bearer 能力,不该接管也不该缓存
- 导航分支加硬约束:Content-Type 不是 text/html 就原样透传,不再按文本重建
- 该兜底不依赖路径枚举,其它同源二进制直链导航同样受保护

sw.js 不在预缓存清单里,无需升 CACHE_VERSION;刷新页面即可生效。
2026-11-11 07:59:32 +08:00

136 lines
6.1 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 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();
});