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:
2026-09-23 22:59:52 +08:00
parent c2fcbd9b48
commit 1addf0d95d
8 changed files with 966 additions and 27 deletions
+72
View File
@@ -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;