data-page技能+服务端承载:①executor抽出runTaskSql统一SQL执行核心(db工具exec/query与HTTP API共用,prepare挡多语句/reader读写分流/BEGIN事务/DDL判定单一事实源;读取iterate到量截断防大表SELECT*物化OOM,工具超限给截断信封、API超限报error引导分页,query信封不再报total_rows)②新路由/app/{task_id}/静态托管任务app/子树(index兜底、不给列目录)+POST /api/db/{task_id}/query任意单语句,失败200+{error}按SKILL.md契约,挂登录态后、不加CORS头③技能run.py幂等复制templates到app/templates(dest由manager预转绝对路径防本地模式cwd落技能目录),SKILL.md补front matter(op=list描述+input_schema)与lastInsertRowid示例
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
// data-page 技能的服务端承载,两条通道(配套 skills/data-page/SKILL.md 的契约):
|
||||
// 1. GET /app/{task_id}/... —— 静态托管任务目录的 app/ 子树(index.html 兜底,不给列目录);
|
||||
// 只暴露 app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。
|
||||
// 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');
|
||||
|
||||
// 页面忘写 LIMIT 的服务端兜底:iterate 到量即停(不全量物化),超限报错引导分页。
|
||||
const API_MAX_ROWS = 2000;
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
function notFound(res, msg) {
|
||||
res.status(404).json({ error: msg });
|
||||
}
|
||||
|
||||
// ---------- /app/{task_id}/...:任务 app/ 子树静态托管 ----------
|
||||
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');
|
||||
let abs;
|
||||
try {
|
||||
abs = resolveInTask(appRoot, segs.slice(1).join('/') || '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, '页面不存在');
|
||||
res.sendFile(abs, 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;
|
||||
Reference in New Issue
Block a user