Files
agent/app/server/routes/local.js
T
kicer 2d5467203b feat(local): 左栏改为图标操作栏,本地端 IDE 式文件树 + 预览
侧栏底部原来的整行用户区换成四个图标:会话 / 文件树 / 预览 / 设置,
当前生效的那一项高亮;设置与预览图标都是开关(再点一次关闭)。
去掉顶部「会话/文件」分段切换,改用底部图标切换互斥面板。

- local-files.js(新增):只读文件树,懒加载单层、展开才请求、忽略大目录,
  点文件进右侧预览;支持在 Finder / 终端中打开
- routes/local.js:新增 /tree(单层、越界双重校验)、/reveal、/terminal
- preview.js:记录最后预览的文件,预览图标可重开上次文件;开合时同步图标高亮
- files.js:底部操作栏接线,设置图标点击切换开合
- settings.js:打开设置不再折叠左栏;图标选中态同步
- 纯前端 + local 路由(AGENT_LOCAL_PICK 门控),服务器/手机形态行为不变
2026-11-11 14:49:57 +08:00

194 lines
9.4 KiB
JavaScript
Raw 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.
// 本地桌面端(local/ 启动器)专用:唤起系统原生目录选择器。
// 只在 AGENT_LOCAL_PICK=1 时挂载(见 server.js),服务器形态根本不加载本文件。
//
// 为什么必须走后端:浏览器拿不到本机目录的绝对路径(<input webkitdirectory> 只给相对名),
// 要真实路径只能调系统对话框。必须 execFile 异步——同步执行会阻塞事件循环,所有会话的 SSE
// 都会卡住,直到用户关掉对话框。用户取消不是错误,回 { path: '' };
// 其它失败(无对话框、权限被拒、超时)要带原因回给前端,别让用户以为是自己取消了。
const express = require('express');
const fs = require('fs');
const path = require('path');
const os = require('os');
const { execFile } = require('child_process');
const engine = require('../engine');
const router = express.Router();
function sendErr(res, err) {
const code = (err && err.status_code) || 500;
res.status(code).json({ error: String((err && err.message) || err) });
}
// 各平台可用的对话框后端。mac 用 osascript;Linux 依次试 zenity / kdialog。
// cancelRe / cancelExit 区分「用户取消」和「真失败」:
// osascript 取消时 stderr 是 "User canceled. (-128)",别的报错(如自动化权限被拒)不能当取消;
// zenity/kdialog 取消统一退出码 1。
const CANDIDATES = process.platform === 'darwin'
? [{ cmd: 'osascript', args: ['-e', 'POSIX path of (choose folder with prompt "选择这个会话的工作目录")'], cancelRe: /User canceled|-128/ }]
: process.platform === 'linux'
? [
{ cmd: 'zenity', args: ['--file-selection', '--directory', '--title=选择这个会话的工作目录'], cancelExit: 1 },
{ cmd: 'kdialog', args: ['--getexistingdirectory', os.homedir(), '--title', '选择这个会话的工作目录'], cancelExit: 1 },
]
: [];
// 跑一个对话框,resolve 出选中的路径(用户取消 → '')。
// 超时兜底:对话框可能被用户晾在那儿,这里到点 kill,避免永远挂着一个 child。
function runPicker(cand, timeoutMs) {
return new Promise((resolve, reject) => {
execFile(cand.cmd, cand.args, { timeout: timeoutMs, maxBuffer: 1 << 20 }, (err, stdout, stderr) => {
if (!err) return resolve(String(stdout || '').trim());
if (err.code === 'ENOENT') return reject(Object.assign(new Error('no-cmd'), { no_cmd: true }));
if (err.killed) return reject(Object.assign(new Error('选择目录超时,请重试'), { status_code: 408 }));
const msg = String(stderr || '').trim();
if (cand.cancelRe && cand.cancelRe.test(msg)) return resolve('');
if (cand.cancelExit && err.code === cand.cancelExit) return resolve('');
reject(Object.assign(new Error('目录选择器失败:' + (msg || ('退出码 ' + err.code))), { status_code: 500 }));
});
});
}
async function pickDir() {
if (!CANDIDATES.length) {
throw Object.assign(new Error('当前系统不支持目录选择(仅支持 macOS / Linux)'), { status_code: 501 });
}
for (const cand of CANDIDATES) {
try {
const out = await runPicker(cand, 120000);
if (!out) return '';
// osascript 的 POSIX path 带尾斜杠,去掉让展示一致;选到根 '/' 时保底保留。
return out.replace(/\/+$/, '') || '/';
} catch (e) {
if (e.no_cmd) continue; // 换下一个后端
throw e;
}
}
throw Object.assign(new Error('没有可用的目录选择器(Linux 请安装 zenity 或 kdialog)'), { status_code: 501 });
}
// ---------- 只读文件树 / 原生文件管理器(仅本机会话目录内) ----------
// 目录可能是真实项目,含 node_modules 等大目录:一律「一次只列一层」,客户端展开才请求。
// 绝不能复用 listTaskFiles 的整棵递归——同步递归会卡死单线程 core,连 SSE 一起挂。
const IGNORE_DIRS = new Set([
'node_modules', '.git', 'dist', 'build', 'out', 'target', '.venv', 'venv',
'__pycache__', '.next', '.cache', 'coverage', '.idea', '.vscode',
]);
const TREE_MAX = 500;
function isInside(rootAbs, abs) {
return abs === rootAbs || abs.startsWith(rootAbs + path.sep);
}
// 会话内相对路径 → 绝对路径,双重越界校验(字面 + realpath,防符号链接跳出)。
function resolveInside(sessionId, rel) {
const sid = String(sessionId || '').trim();
if (!sid) throw Object.assign(new Error('缺少 session'), { status_code: 400 });
const session = engine.getSession(sid);
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
const rootAbs = path.resolve(engine.taskDirOf(sid));
const p = String(rel || '').replace(/^[\\/]+/, '');
const abs = p ? path.resolve(rootAbs, p) : rootAbs;
if (!isInside(rootAbs, abs)) throw Object.assign(new Error('路径越界'), { status_code: 400 });
let real = abs, rootReal = rootAbs;
try { real = fs.realpathSync(abs); } catch (_) {}
try { rootReal = fs.realpathSync(rootAbs); } catch (_) {}
if (!isInside(rootReal, real)) throw Object.assign(new Error('路径越界'), { status_code: 400 });
return { rootAbs: rootAbs, abs: abs };
}
// 懒加载单层目录。ignored 的目录只回标记、前端灰显且不展开(避免 node_modules 那种灾难)。
router.get('/tree', (req, res) => {
let abs;
try { abs = resolveInside(req.query.session, req.query.dir || '').abs; }
catch (err) { return sendErr(res, err); }
let st;
try { st = fs.statSync(abs); } catch (_) { return res.status(404).json({ error: '目录不存在' }); }
if (!st.isDirectory()) return res.status(400).json({ error: '不是目录' });
const showHidden = req.query.hidden === '1';
const rel = String(req.query.dir || '').replace(/^[\\/]+/, '').replace(/\/+$/, '');
const entries = [];
try {
for (const e of fs.readdirSync(abs, { withFileTypes: true })) {
if (!showHidden && e.name.startsWith('.')) continue;
const childRel = rel ? rel + '/' + e.name : e.name;
if (e.isSymbolicLink()) { entries.push({ name: e.name, rel: childRel, type: 'link' }); continue; }
if (e.isDirectory()) {
entries.push({ name: e.name, rel: childRel, type: 'dir', ignored: IGNORE_DIRS.has(e.name) });
} else if (e.isFile()) {
let size = null;
try { size = fs.statSync(path.join(abs, e.name)).size; } catch (_) {}
entries.push({ name: e.name, rel: childRel, type: 'file', size: size });
}
}
} catch (err) { return sendErr(res, err); }
entries.sort((a, b) =>
(a.ignored ? 1 : 0) - (b.ignored ? 1 : 0) ||
(a.type === 'dir' ? 0 : 1) - (b.type === 'dir' ? 0 : 1) ||
(a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
res.json({
root: path.resolve(engine.taskDirOf(String(req.query.session || ''))),
dir: rel,
total: entries.length,
capped: entries.length > TREE_MAX,
entries: entries.slice(0, TREE_MAX),
});
});
// execFile 异步(同步会阻塞事件循环);open/xdg-open 一般秒回,10s 兜底。
function runOpen(cmd, args) {
return new Promise((resolve, reject) => {
execFile(cmd, args, { timeout: 10000 }, (err) => {
if (!err) return resolve();
if (err.code === 'ENOENT') return reject(Object.assign(new Error('no-cmd'), { no_cmd: true }));
if (err.killed) return reject(Object.assign(new Error('系统调用超时'), { status_code: 504 }));
reject(Object.assign(new Error('打开失败:' + (err.message || err.code)), { status_code: 500 }));
});
});
}
function dirOf(abs) {
try { return fs.statSync(abs).isDirectory() ? abs : path.dirname(abs); } catch (_) { return path.dirname(abs); }
}
// 在系统文件管理器里打开:目录→直接打开;文件→定位所在目录(mac 用 open -R 直接选中该文件)。
router.post('/reveal', (req, res) => {
let target;
try { target = resolveInside(req.body && req.body.session, req.body && req.body.path); }
catch (err) { return sendErr(res, err); }
const abs = target.abs;
let isDir = false;
try { isDir = fs.statSync(abs).isDirectory(); } catch (_) {}
const mac = process.platform === 'darwin';
const cmd = mac ? 'open' : 'xdg-open';
const args = mac && !isDir ? ['-R', abs] : [isDir ? abs : path.dirname(abs)];
runOpen(cmd, args).then(() => res.json({ ok: true })).catch(err => sendErr(res, err));
});
// 在系统终端里打开该目录。mac 用 open -a Terminal;Linux 尽力而为。
router.post('/terminal', (req, res) => {
let target;
try { target = resolveInside(req.body && req.body.session, req.body && req.body.path); }
catch (err) { return sendErr(res, err); }
const dir = dirOf(target.abs);
if (process.platform === 'darwin') {
runOpen('open', ['-a', 'Terminal', dir]).then(() => res.json({ ok: true })).catch(err => sendErr(res, err));
return;
}
runOpen('x-terminal-emulator', ['--working-directory=' + dir])
.then(() => res.json({ ok: true }))
.catch(() => runOpen('gnome-terminal', ['--working-directory=' + dir])
.then(() => res.json({ ok: true }))
.catch(() => sendErr(res, Object.assign(new Error('没有可用的终端程序'), { status_code: 501 }))));
});
// 能力探测:前端凭这个决定是否显示「工作目录」入口(拿不到就整条隐藏)。
router.get('/info', (req, res) => {
res.json({ enabled: true, platform: process.platform, workspace_root: engine.getConfig().workspace_root });
});
router.post('/pick-dir', (req, res) => {
pickDir().then(p => res.json({ path: p })).catch(err => sendErr(res, err));
});
module.exports = router;