From 774d09a07ab7fd65d7d1b8d1583bd6b06b6e331b Mon Sep 17 00:00:00 2001 From: kicer Date: Mon, 26 Oct 2026 11:07:19 +0800 Subject: [PATCH] =?UTF-8?q?=E5=9B=BE=E7=89=87=E9=A2=84=E8=A7=88=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=E6=9C=8D=E5=8A=A1=E7=AB=AF=E6=B4=BE=E7=94=9F=20WebP?= =?UTF-8?q?=20=E7=9B=B4=E8=BF=9E=EF=BC=8C=E4=BF=AE=E5=A4=8D=E5=A4=A7?= =?UTF-8?q?=E5=9B=BE=E5=8A=A0=E8=BD=BD=E6=85=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 /files/preview:按宽度生成 WebP 并落盘缓存,inline + ETag,原图仅下载时取;前端图片与全屏查看器改用派生直链,不再 fetch 整包转 blob。 --- app/server/public/js/preview.js | 41 ++++++++++++++++--- app/server/routes/files.js | 71 ++++++++++++++++++++++++++++++++- 2 files changed, 106 insertions(+), 6 deletions(-) diff --git a/app/server/public/js/preview.js b/app/server/public/js/preview.js index 9a2947e..9fd6e9f 100644 --- a/app/server/public/js/preview.js +++ b/app/server/public/js/preview.js @@ -25,6 +25,12 @@ function pvOfficeUrl(rel) { String(rel).split('/').filter(Boolean).map(encodeURIComponent).join('/') + '/'; } +// 图片预览派生地址:服务端按 w 生成并缓存 WebP, 直连可边下边画;原图只留给“下载”。 +function pvPreviewUrl(rel, w) { + return '/api/sessions/' + encodeURIComponent(state.sessionId) + + '/files/preview?path=' + encodeURIComponent(rel) + '&w=' + w; +} + function pvKind(name) { const low = String(name).toLowerCase(); if (/\.html?$/i.test(low)) return 'html'; @@ -36,8 +42,8 @@ function pvKind(name) { } // 文件面板「当前目录」里的图片作为一组,供查看器左右滑动切换。 -// 同组直接用下载直链( 不受 Content-Disposition: attachment 影响),不必逐张取 blob。 -// 依赖 files.js 的 filesNodeAt / filesCurDir / assetDownloadUrl(同为全局,加载顺序在前)。 +// 同组直接用预览派生直链(2048px),不必逐张取原图/blob,滑动的预取也不会打满带宽。 +// 依赖 files.js 的 filesNodeAt / filesCurDir(同为全局,加载顺序在前)。 function pvImgGroup(name) { try { if (typeof filesNodeAt !== 'function') return null; @@ -46,7 +52,7 @@ function pvImgGroup(name) { const paths = node.files.map(f => f.filename).filter(p => PV_IMG.test(p)); if (paths.length < 2) return null; return { - list: paths.map(p => ({ src: assetDownloadUrl(p), alt: p.split('/').pop() })), + list: paths.map(p => ({ src: pvPreviewUrl(p, 2048), alt: p.split('/').pop() })), at: paths.indexOf(name), }; } catch (_) { return null; } @@ -54,8 +60,9 @@ function pvImgGroup(name) { // 刷新/新窗口两个钮对**所有**预览类型统一开放: // refresh → pvState.reload(各类型都注入「按同一路径重开」,与地址条回车同一条路) -// popup → pvState.url(office=预览网关;文本/HTML/图片/PDF=blob URL;不支持的类型=下载地址) -// 服务端文件响应一律是 attachment,直接导航只会触发下载,所以能用 blob 的一律走 blob。 +// popup → pvState.url(office=预览网关;图片=inline 预览直链;文本/HTML/PDF=blob URL; +// 不支持的类型=下载地址) +// 下载接口是 attachment,直接导航只会触发下载;图片走 /files/preview(inline)可直接开新窗口。 function pvToolbar(o) { document.getElementById('pv-refresh').classList.toggle('hidden', !o.refresh); document.getElementById('pv-popup').classList.toggle('hidden', !o.popup); @@ -223,6 +230,30 @@ async function openFilePreview(name, sizeText) { show(pvInfoNode(name, sizeText, hint), tbAll); return; } + // 图片走服务端派生预览: 直连边下边画,不再 fetch 整包转 blob;原图只在“下载”时取。 + // SVG 保留原路径(移动端还要展示源码),其余图片统一交给 /files/preview。 + if (kind === 'img' && !/\.svg$/i.test(name)) { + const alt = String(name).split('/').pop(); + const g = pvImgGroup(name); + if (desk) { + const im = document.createElement('img'); + im.className = 'pv-img'; im.alt = String(name); im.decoding = 'async'; + // 面板宽度约半屏,交给浏览器按 DPR 选 640/1280/2048,手机不会去拉大图 + im.sizes = '(min-width: 960px) 50vw, 100vw'; + im.srcset = [640, 1280, 2048].map(w => pvPreviewUrl(name, w) + ' ' + w + 'w').join(','); + const url = pvPreviewUrl(name, 2048); + im.src = url; + im.addEventListener('click', () => openImageViewer(url, alt, g && g.list, g && g.at)); + im.addEventListener('error', () => { + if (my !== pvSeq) return; + show(pvInfoNode(name, sizeText, '图片读取失败:文件可能已被删除,或格式无法解码。'), tbAll); + }); + show(im, Object.assign({}, tbAll, { url })); + } else { + openImageViewer(pvPreviewUrl(name, 2048), alt, g && g.list, g && g.at); + } + return; + } let r; try { r = await fetch('/api/sessions/' + state.sessionId + '/files/download?path=' + encodeURIComponent(name)); diff --git a/app/server/routes/files.js b/app/server/routes/files.js index 1c027f4..b88856c 100644 --- a/app/server/routes/files.js +++ b/app/server/routes/files.js @@ -1,5 +1,6 @@ -// 文件管理 API:上传 / 列表 / 下载 / 删除 +// 文件管理 API:上传 / 列表 / 下载 / 预览 / 删除 const express = require('express'); +const crypto = require('crypto'); const fs = require('fs'); const path = require('path'); const multer = require('multer'); @@ -146,6 +147,74 @@ router.get('/:id/files/download', serveDownload); // 供解析不了 Content-Disposition 的下载器兜底;path 参数与验签逻辑完全一致。 router.get('/:id/files/download-name/*', serveDownload); +// ---------- 图片预览派生图(inline,供 直连;与下载接口的 attachment/no-store 语义分开) ---------- +// 大图慢的三层原因:整包 fetch 完才渲染、每次都要重下、把原始像素丢给浏览器解码。 +// 这里按宽度用 sharp 生成 WebP 落盘缓存,前端 直连即可边下边画;原图只留给“下载”。 +const PREVIEW_IMG_RE = /\.(png|jpe?g|gif|webp|svg|bmp|avif|ico)$/i; +const PREVIEW_WIDTHS = new Set([320, 640, 960, 1280, 1600, 2048]); +let sharp = null; +try { sharp = require('sharp'); } catch (_) { /* 未安装 sharp 时整条路由降级为原图直出 */ } + +// 预览响应不能带 Content-Disposition: attachment;.imgcache 是点目录,sendFile 需显式放行。 +function sendInline(res, abs) { + res.setHeader('Cache-Control', 'private, max-age=0, must-revalidate'); + res.sendFile(abs, { cacheControl: false, dotfiles: 'allow', etag: true, lastModified: true }); +} + +router.get('/:id/files/preview', async function (req, res) { + try { + const rel = String(req.query.path || ''); + if (!rel) return res.status(400).json({ error: '缺少 path 参数' }); + if (!PREVIEW_IMG_RE.test(rel)) return res.status(400).json({ error: '不是图片' }); + const w = PREVIEW_WIDTHS.has(Number(req.query.w)) ? Number(req.query.w) : 1600; + const taskDir = engine.taskDirOf(req.params.id); + const abs = resolveInTask(taskDir, rel); + const st = fs.statSync(abs); + if (!st.isFile()) return res.status(400).json({ error: '不是文件' }); + + // SVG 是矢量;GIF 可能在预览里要保留动画;没有 sharp 时只能原图直出。 + if (/\.svg$/i.test(rel) || /\.gif$/i.test(rel) || !sharp) { + return sendInline(res, abs); + } + + // 缓存 key 带 size+mtime:文件被 AI 覆盖后自动失效,不需要额外的清理逻辑。 + const key = crypto.createHash('sha1') + .update(rel + '|' + st.size + '|' + st.mtimeMs + '|' + w) + .digest('hex'); + const outDir = path.join(path.resolve(taskDir), '.imgcache', 'preview'); + const out = path.join(outDir, key + '.webp'); + if (!fs.existsSync(out)) { + // sharp 默认只取动图首帧,直接给原图避免“预览不动了”。metadata 只读文件头,不解码像素。 + let meta = null; + try { meta = await sharp(abs).metadata(); } catch (_) { /* 交给下面原图兜底 */ } + if (meta && meta.pages && meta.pages > 1) return sendInline(res, abs); + + // 小文件不一定像素少(高压缩的大尺寸图仍解码很慢):体积与像素都小才直出原图, + // 避免“压缩后反而更大”,也避免把 24MP 的 200KB 图原样丢给低端机解码。 + const px = meta && meta.width && meta.height ? meta.width * meta.height : 0; + if (st.size <= 256 * 1024 && (!px || px <= 2 * 1000 * 1000)) return sendInline(res, abs); + + fs.mkdirSync(outDir, { recursive: true }); + // 随机临时名 + rename:并发请求不会读到半截文件,也不互相覆盖。 + const tmp = out + '.' + crypto.randomBytes(4).toString('hex') + '.tmp.webp'; + try { + await sharp(abs, { limitInputPixels: 80 * 1000 * 1000 }) + .rotate() + .resize({ width: w, height: w, fit: 'inside', withoutEnlargement: true }) + .webp({ quality: 85 }) + .toFile(tmp); + fs.renameSync(tmp, out); + } catch (err) { + try { fs.unlinkSync(tmp); } catch (_) {} + return sendInline(res, abs); // 解码失败/格式不支持 → 原图兜底 + } + } + sendInline(res, out); + } catch (err) { + res.status(404).json({ error: '文件不存在' }); + } +}); + // ---------- 打包下载(选中项含文件夹时,后端把整个选择打成 zip 流式返回) ---------- // 纯 Node 实现(STORE 不压缩 + 手拼 zip 结构):任务目录里多是媒体/生成产物, // 压缩收益低;两遍读文件(先算 CRC 再磁盘流发送),内存占用与总大小无关。