Files
agent/app/server/routes/sessions.js
T
kicer 7f8cf64e88 会话阶段状态机advising/executing(单会话单问题:先聊清再干活):新建会话与「清空」落advising——resolveProfileName两档化(phase=advising强制命中内置advising组合,否则随模型配置profile,tools_allow只留read_file/fetch/write_file、不带skill故模板无技能清单段,配advising-system.txt:问答判意图引导澄清、每轮至多1-2问防过度追问);唯一出口是任务书正门——runLoopInner工具批跑完后,advising回合内write_file/edit_file成功落任务目录根task.md(argsHitTaskBrief,上传同名与terminal间接创建不算;批量末尾统一切,防父assistant先存档后落库回执成孤儿行被上游拒收)即enterExecuting:全史标archived+插type=task_brief磁盘快照行作执行阶段唯一上下文起点+phase翻转与SSE phase广播,下一迭代重读历史重解profile天然切默认组合、同回合开工(幂等:执行中再改task.md只是普通编辑);回头路只有清空(archiveTaskBrief把旧task.md mv进.task-history/task-<ts>.md防污染新规划,点目录沿用.imgcache隐式约定);压缩对phase中性(压完回原模式,task_brief不豁免存档,漂移可控因压缩本就用户主导);定时投递前强制executing(无人值守不能被顾问话术卡住);db迁移存量phase回填executing零打扰、sessions.profile列废弃不读写;运行期手动切profile全拆(消息级参数/bind的profile分支/setSessionProfile与hasModelProfile/status的model_profiles名单/bind弹窗模式区),头部徽标机位复用为阶段徽标(仅advising显灯泡,SSE phase驱动,转执行toast反馈)
2026-09-25 11:54:20 +08:00

297 lines
14 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.1)
const express = require('express');
const fs = require('fs');
const path = require('path');
const engine = require('../engine');
const scheduler = require('../scheduler'); // 复用 validateCron(cron 可解析 + 间隔 ≥1h);scheduler 顶层不 require 路由,无循环引用
const log = require('../log');
const router = express.Router();
function wrap(fn) {
return function (req, res) {
try {
const r = fn(req, res);
if (r && typeof r.catch === 'function') {
r.catch(err => sendErr(res, err));
}
} catch (err) {
sendErr(res, err);
}
};
}
function sendErr(res, err) {
const code = err && err.status_code || 500;
res.status(code).json({ error: String(err && err.message || err) });
}
// 按需加载单条消息的完整内容(用于 tool 消息的懒加载)。
// 返回消息行原始 content(含 base64 图片),前端负责渲染。
function getMessage(req, res) {
const session = engine.getSession(req.params.id);
if (!session) return sendErr(res, Object.assign(new Error('会话不存在'), { status_code: 404 }));
const db = engine.getDb();
const row = db.prepare(
'SELECT id, role, content, reasoning, tool_calls, tool_call_id, name, type, is_error, created_at FROM messages WHERE id = ? AND session_id = ?'
).get(req.params.mid, req.params.id);
if (!row) return sendErr(res, Object.assign(new Error('消息不存在'), { status_code: 404 }));
res.json(row);
}
// 递归列出任务目录文件。opts.dirs=true 时额外输出目录标记行
//(filename 以 '/' 结尾 + dir:true),使不含任何文件的空夹子也能被前端展示。
function listTaskFiles(dir, opts) {
const wantDirs = !!(opts && opts.dirs);
const wantHidden = !!(opts && opts.hidden); // 勾选「显示隐藏文件」时连同 . 开头的文件/目录一起列(含 .imgcache)
const out = [];
(function rec(d, rel) {
let entries;
try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch (_) { return; }
for (const e of entries) {
if (!wantHidden && e.name.startsWith('.')) continue; // 默认隐藏点开头项(如 .imgcache/ 读图压缩产物缓存)
const abs = path.join(d, e.name);
const relPath = rel ? rel + '/' + e.name : e.name;
if (e.isDirectory()) {
if (wantDirs) out.push({ filename: relPath + '/', dir: true });
rec(abs, relPath);
}
else if (e.isFile()) {
let size = null, mtime = null, ctime = null;
// birthtime 在部分文件系统不可用(返回 0),回退 mtime;新生成/上传的文件两者基本一致
try {
const st = fs.statSync(abs);
size = st.size; mtime = st.mtimeMs;
ctime = (st.birthtimeMs && st.birthtimeMs > 0 ? st.birthtimeMs : st.mtimeMs) || null;
} catch (_) {}
out.push({ filename: relPath, size, mtime, ctime });
}
}
})(dir, '');
// 按创建时间倒序(最新在前)方便查找;同一时刻按文件名升序保证稳定
out.sort(function (a, b) {
const ca = a.ctime || a.mtime || 0, cb = b.ctime || b.mtime || 0;
if (cb !== ca) return cb - ca;
return a.filename < b.filename ? -1 : a.filename > b.filename ? 1 : 0;
});
return out;
}
router.post('/', wrap((req, res) => {
const title = (req.body && req.body.title || '').trim();
const modelId = (req.body && req.body.model_id || '').trim();
// 助手类型建档时锁定,后续不可变更;缺省按文秘助理
const assistantType = String((req.body && req.body.assistant_type) || 'secretary').trim().slice(0, 32) || 'secretary';
// 创建者取认证中间件的 req.user(不信客户端传参);未启用认证时为空串
const user = String(req.user || '').trim().slice(0, 64);
const session = engine.createSession(title, modelId, assistantType, user);
log.info('task', (req.user || '-') + ' 新建任务 ' + session.id + '「' + (session.title || '未命名') + '」model=' + (modelId || '自动') + ' type=' + (session.assistant_type || 'secretary'));
res.json(session);
}));
// 列表查询参数(2.0):
// status=active|done|all 归档分组:active=排队/活跃/保持,done=已完成/已终止
// q=关键词 标题或消息内容 LIKE 搜索
// before + before_id 游标分页(上一页末行的 updated_at,id),避免 offset 翻页在
// updated_at 变动时重复/漏行
// with_total=1 返回 {rows,total}(归档折叠区需要总数);默认仍返回纯数组
router.get('/', wrap((req, res) => {
const db = engine.getDb();
const status = String(req.query.status || 'all');
const q = String(req.query.q || '').trim();
let limit = parseInt(req.query.limit, 10);
if (!Number.isFinite(limit) || limit < 1) limit = 50;
if (limit > 200) limit = 200;
const where = [];
const args = [];
// 按创建者隔离:已登录只列自己的会话;未启用认证(req.user 空)不过滤,保持自用场景全可见
const me = String(req.user || '').trim();
if (me) { where.push('user = ?'); args.push(me); }
if (status === 'active') where.push("status IN ('queued','active','held')");
else if (status === 'done') where.push("status IN ('completed','cancelled')");
if (q) {
where.push('(title LIKE ? OR EXISTS(SELECT 1 FROM messages m WHERE m.session_id = sessions.id AND m.content LIKE ?))');
args.push('%' + q + '%', '%' + q + '%');
}
const before = req.query.before;
const beforeId = req.query.before_id;
if (before != null && before !== '' && beforeId) {
where.push('(updated_at < ? OR (updated_at = ? AND id < ?))');
args.push(String(before), String(before), String(beforeId));
}
const whereSql = where.length ? ' WHERE ' + where.join(' AND ') : '';
// has_schedule:侧边栏定时任务标记用,EXISTS 子查询单条搞定(非 N+1);schedule 详情仍只在单会话接口返回
const stmt = db.prepare(
'SELECT *, EXISTS(SELECT 1 FROM scheduled_tasks t WHERE t.session_id = sessions.id) AS has_schedule FROM sessions'
+ whereSql + ' ORDER BY updated_at DESC, id DESC LIMIT ?'
);
const rows = stmt.all.apply(stmt, args.concat([limit]));
const qpos = db.prepare(
'SELECT session_id, ROW_NUMBER() OVER (ORDER BY queued_at, id) AS pos FROM wait_queue'
).all();
const posMap = {};
for (const r of qpos) posMap[r.session_id] = r.pos;
for (const row of rows) {
row.queue_pos = row.status === 'queued' ? (posMap[row.id] || null) : null;
}
if (req.query.with_total === '1') {
const cnt = db.prepare('SELECT COUNT(*) AS n FROM sessions' + whereSql);
const total = cnt.all.apply(cnt, args)[0].n;
return res.json({ rows: rows, total: total });
}
res.json(rows);
}));
// assistant 消息附加 tool_call_msg_ids(tool_call.id → tool 消息行 id,让前端展开工具卡时知道去拉哪条消息)
function attachToolCallMap(row, toolCallMsgMap) {
if (row.role === 'assistant' && row.tool_calls) {
let toolCalls;
try { toolCalls = JSON.parse(row.tool_calls); } catch (_) { toolCalls = []; }
const tool_call_msg_ids = {};
for (const tc of toolCalls) {
if (tc && tc.id && toolCallMsgMap[tc.id]) {
tool_call_msg_ids[tc.id] = toolCallMsgMap[tc.id];
}
}
row.tool_call_msg_ids = Object.keys(tool_call_msg_ids).length ? tool_call_msg_ids : undefined;
}
return row;
}
const MSG_COLS = 'id, role, content, reasoning, tool_calls, tool_call_id, name, type, is_error, usage, created_at';
router.get('/:id', wrap((req, res) => {
const session = engine.getSession(req.params.id);
if (!session) return sendErr(res, Object.assign(new Error('会话不存在'), { status_code: 404 }));
const db = engine.getDb();
// tool_call_id → tool 消息行 id 映射:单独轻查询(只取 id),不随分页窗口截断,
// 保证分页边界处的 assistant 消息也能拿到自己 tool 行的懒加载映射
const toolCallMsgMap = {};
for (const r of db.prepare(
"SELECT id, tool_call_id FROM messages WHERE session_id = ? AND role = 'tool' AND tool_call_id IS NOT NULL AND tool_call_id != ''"
).all(session.id)) toolCallMsgMap[r.tool_call_id] = r.id;
// 历史懒加载:传 limit 只返回最近 limit 条非 tool 消息(tool 不单独展示,不计入),
// before 为行 id 游标(取 id < before 的更早一页);多取一条判断是否还有更早历史。
// 不传 limit 保持旧行为:返回全部消息。
let limit = parseInt(req.query.limit, 10);
limit = Number.isFinite(limit) && limit > 0 ? Math.min(limit, 500) : 0;
let hasMore = false;
let messages = [];
if (limit) {
const before = parseInt(req.query.before, 10);
const args = [session.id];
let sql = 'SELECT ' + MSG_COLS + " FROM messages WHERE session_id = ? AND role != 'tool'";
if (Number.isFinite(before) && before > 0) { sql += ' AND id < ?'; args.push(before); }
args.push(limit + 1);
// 注意:better-sqlite3 的 all 必须以 Statement 实例为 this 调用,不能脱离绑定
const stmt = db.prepare(sql + ' ORDER BY id DESC LIMIT ?');
let rows = stmt.all(...args);
hasMore = rows.length > limit;
if (hasMore) rows = rows.slice(0, limit);
rows.reverse(); // 还原时间升序
messages = rows.map(r => attachToolCallMap(r, toolCallMsgMap));
} else {
const allRows = db.prepare(
'SELECT ' + MSG_COLS + ' FROM messages WHERE session_id = ? ORDER BY id'
).all(session.id);
for (const row of allRows) {
if (row.role === 'tool') continue; // tool 结果不单独展示,由映射懒加载
messages.push(attachToolCallMap(row, toolCallMsgMap));
}
}
const taskDir = engine.taskDirOf(session.id);
// 定时任务状态(scheduler.js / schedule 工具;每会话至多一行,无则 null)。
// 列表接口故意不带此字段,避免 N+1;前端进会话详情时才拉。
const schedule = db.prepare(
'SELECT cron_expr, prompt, next_run_at, last_run_at, last_status, last_note FROM scheduled_tasks WHERE session_id = ?'
).get(session.id) || null;
res.json({
session,
messages,
files: listTaskFiles(taskDir),
schedule,
queue_pos: session.status === 'queued' ? engine.queuePosition(session.id) : null,
running: !!(engine.getRun(session.id) || {}).looping,
has_more: hasMore, // 分页模式下:是否还有更早的历史
oldest_id: messages.length ? messages[0].id : null, // 本页最早行 id,作为下一页 before 游标
});
}));
// 按需加载单条消息的完整内容(用于 tool 消息的懒加载)
router.get('/:id/messages/:mid', wrap(getMessage));
// 手动占用空闲模型(仅已结版/已终止可绑,见 bindToSession):状态栏「选择模型」弹窗发起。
// 曾有的 profile 会话模式绑定已废弃:profile 只由「阶段强制 + 模型配置默认」决定(见 engine.resolveProfileName)。
router.post('/:id/bind', wrap((req, res) => {
const mid = (req.body || {}).model_id;
if (mid === undefined || mid === null || String(mid).trim() === '') {
throw Object.assign(new Error('model_id 不能为空'), { status_code: 400 });
}
res.json(engine.bindToSession(req.params.id, mid));
}));
router.patch('/:id', wrap((req, res) => {
res.json(engine.renameSession(req.params.id, req.body && req.body.title));
}));
router.delete('/:id', wrap((req, res) => {
const delDir = req.query.delete_dir === 'true' || req.query.delete_dir === '';
log.info('task', (req.user || '-') + ' 删除任务 ' + req.params.id + (delDir ? '(含任务目录)' : ''));
res.json(engine.deleteSession(req.params.id, delDir));
}));
// 手动修改定时任务(会话详情 schedule 弹窗入口):提示词 + 频次(前端预设控件组合出的 cron,兼容自定义表达式)。
// cron 变化才重算 next_run_at(同样以 now 为基准);不插通知消息——每次触发前历史会被存档,
// AI 只看到投递的 prompt 本身,改完下次触发自然生效。
router.patch('/:id/schedule', wrap((req, res) => {
const db = engine.getDb();
const body = req.body || {};
const prompt = String(body.prompt || '').trim();
if (!prompt) throw Object.assign(new Error('提示词不能为空'), { status_code: 400 });
if (prompt.length > 20000) throw Object.assign(new Error('提示词过长(上限 20000 字符)'), { status_code: 400 });
const t = db.prepare('SELECT cron_expr FROM scheduled_tasks WHERE session_id = ?').get(req.params.id);
if (!t) throw Object.assign(new Error('本会话没有定时任务'), { status_code: 404 });
const cron = String(body.cron_expr || '').trim();
if (cron && cron !== t.cron_expr) {
let nextAt;
try {
nextAt = scheduler.validateCron(cron);
} catch (e) {
throw Object.assign(new Error(e.message), { status_code: 400 });
}
db.prepare('UPDATE scheduled_tasks SET prompt = ?, cron_expr = ?, next_run_at = ? WHERE session_id = ?')
.run(prompt, cron, nextAt, req.params.id);
log.info('scheduler', req.params.id + ' 定时任务改为 ' + cron + '(原 ' + t.cron_expr + ')');
} else {
db.prepare('UPDATE scheduled_tasks SET prompt = ? WHERE session_id = ?').run(prompt, req.params.id);
log.info('scheduler', req.params.id + ' 更新定时任务提示词');
}
res.json({ ok: true });
}));
// 手动删除定时任务(创建只经 AI 工具;频次/提示词可在弹窗内改)。
// 通知消息只 saveMessage 落库,不走 postUserMessage:不触发 AI 运行。
// 删会话无需此处:scheduled_tasks 随 sessions 行 ON DELETE CASCADE 自动清理。
router.delete('/:id/schedule', wrap((req, res) => {
const db = engine.getDb();
const t = db.prepare('SELECT cron_expr FROM scheduled_tasks WHERE session_id = ?').get(req.params.id);
if (!t) throw Object.assign(new Error('本会话没有定时任务'), { status_code: 404 });
db.prepare('DELETE FROM scheduled_tasks WHERE session_id = ?').run(req.params.id);
engine.saveMessage(req.params.id, {
role: 'user',
content: '[系统] 定时任务已删除(原定 ' + t.cron_expr + ')',
type: 'scheduler_note',
});
log.info('scheduler', req.params.id + ' 删除定时任务 ' + t.cron_expr);
res.json({ ok: true });
}));
module.exports = router;
module.exports.listTaskFiles = listTaskFiles;