Files
agent/app/server/routes/local.js
kicer 60d8278610 fix(local): 远程访问时 /api/local/* 一律 404,工作目录入口不再「点了没反应」
经隧道从手机访问时 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
2026-11-15 14:27:07 +08:00

169 lines
8.6 KiB
JavaScript
Raw Permalink 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();
// 这些接口都是弹宿主机的原生对话框 / 开 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;