Files
agent/app/server/routes/files.js
T

203 lines
8.1 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.
// 文件管理 API(README 10.3):上传 / 列表 / 下载 / 删除
const express = require('express');
const fs = require('fs');
const path = require('path');
const multer = require('multer');
const crypto = require('crypto');
const engine = require('../engine');
const { listTaskFiles } = require('./sessions');
const { resolveInTask } = require('../tools/executor');
const router = express.Router();
function taskDir(req) {
const dir = engine.taskDirOf(req.params.id);
fs.mkdirSync(dir, { recursive: true });
return dir;
}
function sanitizeName(original) {
let name = Buffer.from(original || 'file', 'latin1').toString('utf8');
name = path.basename(name).replace(/[\/\x00-\x1f]/g, '_');
while (name.startsWith('.')) name = name.slice(1);
return name || 'file';
}
const upload = multer({
storage: multer.diskStorage({
destination: function (req, file, cb) {
try { cb(null, taskDir(req)); } catch (err) { cb(err); }
},
filename: function (req, file, cb) {
try {
const dir = taskDir(req);
const name = sanitizeName(file.originalname);
const ext = path.extname(name);
const stem = name.slice(0, name.length - ext.length);
let target = name;
let i = 0;
while (fs.existsSync(path.join(dir, target))) {
i++;
target = stem + '-' + i + ext;
}
cb(null, target);
} catch (err) { cb(err); }
},
}),
limits: { filesize: 50 * 1024 * 1024 },
});
router.post('/:id/files', upload.array('files', 10), function (req, res) {
try {
const uploaded = (req.files || []).map(f => ({ filename: f.filename, size: f.size }));
const db = engine.getDb();
for (const f of uploaded) {
db.prepare('INSERT INTO files (session_id, filename, size, created_at) VALUES (?,?,?,?)')
.run(req.params.id, f.filename, f.size, Date.now());
}
// 主动告知 AI:文件名、大小等随上传以一条用户消息进入会话(live/held/queued 都能送达)。
// 失败不影响上传本身。
if (uploaded.length) {
try {
const list = uploaded.map(f => '- ' + f.filename + '(' + f.size + ' 字节)').join('\n');
engine.postUserMessage(req.params.id,
'【系统通知】用户通过页面上传了 ' + uploaded.length + ' 个文件到任务目录:\n' + list +
'\n请告知用户已收到,并按需处理这些文件。');
} catch (e) { console.warn('[files] 上传通知 AI 失败:', e && e.message || e); }
}
res.json({ uploaded });
} catch (err) {
res.status(500).json({ error: String(err && err.message || err) });
}
});
router.get('/:id/files', function (req, res) {
try {
const session = engine.getSession(req.params.id);
if (!session) return res.status(404).json({ error: '会话不存在' });
res.json(listTaskFiles(engine.taskDirOf(session.id)));
} catch (err) {
res.status(500).json({ error: String(err && err.message || err) });
}
});
// ---------- 临时下载链接(带签名 token,供浏览器原生下载使用) ----------
// 移动端浏览器 fetch+blob 下载会丢失文件名(uuid.bin);改为短时效签名链接,
// 前端拿到后 window.location.href 导航下载,走原生下载流程。
// 密钥随进程启动随机生成,重启后旧 token 自动失效。
const DOWNLOAD_TOKEN_TTL_MS = 5 * 60 * 1000;
const downloadTokenSecret = crypto.randomBytes(32).toString('hex');
function signDownloadToken(sessionId, rel, expires) {
return crypto.createHmac('sha256', downloadTokenSecret)
.update(sessionId + '\n' + rel + '\n' + expires).digest('hex');
}
function validDownloadToken(sessionId, rel, expires, t) {
const exp = Number(expires);
if (!t || !Number.isFinite(exp) || exp < Date.now()) return false;
const expected = signDownloadToken(sessionId, rel, exp);
try {
return crypto.timingSafeEqual(Buffer.from(String(t), 'utf8'), Buffer.from(expected, 'utf8'));
} catch (_) { return false; }
}
// 签发临时下载链接(需正常认证;拿到的链接 5 分钟内有效)
router.get('/:id/files/download-token', function (req, res) {
try {
const rel = String(req.query.path || '');
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
const abs = resolveInTask(engine.taskDirOf(req.params.id), rel);
if (!fs.statSync(abs).isFile()) return res.status(400).json({ error: '不是文件' });
const expires = Date.now() + DOWNLOAD_TOKEN_TTL_MS;
const t = signDownloadToken(req.params.id, rel, expires);
res.json({
url: '/api/sessions/' + encodeURIComponent(req.params.id) + '/files/download?path='
+ encodeURIComponent(rel) + '&expires=' + expires + '&t=' + t,
});
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
// 下载统一响应:禁用一切缓存协商。
// 默认的 ETag/Last-Modified + Cache-Control: public, max-age=0 会诱导移动端浏览器
// 先发条件请求拿 304 空体,下载管理器随后卡在“等待中”(桌面 Safari/curl 不受影响)。
function sendDownload(res, abs) {
res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate');
res.setHeader('Pragma', 'no-cache');
res.setHeader('Expires', '0');
res.download(abs, path.basename(abs), { acceptRanges: true, lastModified: false, etag: false, maxAge: 0 });
}
// 下载(支持子目录路径,前端用 ?path=xxx 传入相对路径)
router.get('/:id/files/download', function (req, res) {
try {
const rel = String(req.query.path || '');
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
// 带 token 的请求须先验签(会话/路径/时效任一不符即拒绝)
if (req.query.t && !validDownloadToken(req.params.id, rel, req.query.expires, String(req.query.t))) {
return res.status(403).json({ error: '下载链接已过期或无效' });
}
const abs = resolveInTask(engine.taskDirOf(req.params.id), rel);
const st = fs.statSync(abs);
if (!st.isFile()) return res.status(400).json({ error: '不是文件' });
sendDownload(res, abs);
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
router.delete('/:id/files', function (req, res) {
try {
const rel = String(req.query.path || '');
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
const dir = engine.taskDirOf(req.params.id);
const abs = resolveInTask(dir, rel);
if (path.resolve(abs) === path.resolve(dir)) {
return res.status(400).json({ error: '禁止删除任务目录' });
}
fs.rmSync(abs, { recursive: true, force: true });
engine.getDb().prepare('DELETE FROM files WHERE session_id = ? AND filename = ?')
.run(req.params.id, rel);
res.json({ ok: true });
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
// 兼容 README 形式:GET /:id/files/{filename}(支持子目录)
router.get('/:id/files/*', function (req, res) {
try {
const rel = req.params[req.params.length - 1] || '';
if (!rel) return res.status(400).json({ error: '缺少文件名' });
const abs = resolveInTask(engine.taskDirOf(req.params.id), rel);
const st = fs.statSync(abs);
if (!st.isFile()) return res.status(400).json({ error: '不是文件' });
sendDownload(res, abs);
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
// 兼容 README 形式:DELETE /:id/files/{filename}
router.delete('/:id/files/*', function (req, res) {
req.query.path = req.params[req.params.length - 1] || '';
if (!req.query.path) return res.status(400).json({ error: '缺少文件名' });
try {
const dir = engine.taskDirOf(req.params.id);
const abs = resolveInTask(dir, req.query.path);
if (path.resolve(abs) === path.resolve(dir)) {
return res.status(400).json({ error: '禁止删除任务目录' });
}
fs.rmSync(abs, { recursive: true, force: true });
engine.getDb().prepare('DELETE FROM files WHERE session_id = ? AND filename = ?')
.run(req.params.id, req.query.path);
res.json({ ok: true });
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
module.exports = router;