Files

108 lines
5.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.
// data-page 技能的服务端承载,两条通道(配套 skills/data-page/SKILL.md 的契约):
// 1. GET /app/{task_id}/... —— 静态托管任务目录的 .app/ 子树(index.html 兑底,不给列目录);
// 目录名刻意带点:任务文件面板默认隐藏(?hidden=1 才列);
// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏;
// 允许符号链接(技能页面链回技能目录,不必每会话复制),
// 但 realpath 必须落在会话目录或技能根目录内。
// 2. POST /api/db/{task_id}/query —— 任务 data.db 的 SQL API(页面前端 fetch 调):任意单语句,
// 执行核心与 db 工具共用 runTaskSql(executor.js),语义单一事实源。
// 认证:挂在 server.js 的 auth.middleware 之后——信任模型与 files 路由一致(登录 ≈ 运维,可跨会话)。
// 刻意不加任何 CORS 头:跨站 application/json POST 会被预检挡下,不带 cookie 的匿名页也调不动。
// 响应契约(SKILL.md 原文):SELECT→行数组;写→{rowsAffected,lastInsertRowid};DDL→{ok:true};
// 失败→HTTP 200 + {error}(前端统一查 error 字段)。会话/路径级错误才用 4xx。
const express = require('express');
const fs = require('fs');
const path = require('path');
const engine = require('../engine');
const { resolveInTask, runTaskSql } = require('../tools/executor');
const { skillsRoot } = require('../tools/skills');
// 页面忘写 LIMIT 的服务端兜底:iterate 到量即停(不全量物化),超限报错引导分页。
const API_MAX_ROWS = 2000;
const router = express.Router();
function notFound(res, msg) {
res.status(404).json({ error: msg });
}
// 符号链接白名单:技能页面不必每个会话复制一份,发布时链回技能目录(见各技能的 run.py)。
// 链接只是字符串:executor 里看不到的目标也能被链上,而解析发生在 core 的命名空间
// (例如 core 把 ./config.yml 挂在 /app/config.yml),所以 realpath 后必须落在
// 「本会话目录」或「技能根目录」内,其余一律 404。
function realInside(abs, roots) {
let real;
try { real = fs.realpathSync(abs); } catch (_) { return null; }
for (const root of roots) {
if (real === root || real.startsWith(root + path.sep)) return real;
}
return null;
}
// ---------- /app/{task_id}/...:任务 .app/ 子树静态托管(URL 路径与目录名解耦)----------
router.use('/app', (req, res) => {
try {
const segs = req.path.replace(/^\/+/, '').split('/');
const sessionId = segs[0];
if (!sessionId) return notFound(res, '会话不存在');
if (!engine.getSession(sessionId)) return notFound(res, '会话不存在');
const appRoot = path.join(engine.taskDirOf(sessionId), '.app');
// 页面根目录的地址必须带尾斜杠:浏览器按「最后一段是否目录」算相对链接的基址,
// /app/<会话> 会把 ./table.html 解析成 /app/table.html(白屏)。
// 空余路径 = 就是在要根目录 → 补斜杠再跳转;比让每个技能模板改绝对链接可靠。
// 注意不能靠 stat 判断:下面空余路径会先被映射成 index.html,永远不是目录。
const rest = segs.slice(1).join('/');
if (!rest && !req.path.endsWith('/')) {
const q = req.originalUrl.indexOf('?');
return res.redirect(302, (q < 0 ? req.originalUrl : req.originalUrl.slice(0, q)) + '/'
+ (q < 0 ? '' : req.originalUrl.slice(q)));
}
let abs;
try {
abs = resolveInTask(appRoot, rest || 'index.html'); // 越界即挡,限 .app/ 子树
} catch (_) {
return notFound(res, '非法路径');
}
let st;
try { st = fs.statSync(abs); } catch (_) { return notFound(res, '页面不存在'); }
if (st.isDirectory()) {
abs = path.join(abs, 'index.html'); // 目录请求补 index.html,仍无则 404
try { st = fs.statSync(abs); } catch (_) { return notFound(res, '页面不存在'); }
}
if (!st.isFile()) return notFound(res, '页面不存在');
const candidates = [engine.taskDirOf(sessionId)];
try { candidates.push(skillsRoot({ cfg: engine.getConfig() })); } catch (_) {}
const roots = [];
for (const dir of candidates) {
try { roots.push(fs.realpathSync(dir)); } catch (_) {}
}
const real = realInside(abs, roots);
if (!real) return notFound(res, '页面不存在');
res.sendFile(real, err => {
if (err && !res.headersSent) notFound(res, '页面不存在');
});
} catch (err) {
if (!res.headersSent) res.status(400).json({ error: (err && err.message) || String(err) });
}
});
// ---------- POST /api/db/{task_id}/query:任务 data.db 的 SQL API ----------
router.post('/api/db/:id/query', (req, res) => {
if (!engine.getSession(req.params.id)) return notFound(res, '会话不存在');
const body = req.body || {};
let r;
try {
r = runTaskSql(engine.taskDirOf(req.params.id), String(body.sql || ''), body.params, 'any', API_MAX_ROWS);
} catch (err) {
// SQL 语义错误走 200 + {error}(SKILL.md 契约:前端只查 error 字段,不分状态码)
return res.json({ error: (err && err.message) || String(err) });
}
if (r.kind === 'read') {
if (r.overflow) return res.json({ error: '结果超过 ' + API_MAX_ROWS + ' 行,请加 LIMIT/OFFSET 分页' });
return res.json(r.rows);
}
return res.json(r.out);
});
module.exports = router;