经隧道从手机访问时 core 跑在家里那台机器上、local 路由存在,前端会显示「工作目录」 入口;点下去调 /api/local/pick-dir 会在宿主机屏幕上弹原生对话框,用户看不到, 表现成点击无响应。 这些接口(弹目录对话框 / 开 Finder / 开终端)只有坐在这台机器前才有意义。加一个 中间件:非本机访问直接 404,行为和服务器形态完全一致(那边 server.js 根本不挂这个 路由),前端原有的 catch 就会把入口整条隐藏 —— 前端零改动。 判断看 X-Forwarded-* 头是否存在(反向代理的标准约定,不依赖具体 nginx 配置): - 不能用 IP:stream 把 443 分流到 127.0.0.1:1443,nginx 看到的源地址永远是 127.0.0.1 - 不能用 Host:tunnel client 用 fetch 转发时 Host 是禁止头,被重写成 127.0.0.1:8090
169 lines
8.6 KiB
JavaScript
169 lines
8.6 KiB
JavaScript
// 本地桌面端(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();
|
||
|
||
// 这些接口都是弹宿主机的原生对话框 / 开 Finder / 开终端,只有坐在这台机器前才有意义。
|
||
// 远程访问(经隧道 / 反代 / 局域网)一律当作不存在,返回 404 —— 行为和服务器形态完全一致
|
||
// (那边 server.js 根本不挂这个路由),前端原有的 catch 就会把入口整条隐藏。
|
||
// 判断依据:反向代理一定会加 X-Forwarded-* 头(nginx 设的,tunnel client 原样转发),
|
||
// 本机直连 127.0.0.1:8090 不会有。
|
||
// 不能看 Host:tunnel client 用 fetch 转发时 Host 是禁止头、会被重写成 127.0.0.1:8090。
|
||
// 也不能看 X-Forwarded-For 的 IP 值:stream 分流后源地址永远是 127.0.0.1。
|
||
function isLocalHost(req) {
|
||
if (req.headers['x-forwarded-for'] || req.headers['x-forwarded-host']
|
||
|| req.headers['x-real-ip'] || req.headers['x-forwarded-proto']) return false;
|
||
const host = String(req.headers.host || '').replace(/:\d+$/, '').toLowerCase().replace(/^\[|\]$/g, '');
|
||
return host === '127.0.0.1' || host === 'localhost' || host === '::1';
|
||
}
|
||
|
||
router.use(function (req, res, next) {
|
||
if (isLocalHost(req)) return next();
|
||
res.status(404).json({ error: 'Not Found' });
|
||
});
|
||
|
||
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 });
|
||
}
|
||
|
||
// ---------- 原生文件管理器(仅本机会话目录内) ----------
|
||
// 文件树的列表接口已上收为通用的 GET /api/sessions/:id/tree(桌面端服务器形态也用),
|
||
// 这里只剩「在 Finder / 终端中打开」这两个只能开在本机的动作。
|
||
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 };
|
||
}
|
||
|
||
// 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;
|