feat(ui): 预览分栏挪到文件树右侧,底部操作栏收成三个按钮

IDE 式三栏:文件树 | 预览 | 会话。点文件后内容就在旁边,不用横跨会话区。

- 预览分栏从窗口右缘移到文件树右侧:侧栏展开时 left=--sidebar-w,折叠时贴窗口最左;
  会话区改成往右让位;拖拽手柄随之换到预览右缘,拖动方向取反
- .pv-head 定死高度 49px:预览头有地址条、文件树头只有图标钮,靠内容撑会差几像素,
  两栏下边框对不齐
- 文件树头部去掉地址条(280px 里路径必然截断,没有信息量),只留右侧操作钮
- 底部操作栏收成三个按钮(文件树 / 预览 / 设置):「文件树」现在是
  会话列表 ↔ 文件树的切换开关,当前在文件页时高亮
- 窄屏不再误藏文件树按钮(只藏预览,因为窄屏没有右侧分栏);窄屏点文件后收起抽屉
- 切会话不再自动关预览:中间这一列是常驻参考区,关掉会让人反复重开
- 打开预览时无条件把侧栏切到文件树(已在文件页则空操作)
This commit is contained in:
2026-11-11 15:26:01 +08:00
parent 8ef4ec1ee4
commit 4e97194b04
6 changed files with 64 additions and 66 deletions
+6 -17
View File
@@ -1,7 +1,7 @@
// 桌面端左栏文件树:会话文件的唯一浏览入口(服务器形态与 local 形态共用)。
// · 懒加载:一次只请求一层目录,展开才拉下一层;node_modules 这类大目录后端只回标记、不展开,
// 避免旧的整棵递归接口在单线程 core 上卡死;
// · 点文件 → 右侧预览;行内 hover 出「下载 / 删除 / 在 Finder 中显示」;
// · 点文件 → 中间预览栏(文件树 | 预览 | 会话);行内 hover 出「下载 / 删除 / 在 Finder 中显示」;
// · 「在 Finder / 终端中打开」只在 local 启动器下可用(服务器上这些动作没有意义),
// 靠 /api/local/info 探测,拿不到就隐藏这两个按钮。
// 手机端不启用(收纳在抽屉里体验太差),仍走输入行右侧的旧文件面板。
@@ -25,7 +25,6 @@
let cache = new Map(); // rel -> /tree 响应
let loading = new Map(); // rel -> Promise(并发去重)
let gen = 0; // 会话切换/刷新时自增,防止旧请求回填到新树的缓存
let rootPath = ''; // 会话根绝对路径(后端回的),显示在头部
// 失效缓存。gen 自增让在飞的旧请求回来时不再写缓存(否则切会话会闪旧目录)。
function invalidate(keepExpanded) {
@@ -116,7 +115,6 @@
container.innerHTML = '';
const data = await openDir(rel);
if (!data) return;
if (!rel && data.root) rootPath = data.root;
const frag = document.createDocumentFragment();
const list = data.entries || [];
if (!list.length) tip(frag, '(空目录)');
@@ -133,20 +131,10 @@
container.appendChild(frag);
}
function renderPathLabel() {
const el = $('tree-path');
if (!el) return;
// 根路径太长时只留末两段,完整路径放 title(地址条的直觉:能看个大概,悬停能看全)
const parts = String(rootPath || '').split('/').filter(Boolean);
const short = parts.length > 2 ? '.../' + parts.slice(-2).join('/') : (rootPath || '会话文件');
el.textContent = short;
el.title = rootPath || '';
}
async function renderBody() {
const body = $('tree-body');
if (!body) return;
if (!sid()) { body.innerHTML = ''; rootPath = ''; renderPathLabel(); tip(body, '尚未开始会话'); return; }
if (!sid()) { body.innerHTML = ''; tip(body, '尚未开始会话'); return; }
const sc = body.scrollTop;
body.innerHTML = '';
const root = document.createElement('div');
@@ -157,7 +145,6 @@
root.innerHTML = '';
tip(root, '加载失败:' + e.message);
}
renderPathLabel();
body.scrollTop = sc;
}
@@ -209,6 +196,8 @@
renderBody();
} else if (typeof openFilePreview === 'function') {
openFilePreview(rel, '');
// 窄屏的预览是全屏浮层:点完把抽屉收起(同点会话的行为),否则关预览后还压在抽屉上
if (typeof openDrawer === 'function' && !window.matchMedia('(min-width: 960px)').matches) openDrawer(false);
}
}
@@ -226,12 +215,12 @@
box.dataset.ready = '1';
box.innerHTML = '';
// 头部直接复用预览栏的 .pv-head / .pv-addr / .pv-actions / .icon-btn:
// 头部直接复用预览栏的 .pv-head / .pv-actions / .icon-btn:
// 两者在桌面上左右并排,尺寸/描边/内边距必须一模一样,否则一眼就看出错位。
// 不放地址条(路径在 280px 里必然截断,没有信息量),所以只剩右侧操作钮。
const head = document.createElement('header');
head.className = 'pv-head tree-head';
head.innerHTML =
'<span class="pv-addr"><span class="pv-title tree-path" id="tree-path"></span></span>' +
'<span class="pv-actions">' +
'<button class="icon-btn" type="button" id="tree-hidden" title="显示隐藏文件" aria-label="显示隐藏文件">' + SVG_EYE + '</button>' +
'<button class="icon-btn" type="button" id="tree-refresh" title="刷新" aria-label="刷新">' + SVG_REFRESH + '</button>' +
+12 -14
View File
@@ -1233,26 +1233,24 @@
document.addEventListener('touchcancel', e => endDrag(e, false), { passive: true });
})();
// 抽屉底部图标操作栏:会话 / 文件树 / 预览 / 设置。
// 会话与文件树是侧栏的两个互斥面板,所以这两个的 active 由 setDrawerPane 维护;
// 预览与设置不占用侧栏(各自是右侧面板/覆盖层),高亮由 preview.js / settings.js 自己同步。
function setDrawerPane(mode) {
const drawer = $('drawer');
const files = mode === 'files';
// 文件树只在本地模式存在;服务器形态下这个按钮是 hidden 的,这里再做一层兜底
// 抽屉底部图标操作栏:文件树 / 预览 / 设置。
// 「文件树」是侧栏两个互斥面板的切换开关:不在文件页 → 切到文件树(高亮),
// 再点一次 → 回会话列表(不亮)。预览与设置不占用侧栏,高亮由 preview.js / settings.js 同步。
function setDrawerPane(files) {
// 文件树模块没加载成功时不要把一个空面板切出来
if (files && typeof window.showFileTree !== 'function') return;
const drawer = $('drawer');
const changed = drawer.classList.contains('drawer-mode-files') !== files;
drawer.classList.toggle('drawer-mode-files', files);
$('da-sessions').classList.toggle('active', !files);
$('da-files').classList.toggle('active', files);
// 重复点当前项不重干活(不重拉列表/不重渲树),避免白掉请求和滚动位置
if (changed) {
if (files) window.showFileTree();
else loadSessionList();
}
if (!changed) return;
if (files) window.showFileTree();
else loadSessionList();
}
$('da-sessions').addEventListener('click', () => setDrawerPane('sessions'));
$('da-files').addEventListener('click', () => setDrawerPane('files'));
$('da-files').addEventListener('click', () => {
setDrawerPane(!$('drawer').classList.contains('drawer-mode-files'));
});
// 预览:同一个按钮开/关右侧面板
$('da-preview').addEventListener('click', () => {
if (typeof pvTogglePane === 'function') pvTogglePane();
+14 -9
View File
@@ -1,7 +1,8 @@
// 通用文档预览窗(桌面右侧 #pv-pane / 移动端全屏 #fs-viewer)
// 通用文档预览窗(桌面分栏 #pv-pane:文件树 | 预览 | 会话 / 移动端全屏 #fs-viewer)
// —— 文件列表的点击一律进预览窗:office 走 /preview 预览网关(固定格式前端自拼);
// md/txt/代码/json/csv 等文本渲染;html/pdf/图片专用渲染;其余类型显示文件信息占位 + 下载。
// 桌面端与左栏并排(不再自动折叠左栏让位);左右边界可拖拽调宽(记忆在 localStorage)。
// 桌面端紧贴左栏文件树右侧:点文件后内容就在旁边,不用横跨整个会话区看。
// 右边界可拖拽调宽(记忆在 localStorage)。
// 依赖(core.js/chat.js/stream.js/files.js 顶层声明):state $ esc toast mdHtml decorateCodePre
// rewriteHtmlDocSrcs rewriteMdImageSrcs openFullscreen setFsSource closeFullscreen
// openImageViewer downloadFile openDrawer
@@ -119,10 +120,13 @@ function pvInfoNode(name, sizeText, hint) {
}
function pvOpenPane() {
// 不自动折叠左侧栏:本地端左栏是文件树,打开预览时保持可见(左侧树 + 右侧预览并排)。
// 不自动折叠左侧栏:左栏是文件树,打开预览时保持可见(文件树 | 预览 | 会话)。
if (!document.body.classList.contains('pv-open')) {
document.body.classList.add('pv-open');
}
// 开预览就把侧栏切到文件树:预览就贴在它旁边,切了才能顺手换文件看。
// 已经在文件页时 setDrawerPane 内部会因「没变化」而直接返回,不会重复拉树。
if (typeof setDrawerPane === 'function') setDrawerPane(true);
pvSyncBtn();
}
@@ -135,7 +139,7 @@ function pvCloseDoc() {
pvSyncBtn();
}
// 侧栏底部「预览」图标:开/关右侧预览面板(桌面端)。图标随开合高亮。
// 侧栏底部「预览」图标:开/关预览分栏(桌面端)。图标随开合高亮。
function pvSyncBtn() {
const b = document.getElementById('da-preview');
if (b) b.classList.toggle('active', document.body.classList.contains('pv-open'));
@@ -143,7 +147,7 @@ function pvSyncBtn() {
// 同一个图标开/关预览:已开 → 关;未开 → 优先重开上次看过的文件,没有就开空面板给个提示。
function pvTogglePane() {
if (!pvDesktop()) return; // 移动端预览走全屏 #fs-viewer,不维护右栏
if (!pvDesktop()) return; // 移动端预览走全屏 #fs-viewer,不维护分栏
if (document.body.classList.contains('pv-open')) { pvCloseDoc(); return; }
if (pvState.lastName) { openFilePreview(pvState.lastName); return; }
pvOpenPane(); pvClearBody(); pvHeader('', '');
@@ -592,17 +596,18 @@ window.addEventListener('popstate', () => {
const fs = document.getElementById('fs-viewer');
if (!fs.classList.contains('hidden') && fs.querySelector('.fs-html-frame[src^="/preview/"]')) closeFullscreen();
});
// Esc 关闭右栏(未开全屏查看器时)
// Esc 关闭预览分栏(未开全屏查看器时)
window.addEventListener('keydown', (e) => {
if (e.key !== 'Escape') return;
if (document.activeElement && document.activeElement.id === 'pv-title') { document.activeElement.blur(); return; } // 地址条聚焦时:先退框不关栏
if (!document.getElementById('fs-viewer').classList.contains('hidden')) return;
pvCloseDoc();
});
// 窗口收窄到移动端宽度:右栏收起
// 窗口收窄到移动端宽度:预览栏收起
window.matchMedia('(min-width: 960px)').addEventListener('change', () => { if (!pvDesktop()) pvCloseDoc(); });
// ---------- 左缘拖拽调宽(预览/会话列边界):双击复位默认宽度,宽度记在 localStorage ----------
// ---------- 右缘拖拽调宽(预览/会话列边界):双击复位默认宽度,宽度记在 localStorage ----------
// 预览现在贴在文件树右侧(文件树 | 预览 | 会话),所以手柄在它自己的右缘,往右拖变宽。
(function bindPvResize() {
const pane = document.getElementById('pv-pane');
const saved = Number(localStorage.getItem('pv-w') || 0);
@@ -619,7 +624,7 @@ window.matchMedia('(min-width: 960px)').addEventListener('change', () => { if (!
});
h.addEventListener('pointermove', (e) => {
if (!st) return;
document.documentElement.style.setProperty('--pv-w', clamp(st.w + (st.x - e.clientX)) + 'px');
document.documentElement.style.setProperty('--pv-w', clamp(st.w + (e.clientX - st.x)) + 'px');
});
function end() {
if (!st) return;
+2 -3
View File
@@ -188,9 +188,8 @@
closeStream();
removeTyping();
setFilesPanel(false); // 会话切换,收起文件面板防旧列表残留
if (typeof pvCloseDoc === 'function') pvCloseDoc(); // 同上:收起文档预览右栏,防旧会话内容残留
// 预览图标会「重开上次看过的文件」,跨会话重开会指向别的会话的路径,逐会话清掉
if (typeof pvState === 'object' && pvState) pvState.lastName = null;
// 预览分栏故意不关:它现在是「随手看参考」的第三列,切会话时关掉会让用户反复重开。
// 保留已渲染的内容(静态文件,不存在跨会话越权),点新会话的文件会自然覆盖。
state.sessionId = id;
state.status = '';
state.modelId = '';