// 通用文档预览窗(桌面分栏 #pv-pane:文件树 | 预览 | 会话 / 移动端全屏 #fs-viewer) // —— 文件列表的点击一律进预览窗:office 走 /preview 预览网关(固定格式前端自拼); // md/txt/代码/json/csv 等文本渲染;html/pdf/图片专用渲染;其余类型显示文件信息占位 + 下载。 // 桌面端紧贴左栏文件树右侧:点文件后内容就在旁边,不用横跨整个会话区看。 // 右边界可拖拽调宽(记忆在 localStorage)。 // 依赖(core.js/chat.js/stream.js/files.js 顶层声明):state $ esc toast mdHtml decorateCodePre // rewriteHtmlDocSrcs rewriteMdImageSrcs openFullscreen setFsSource closeFullscreen // openImageViewer downloadFile openDrawer 'use strict'; const PV_OFFICE = /\.(docx|xlsx|pptx)$/i; const PV_IMG = /\.(png|jpe?g|gif|webp|svg|bmp|avif|ico)$/i; const PV_MD = /\.(md|markdown)$/i; const PV_PLAIN = /\.(txt|log)$/i; // 常见代码/配置/数据文本扩展名;无扩展名的文件(Dockerfile/LICENSE 等)也按文本尝试,二进制嗅探兜底 const PV_TEXT = /\.(md|markdown|txt|log|csv|tsv|json|jsonl|xml|yml|yaml|toml|ini|conf|cfg|properties|env|py|pyw|js|mjs|cjs|ts|tsx|jsx|java|kt|c|h|cpp|hpp|cc|cs|go|rs|rb|php|swift|sh|bash|zsh|bat|ps1|sql|lua|r|dart|vue|css|less|scss|srt|vtt)$/i; const PV_TEXT_MAX = 512 * 1024; // 文本预览截断阈值(字符),超出提示下载看全文 const PV_SRC_MAX = 2 * 1024 * 1024; // 源码面板的显示上限,超过就只给前 2MB(大文件塞 pre 会卡) let pvSeq = 0; // 预览序号:快速连点时旧请求不许再动 DOM // reload: 当前内容的"重新载入"动作(文本类无 iframe,按名重开);为 null 时回退到 reload iframe const pvState = { name: null, url: null, blobUrl: null, reload: null, mobilePush: false, source: null, srcOn: false, bodyNode: null, srcPre: null }; function pvDesktop() { return window.matchMedia('(min-width: 960px)').matches; } function pvOfficeUrl(rel) { return '/preview/' + encodeURIComponent(state.sessionId) + '/' + 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; } // PDF 预览直连:让内建查看器自己发 Range 请求,不必先 fetch 整包转 blob。 function pvPdfUrl(rel) { return '/api/sessions/' + encodeURIComponent(state.sessionId) + '/files/inline?path=' + encodeURIComponent(rel); } function pvKind(name) { const low = String(name).toLowerCase(); if (/\.html?$/i.test(low)) return 'html'; if (/\.pdf$/i.test(low)) return 'pdf'; if (PV_IMG.test(low)) return 'img'; const base = String(name).split('/').pop(); if (PV_TEXT.test(base) || !/\.[a-z0-9]{1,8}$/i.test(base)) return 'text'; return 'none'; } // 文件面板「当前目录」里的图片作为一组,供查看器左右滑动切换。 // 同组直接用预览派生直链(2048px),不必逐张取原图/blob,滑动的预取也不会打满带宽。 // 依赖 files.js 的 filesNodeAt / filesCurDir(同为全局,加载顺序在前)。 function pvImgGroup(name) { try { if (typeof filesNodeAt !== 'function') return null; const node = filesNodeAt(typeof filesCurDir === 'string' ? filesCurDir : ''); if (!node) return null; 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: pvPreviewUrl(p, 2048), alt: p.split('/').pop() })), at: paths.indexOf(name), }; } catch (_) { return null; } } // 刷新/新窗口两个钮对**所有**预览类型统一开放: // refresh → pvState.reload(各类型都注入「按同一路径重开」,与地址条回车同一条路) // popup → pvState.url(office=预览网关;图片/PDF=inline 直链; // 文本/HTML=blob URL;不支持的类型=下载地址) // 下载接口是 attachment,直接导航只会触发下载;图片/PDF 走各自的 inline 路由可直接开新窗口。 function pvToolbar(o) { document.getElementById('pv-refresh').classList.toggle('hidden', !o.refresh); document.getElementById('pv-popup').classList.toggle('hidden', !o.popup); pvState.reload = typeof o.reload === 'function' ? o.reload : null; pvState.url = o.url === undefined ? null : o.url; // 源码钮:o.source 是原文(已渲染过的内容才有),没传就藏起来并回到预览态 pvState.source = o.source == null || o.source === '' ? null : String(o.source); pvState.srcOn = false; pvState.srcPre = null; const sb = document.getElementById('pv-src'); sb.classList.toggle('hidden', pvState.source == null); sb.classList.remove('active'); sb.title = '查看源码'; sb.setAttribute('aria-label', '查看源码'); } // 预览 ↔ 源码互切:不重建预览节点,只把它 display:none 再挂一个等宽 pre,来回切代价很低 function pvToggleSrc() { const btn = document.getElementById('pv-src'); if (!btn || pvState.source == null || !pvState.bodyNode) return; pvState.srcOn = !pvState.srcOn; if (pvState.srcOn) { let text = pvState.source; if (text.length > PV_SRC_MAX) text = text.slice(0, PV_SRC_MAX) + '\n\n…(源码较大,仅显示前 ' + Math.round(PV_SRC_MAX / 1024) + ' KB)'; const pre = document.createElement('pre'); pre.className = 'pv-pre pv-src-pre'; // 代码类预览本身也是 .pv-pre,多一个类便于区分/定位 pre.textContent = text; // 不用 innerHTML:源码里的标签必须当文本 pvState.srcPre = pre; document.getElementById('pv-body').appendChild(pre); pvState.bodyNode.style.display = 'none'; } else { if (pvState.srcPre && pvState.srcPre.parentNode) pvState.srcPre.parentNode.removeChild(pvState.srcPre); pvState.srcPre = null; pvState.bodyNode.style.display = ''; } btn.classList.toggle('active', pvState.srcOn); const lbl = pvState.srcOn ? '返回预览' : '查看源码'; btn.title = lbl; btn.setAttribute('aria-label', lbl); } // 每次展示内容都过一遍:标题显示相对路径(子目录可见),右上角下载钮随文件走 function pvHeader(name, sizeText) { pvState.name = name; const t = document.getElementById('pv-title'); t.value = String(name || ''); t.title = sizeText ? name + ' · ' + sizeText : String(name || ''); document.getElementById('pv-download').classList.toggle('hidden', !name); } function pvClearBody() { document.getElementById('pv-body').innerHTML = ''; pvState.reload = null; // 换内容/关窗后旧的刷新动作立即失效 pvState.url = null; // 新窗口地址同理:不清会残留上一份内容的 blob/网关 URL pvState.source = null; // 源码同样跟内容走,不然会把上一个文件的原文留在按钮里 pvState.srcOn = false; pvState.bodyNode = null; pvState.srcPre = null; document.getElementById('pv-src').classList.add('hidden'); if (pvState.blobUrl) { try { URL.revokeObjectURL(pvState.blobUrl); } catch (_) {} pvState.blobUrl = null; } } function pvLoadingBox() { const d = document.createElement('div'); d.className = 'pv-loading'; return d; } // 占位信息卡:不支持/读不到/缺失 共用。带文件名、大小与下载按钮(点击一律走这里,不再直接下载) function pvInfoNode(name, sizeText, hint) { const box = document.createElement('div'); box.className = 'pv-none'; box.innerHTML = '' + '' + '
'; box.querySelector('.nm').textContent = String(name || ''); box.querySelector('.meta').textContent = sizeText ? sizeText : ''; box.querySelector('.hint').textContent = String(hint || ''); const btn = document.createElement('button'); btn.textContent = '下载文件'; btn.addEventListener('click', () => { if (typeof downloadFile === 'function') downloadFile(name); }); box.appendChild(btn); return box; } function pvOpenPane() { // 不自动折叠左侧栏:左栏是文件树,打开预览时保持可见(文件树 | 预览 | 会话)。 if (!document.body.classList.contains('pv-open')) { document.body.classList.add('pv-open'); } // 开预览就把侧栏切到文件树:预览就贴在它旁边,切了才能顺手换文件看。 // 已经在文件页时 setDrawerPane 内部会因「没变化」而直接返回,不会重复拉树。 if (typeof setDrawerPane === 'function') setDrawerPane(true); } function pvCloseDoc() { if (!document.body.classList.contains('pv-open')) return; document.body.classList.remove('pv-open', 'pv-max'); if (typeof vcsSetMode === 'function') vcsSetMode(false); // 关面板即离开 Git 模式 if (typeof pvSetMaxUI === 'function') pvSetMaxUI(false); // 收起时复位放大钮图标(函数声明提升,定义在后亦可) pvClearBody(); pvState.name = null; pvState.url = null; } // 侧栏底部没有「预览」按钮:桌面端的预览只有一条入口——在文件树里点文件(点即开窗), // 关窗走预览栏自己的关闭钮 / Esc / 缩到窄屏。所以这里不再维护任何按钮高亮状态。 // 移动端全屏承载:把节点塞进 #fs-viewer 并展开 // opts.bar → 文件预览沉浸模式:顶部独立操作条,内容全宽占满剩余空间 // opts.name → 操作条左侧的文件名(仅 bar 模式可见) // opts.source → 源文本,交给 eye / 复制钮(未传则两者隐藏) function pvOverlayShow(node, opts) { opts = opts || {}; const viewer = document.getElementById('fs-viewer'); const body = document.getElementById('fs-body'); viewer.classList.toggle('fs-bar', !!opts.bar); const nm = document.getElementById('fs-file-name'); nm.textContent = opts.name ? String(opts.name) : ''; nm.title = nm.textContent; body.innerHTML = ''; body.style.zoom = ''; if (typeof setFsSource === 'function') setFsSource(opts.source == null ? null : opts.source); body.appendChild(node); viewer.classList.remove('hidden'); } // ---------- office:iframe 直挂预览网关(HEAD 预探顺便触发冷槽复活) ---------- async function pvOpenOffice(name, sizeText) { const url = pvOfficeUrl(name); const desk = pvDesktop(); const my = ++pvSeq; let load; if (desk) { pvOpenPane(); pvClearBody(); pvHeader(name, sizeText); pvToolbar({ refresh: true, popup: true, reload: () => openFilePreview(name, sizeText), url }); load = pvLoadingBox(); document.getElementById('pv-body').appendChild(load); // 开窗即刻可见,冷启动转圈等首帧 } else { load = pvLoadingBox(); load.classList.add('inline'); pvOverlayShow(load, { bar: true, name: name }); if (!pvState.mobilePush) { try { history.pushState({ pvOffice: 1 }, ''); pvState.mobilePush = true; } catch (_) {} } } let head = null; try { head = await fetch(url, { method: 'HEAD' }); } catch (_) {} if (my !== pvSeq) return; // 404 = 预览服务里没有这份文档。文件可能正被 AI 的写盘链路整体替换(rename 瞬间找不到), // 探针给一次短重试再落占位卡——比让用户自己反复点刷新更接近「多刷几次就出来了」的实情。 if (head && head.status === 404) { await new Promise((r) => setTimeout(r, 600)); if (my !== pvSeq) return; try { head = await fetch(url, { method: 'HEAD' }); } catch (_) {} if (my !== pvSeq) return; } const missing = head && head.status === 404; if (missing) { const node = pvInfoNode(name, sizeText, '预览服务中暂无这份文档 —— 文件可能已被删除、改名,或不在本任务目录下。'); if (desk) { // pvClearBody 会清掉 reload/url:占位卡仍要保留刷新/新窗口,否则按钮可见但点了没反应 pvClearBody(); document.getElementById('pv-body').appendChild(node); const dl = '/api/sessions/' + encodeURIComponent(state.sessionId) + '/files/download?path=' + encodeURIComponent(name); pvToolbar({ refresh: true, popup: true, reload: () => openFilePreview(name, sizeText), url: dl }); } else { const b = document.getElementById('fs-body'); b.innerHTML = ''; b.appendChild(node); } return; } const fr = document.createElement('iframe'); fr.className = desk ? 'pv-frame' : 'fs-html-frame'; fr.title = String(name); fr.src = url; if (desk) { try { load.remove(); } catch (_) {} document.getElementById('pv-body').appendChild(fr); pvToolbar({ refresh: true, popup: true, reload: () => openFilePreview(name, sizeText), url }); } else { const b = document.getElementById('fs-body'); b.innerHTML = ''; b.appendChild(fr); } pvState.url = url; } // ---------- 站内地址预览:会话流里的链接 / 地址条回车 → 直接挂进预览窗 ---------- // 「本机」判定:完全同源,或两端都是本机别名(localhost/127.0.0.1/[::1]/0.0.0.0,端口不究)。 // 外链、锚点、mailto、相对路径都不算,调用方自行放行。 function pvLocalHost(h) { return h === 'localhost' || h === '127.0.0.1' || h === '::1' || h === '[::1]' || h === '0.0.0.0'; } function pvSameHost(target) { let u; try { u = new URL(target, location.href); } catch (_) { return null; } if (u.origin === location.origin) return u; if (pvLocalHost(u.hostname) && pvLocalHost(location.hostname)) return u; return null; } function pvUrlTitle(url) { try { const u = new URL(url, location.href); return decodeURIComponent(u.pathname.split('/').filter(Boolean).pop() || '') || u.host; } catch (_) { return String(url); } } // iframe 直挂,不走文件读取链路:桌面进右侧分栏,窄屏进全屏浮层。 // sandbox 与现有 HTML 预览一致——data-page 页面要靠脚本渲染表格。 function pvOpenUrl(url, title) { const desk = pvDesktop(); const name = title || pvUrlTitle(url); ++pvSeq; // 在途的文件预览请求就此作废,别回来抢 DOM const mkFrame = () => { const fr = document.createElement('iframe'); fr.className = desk ? 'pv-frame' : 'fs-html-frame'; fr.title = name; fr.setAttribute('sandbox', 'allow-same-origin allow-scripts'); fr.src = url; return fr; }; if (desk) { pvOpenPane(); pvClearBody(); pvHeader(name, ''); pvState.name = null; // 不是文件:下载钮收起(按名下载会拼错路径) document.getElementById('pv-download').classList.add('hidden'); pvToolbar({ refresh: true, popup: true, reload: () => pvOpenUrl(url, title), url }); const t = document.getElementById('pv-title'); // 地址条显示完整地址,可选中复制 t.value = url; t.title = url; document.getElementById('pv-body').appendChild(mkFrame()); } else { pvOverlayShow(mkFrame(), { bar: true, name }); if (!pvState.mobilePush) { try { history.pushState({ pvOffice: 1 }, ''); pvState.mobilePush = true; } catch (_) {} } } } // ---------- 统一入口:所有文件点击都走这 ---------- async function openFilePreview(name, sizeText) { if (!state.sessionId) return; if (typeof vcsSetMode === 'function') vcsSetMode(false); // 点文件即离开 Git 面板(预览/Git 二选一) if (PV_OFFICE.test(name)) { try { await pvOpenOffice(name, sizeText); } catch (e) { toast('预览失败:' + e.message); } return; } let kind = pvKind(name); if (kind === 'pdf' && !navigator.pdfViewerEnabled) kind = 'none'; // WebView 内嵌不了 PDF:给占位卡,不再自动下载 const desk = pvDesktop(); const my = ++pvSeq; // 工具栏两动作全局统一:刷新 = 按同一路径重开(与地址条回车同一条路), // 新窗口 = 打开当前内容;没有可打开的 URL 时(不支持预览/读失败)退回下载地址。 const reload = () => openFilePreview(name, sizeText); const downloadUrl = '/api/sessions/' + encodeURIComponent(state.sessionId) + '/files/download?path=' + encodeURIComponent(name); const tbAll = { refresh: true, popup: true, reload, url: downloadUrl }; if (desk) { pvOpenPane(); pvClearBody(); // 立即开窗 + 转圈,点击零延迟可见 pvHeader(name, sizeText); pvToolbar(tbAll); document.getElementById('pv-body').appendChild(pvLoadingBox()); } const show = (node, tb) => { if (my !== pvSeq) return; // 节点上挂了 __src(原文)就带进工具条:预览栏据此显示源码钮。手机端的源码钮走 fs-viewer,不掺和。 if (node && node.__src != null) { tb = Object.assign({}, tb || tbAll, { source: node.__src }); delete node.__src; } if (desk) { pvClearBody(); pvHeader(name, sizeText); document.getElementById('pv-body').appendChild(node); pvState.bodyNode = node; pvToolbar(tb || tbAll); } else pvOverlayShow(node, { bar: true, name: name }); }; if (kind === 'none') { const low = String(name).toLowerCase(); const hint = /\.pdf$/i.test(low) ? '当前浏览器不支持页内预览 PDF,请下载后用系统查看器打开。' : '该格式暂不支持在线预览,可下载后本地打开。'; 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; } // PDF 直连 inline 路由:桌面面板与窄窗口(全屏 overlay)都让内建查看器按 Range 取字节, // 不再 fetch 整包转 blob。show() 会按 desk 自动落到右侧面板或 #fs-viewer。 if (kind === 'pdf') { const url = pvPdfUrl(name); const fr = document.createElement('iframe'); fr.className = desk ? 'pv-frame' : 'fs-html-frame'; fr.title = String(name); fr.src = url; show(fr, Object.assign({}, tbAll, { url })); return; } let r; try { r = await fetch('/api/sessions/' + state.sessionId + '/files/download?path=' + encodeURIComponent(name)); if (r.status === 401) { if (my === pvSeq) location.href = '/login?next=' + encodeURIComponent(location.pathname + location.search); return; } if (!r.ok) { let msg = 'HTTP ' + r.status; try { msg = (await r.json()).error || msg; } catch (_) {} throw new Error(msg); } } catch (e) { if (my === pvSeq) { desk ? show(pvInfoNode(name, sizeText, '读取失败:' + e.message), tbAll) : (pvCloseOverlayQuiet(), toast('预览失败:' + e.message)); } return; } try { if (!desk) { await pvRenderLegacy(name, r, my); return; } let node = null, tb = tbAll; // blob URL 不能在此登记到 pvState:show() 内部先调 pvClearBody(),那会把"刚建的"这个也一并撤销, // 于是 img/iframe 真正去取时 URL 已失效(Chrome 报 net::ERR_FILE_NOT_FOUND;Safari 撤回更宽松才没暴露)。 // 统一等 show() 之后登记,陈旧序号则立即撤销防泄漏。 let newBlobUrl = null; if (kind === 'html') { const raw = await r.text(); // 原文留着做源码面板,改写只用于内嵌显示 const src = rewriteHtmlDocSrcs(raw, name); // 相对资源改写,否则 about:srcdoc/blob 基准下全 404 const fr = document.createElement('iframe'); fr.className = 'pv-frame'; fr.setAttribute('sandbox', 'allow-same-origin allow-scripts'); fr.srcdoc = src; fr.__src = raw; newBlobUrl = URL.createObjectURL(new Blob([src], { type: 'text/html;charset=utf-8' })); tb = Object.assign({}, tbAll, { url: newBlobUrl }); // 新窗口=改写后的页面(与面板里同一份) node = fr; } else if (kind === 'pdf') { const u = URL.createObjectURL(await r.blob()); newBlobUrl = u; const fr = document.createElement('iframe'); fr.className = 'pv-frame'; fr.title = String(name); fr.src = u; // 不加 sandbox:内建查看器插件需要 unrestricted 帧 node = fr; tb = Object.assign({}, tbAll, { url: u }); } else if (kind === 'img') { // r 只能读一次:svg 先取文本再自己包 blob(也顺便拿到源码面板要的原文) const isSvg = /\.svg$/i.test(name); const svgText = isSvg ? await r.text() : null; const u = URL.createObjectURL(isSvg ? new Blob([svgText], { type: 'image/svg+xml;charset=utf-8' }) : await r.blob()); newBlobUrl = u; const im = document.createElement('img'); im.className = 'pv-img'; im.src = u; im.alt = String(name); if (isSvg) im.__src = svgText; const g = pvImgGroup(name); im.addEventListener('click', () => openImageViewer(u, String(name).split('/').pop(), g && g.list, g && g.at)); node = im; tb = Object.assign({}, tbAll, { url: u }); } else { // text/md/代码/json/csv node = await pvTextNode(name, sizeText, r); if (node.__tb) { tb = Object.assign({}, tbAll, node.__tb); delete node.__tb; if (/^blob:/.test(tb.url || '')) newBlobUrl = tb.url; } } show(node, tb); if (newBlobUrl) { if (my === pvSeq) pvState.blobUrl = pvState.url = newBlobUrl; else { try { URL.revokeObjectURL(newBlobUrl); } catch (_) {} } } } catch (e) { if (my === pvSeq) desk ? show(pvInfoNode(name, sizeText, '预览失败:' + e.message), tbAll) : toast('预览失败:' + e.message); } } function pvCloseOverlayQuiet() { const fs = document.getElementById('fs-viewer'); if (!fs.classList.contains('hidden') && fs.querySelector('.pv-loading')) closeFullscreen(); } // 文本类「新窗口」承载:md 用面板同一份渲染 HTML(图片已改写成绝对下载地址), // 其余按 text/plain 原样打开——服务端文件响应一律 attachment,直接导航只会触发下载。 // md 里原样透传的