Files
agent/app/server/scheduler.js
T

194 lines
11 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.
// 定时任务调度器:AI 通过 schedule 工具为所在会话创建一个周期性任务
// (scheduled_tasks 表,生命周期绑定会话,CASCADE 随删),本模块常驻轮询到期任务:
// 先把会话历史整体存档(type='archived',llm.buildMessages 会跳过 → AI 只看到本次
// prompt,等价全新会话),再经 engine.postUserMessage 投递任务 prompt 自动开跑,
// 结果留在会话里供用户次日查看。
// 形态照抄 engine.js 的 startHoldSweeper:模块级 timer + setInterval + unref,
// 单次异常只记日志,绝不中断定时器。
// 启动时序:必须在 engine.init() 之后调 start(engine)(见 server.js)——
// engine.init() 先把 active 退回队列 / held 结版归位,首轮 tick 才不会看到脏状态。
// 依赖注入 engine 而非 require('./engine'):engine→executor→scheduler 已有引用链,
// 顶层反向 require 会成环拿到半成品 exports。
const { CronExpressionParser } = require('cron-parser'); // 锁定 v5.10.1:API 是 CronExpressionParser.parse(v4 的 parseExpression 已不存在)
const log = require('./log');
const TZ = 'Asia/Shanghai'; // 与容器 TZ(docker-compose)一致;显式传入,不依赖进程隐式时区
const TICK_MS = 30000; // 轮询周期:相对 1h 最小间隔足够密,无调优需求,不进 config.yml
const MIN_INTERVAL_MS = 3600000; // cron 最小间隔 1 小时:防 AI 排出分钟级任务反复烧模型池
const PROMPT_MAX_LEN = 20000; // prompt 长度上限,与 routes/sessions.js PATCH 口径一致
let eng = null; // engine 引用(start 注入)
let timer = null;
function fmtTime(t) {
return new Date(t).toLocaleString('zh-CN', { timeZone: TZ, hour12: false });
}
// 下次到期时间。一律以当前时刻为基准(而非上次 next_run_at):
// 服务器停机跨过若干触发点后重启,算出的自然是「未来最近一次」,天然跳过补跑。
function computeNext(cronExpr) {
return CronExpressionParser.parse(cronExpr, { tz: TZ }).next().getTime();
}
// ---------- schedule 工具实现(tools/executor.js 调) ----------
// cron 校验:可解析 + 连续两次 next() 间隔 ≥ 1h(防分钟级任务反复烧模型池);
// 返回下次到期时间(以 now 为基准)。创建(createTask)与会话详情弹窗改频次(PATCH /:id/schedule)共用。
// 失败抛中文 Error:工具路径由 engine 转 'Error: ...' 回给 AI,HTTP 路径由 wrap 转 4xx/500 给前端 toast。
function validateCron(cronExpr) {
let first;
let second;
try {
const it = CronExpressionParser.parse(cronExpr, { tz: TZ });
first = it.next().getTime();
second = it.next().getTime();
} catch (e) {
throw new Error('cron 表达式无效: ' + cronExpr + ' → ' + (e && e.message || e));
}
if (second - first < MIN_INTERVAL_MS) throw new Error('定时任务间隔不能小于 1 小时:' + cronExpr + ' 相邻两次触发不足 1h');
return first;
}
// sessionId 由调用方从工具 ctx 取(AI 无法指定别的会话)。校验顺序:
// validateCron → 本会话尚无任务 → INSERT(主键冲突兜底)。
function createTask(db, sessionId, cronExpr, prompt) {
if (prompt.length > PROMPT_MAX_LEN) throw new Error('prompt 过长(上限 ' + PROMPT_MAX_LEN + ' 字符)');
const first = validateCron(cronExpr);
const exist = db.prepare('SELECT cron_expr FROM scheduled_tasks WHERE session_id = ?').get(sessionId);
if (exist) throw new Error('本会话已有定时任务(' + exist.cron_expr + ')。改频次或提示词用 op=update;确要换新任务先 op=delete 再 op=create');
try {
db.prepare(
'INSERT INTO scheduled_tasks (session_id, cron_expr, prompt, next_run_at, created_at) VALUES (?,?,?,?,?)'
).run(sessionId, cronExpr, prompt, first, Date.now());
} catch (_) {
// 单进程同步 API 下正常到不了这里(上一步已查重),仅作主键约束重复报错的兜底
const ex = db.prepare('SELECT cron_expr FROM scheduled_tasks WHERE session_id = ?').get(sessionId);
throw new Error('本会话已有定时任务(' + (ex ? ex.cron_expr : cronExpr) + ')。改频次或提示词用 op=update;确要换新任务先 op=delete 再 op=create');
}
log.info('scheduler', sessionId + ' 创建定时任务 ' + cronExpr);
return { cron_expr: cronExpr, next_run_at: first, next_text: fmtTime(first) };
}
// ---------- 工具侧 get/update/delete(tools/executor.js 调) ----------
// 表主键 session_id → 每会话至多一条,资源即「本会话的任务」,无 id 参数。
// 语义与 routes/sessions.js 的 PATCH/DELETE 对齐,但不落 scheduler_note:
// AI 路径的返回文本本身已进会话记录,不再重复留痕。update 允许只改其一,
// 仅当改了 cron 才重算 next_run_at。不校验 running 状态(update 天然安全,
// delete 也不打断正在跑的回合)。
function getTask(db, sessionId) {
return db.prepare(
'SELECT cron_expr, prompt, next_run_at, last_run_at, last_status, last_note FROM scheduled_tasks WHERE session_id = ?'
).get(sessionId) || null;
}
function updateTask(db, sessionId, patch) {
const row = db.prepare('SELECT cron_expr, next_run_at FROM scheduled_tasks WHERE session_id = ?').get(sessionId);
if (!row) throw new Error('本会话没有定时任务,先用 op=create 创建');
let cron = row.cron_expr;
let next = row.next_run_at;
if (patch.cronExpr && patch.cronExpr !== row.cron_expr) {
next = validateCron(patch.cronExpr);
cron = patch.cronExpr;
}
const prompt = patch.prompt != null ? String(patch.prompt) : null;
if (prompt !== null && prompt.length > PROMPT_MAX_LEN) throw new Error('prompt 过长(上限 ' + PROMPT_MAX_LEN + ' 字符)');
db.prepare('UPDATE scheduled_tasks SET prompt = COALESCE(?, prompt), cron_expr = ?, next_run_at = ? WHERE session_id = ?')
.run(prompt, cron, next, sessionId);
log.info('scheduler', sessionId + ' 定时任务改为 ' + cron + '(原 ' + row.cron_expr + ')');
return { cron_expr: cron, next_run_at: next, next_text: fmtTime(next) };
}
function deleteTask(db, sessionId) {
const row = db.prepare('SELECT cron_expr FROM scheduled_tasks WHERE session_id = ?').get(sessionId);
if (!row) throw new Error('本会话没有定时任务,无需 op=delete');
db.prepare('DELETE FROM scheduled_tasks WHERE session_id = ?').run(sessionId);
log.info('scheduler', sessionId + ' 删除定时任务 ' + row.cron_expr);
return row.cron_expr;
}
// ---------- 投递 ----------
// 触发前把会话全部消息标为 archived:buildMessages 遇 type='archived' 直接跳过(llm.js),
// UI 照常展示全量(历次执行记录用户仍可见),AI 侧等价全新会话。
// 本库没有 session_context 这类 type 为空的常驻行,无需排除项;
// 旧摘要行(type='summary')一并存档——跳过即回到零上下文,行为正确。
function archiveHistory(db, sessionId) {
db.prepare("UPDATE messages SET type='archived' WHERE session_id = ?").run(sessionId);
}
// 投递 + 复活一体:postUserMessage 已按会话当时状态全量流转,无需单独复活步骤——
// held → 转 active 立即开跑(注意:会抢占保持中的模型);
// queued / completed / cancelled → 重新入队并尝试派发:有空闲模型当轮即跑,
// 没有则留在队列等 dispatchQueued(正是「半夜无人值守排队执行」场景,不是异常)。
function deliver(sessionId, prompt) {
return eng.postUserMessage(sessionId, prompt);
}
// ---------- tick ----------
function drop(db, sessionId) {
db.prepare('DELETE FROM scheduled_tasks WHERE session_id = ?').run(sessionId);
log.info('scheduler', sessionId + ' 删除定时任务(会话不存在)');
}
function tick() {
const db = eng.getDb();
const now = Date.now();
// 阶段 A:收尾上一轮标记 running 的任务。runLoop 结束没有回调可挂,改为轮询推断:
// 会话已转非 active = 回合结束 → ok(局限:异常结束的回合也会被标 ok)。
// 会话仍 active → AI 还在跑,保持 running 等下轮再看。
for (const t of db.prepare("SELECT session_id FROM scheduled_tasks WHERE last_status='running'").all()) {
const s = eng.getSession(t.session_id);
if (!s) { drop(db, t.session_id); continue; }
if (s.status !== 'active') {
db.prepare("UPDATE scheduled_tasks SET last_status='ok' WHERE session_id=?").run(t.session_id);
}
}
// 阶段 B:投递到期任务。上一轮还 running 的不取(等阶段 A 收尾);
// 会话本身 active 直接跳过本次——防堆积以会话状态为准,不依赖 DB 标记的时序,更可靠。
const due = db.prepare(
"SELECT * FROM scheduled_tasks WHERE next_run_at <= ? AND (last_status IS NULL OR last_status != 'running')"
).all(now);
for (const t of due) {
const s = eng.getSession(t.session_id);
if (!s) { drop(db, t.session_id); continue; } // CASCADE 正常已清行;手工删 sessions 行的兜底
if (s.status === 'active') {
db.prepare(
"UPDATE scheduled_tasks SET last_run_at=?, last_status='skipped', last_note='上一次仍在执行,跳过本次', next_run_at=? WHERE session_id=?"
).run(now, computeNext(t.cron_expr), t.session_id);
log.info('scheduler', t.session_id + ' 跳过本次(上一次仍在执行)');
continue;
}
try {
// 顺序不可调换:先存档、后投递。postUserMessage 的 held/空闲分支会同步起 runLoop,
// 存档晚一步,回合就会带着旧上下文开跑。
archiveHistory(db, t.session_id);
const r = deliver(t.session_id, t.prompt);
db.prepare(
"UPDATE scheduled_tasks SET last_run_at=?, last_status='running', last_note=NULL, next_run_at=? WHERE session_id=?"
).run(now, computeNext(t.cron_expr), t.session_id);
log.info('scheduler', t.session_id + ' 触发定时任务,投递 ' + (r && r.delivered || '?'));
} catch (err) {
db.prepare(
"UPDATE scheduled_tasks SET last_run_at=?, last_status='error', last_note=?, next_run_at=? WHERE session_id=?"
).run(now, String(err && err.message || err).slice(0, 200), computeNext(t.cron_expr), t.session_id);
log.error('scheduler', t.session_id + ' 定时任务失败: ' + (err && err.message || err));
}
}
}
function start(engine) {
if (timer) return;
eng = engine;
timer = setInterval(() => {
try {
tick();
} catch (e) {
log.error('scheduler', 'tick 异常: ' + (e && e.stack || e));
}
}, TICK_MS);
if (timer.unref) timer.unref(); // 不阻止进程退出
}
module.exports = { start, createTask, getTask, updateTask, deleteTask, computeNext, validateCron, fmtTime };