新增 /api/channel/send 文本命令接入端:/new /stop /compact /clear /status /help + (user,channel) 当前会话绑定(channel_sessions 表,懒自愈)
This commit is contained in:
@@ -105,6 +105,17 @@ function initDb(dbPath) {
|
||||
|
||||
CREATE INDEX IF NOT EXISTS idx_sched_next ON scheduled_tasks(next_run_at);
|
||||
|
||||
-- 文本命令接入端(channel)的「当前会话」绑定(routes/channel.js):接入端没有会话列表 UI,
|
||||
-- 每个 (user, channel) 记一个当前会话,普通消息与 /new 等命令都作用于它。
|
||||
-- 故意不建外键:删会话后绑定行由 channel 层懒解析自愈(查不到会话即清行按未绑定处理)。
|
||||
CREATE TABLE IF NOT EXISTS channel_sessions (
|
||||
user TEXT NOT NULL,
|
||||
channel TEXT NOT NULL DEFAULT '',
|
||||
session_id TEXT NOT NULL,
|
||||
updated_at INTEGER NOT NULL,
|
||||
PRIMARY KEY (user, channel)
|
||||
);
|
||||
|
||||
-- 模型 token 用量流水(每次模型回合一条)。故意不建会话外键:
|
||||
-- 删会话后累计统计仍需保留
|
||||
CREATE TABLE IF NOT EXISTS model_usage (
|
||||
|
||||
@@ -0,0 +1,200 @@
|
||||
// 文本命令接入端(channel)API:给没有可点击 UI 的端(IM 桥、CLI 等)提供会话内操作的文字入口。
|
||||
// 设计(docs/ARCHITECTURE.md §4.1/§7):
|
||||
// - 命令只在 /api/channel/send 解析,不进普通消息路由——Web 上以斜杠开头的文本照常发给模型。
|
||||
// 命令是无 UI 端的按钮替代品,不是全局协议(防误伤路径/代码讨论这类合法文本)。
|
||||
// - 每个 (user, channel) 记一个「当前会话」(channel_sessions 表):接入端没有会话列表 UI,
|
||||
// 普通消息与命令都路由到它;/new 新建并换绑,旧会话不打断、按自己状态自然走完。
|
||||
// - 数据面零特殊:全部走 engine 既有函数(同一张 sessions/messages 表、同一 SSE),
|
||||
// Web 端打开这些会话与普通会话无差别。
|
||||
// - 命令动作本身不落消息行(与 Web 点「终止」按钮不产生消息对称);
|
||||
// /new 尾随文本与普通消息是真实内容,照常入库。
|
||||
const express = require('express');
|
||||
const engine = require('../engine');
|
||||
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) });
|
||||
}
|
||||
|
||||
// ---------- 当前会话绑定 ----------
|
||||
// 懒自愈:绑定指向的会话已被删除 → 清行按未绑定处理(下一条消息自动新建),不建外键就是为这个。
|
||||
function boundSession(db, user, channel) {
|
||||
const row = db.prepare('SELECT session_id FROM channel_sessions WHERE user = ? AND channel = ?').get(user, channel);
|
||||
if (!row) return null;
|
||||
const s = engine.getSession(row.session_id);
|
||||
if (s) return s;
|
||||
db.prepare('DELETE FROM channel_sessions WHERE user = ? AND channel = ?').run(user, channel);
|
||||
return null;
|
||||
}
|
||||
|
||||
function setBinding(db, user, channel, sessionId) {
|
||||
db.prepare(
|
||||
'INSERT INTO channel_sessions (user, channel, session_id, updated_at) VALUES (?,?,?,?)'
|
||||
+ ' ON CONFLICT(user, channel) DO UPDATE SET session_id = excluded.session_id, updated_at = excluded.updated_at'
|
||||
).run(user, channel, sessionId, Date.now());
|
||||
}
|
||||
|
||||
// /new 与「无绑定时发普通消息」共用:新建(engine 立即绑模型,空池 503 冒泡)+ 换绑 + 可选首条消息
|
||||
function newSessionFor(db, user, channel, firstText) {
|
||||
const s = engine.createSession('', '', 'secretary', user);
|
||||
setBinding(db, user, channel, s.id);
|
||||
const sent = firstText ? engine.postUserMessage(s.id, firstText) : null;
|
||||
return { s, sent };
|
||||
}
|
||||
|
||||
// ---------- 命令解析 ----------
|
||||
// 严格匹配:整条消息恰好是命令词(仅 /new 可带尾随文本)才算命令。
|
||||
// 首词形如 /纯ASCII词 但不在清单 → 回「未知命令」提示、不转发模型(防弱模型就着 /hlep 演一段);
|
||||
// 其余一律普通消息:/home/x、/a.b 这类路径代码,以及 /clear abc 这种带尾巴的(用户约定:强检查不匹配)。
|
||||
const CMDS = new Set(['new', 'stop', 'compact', 'clear', 'status', 'help']);
|
||||
|
||||
function parseCommand(text) {
|
||||
const t = String(text || '').trim();
|
||||
if (t[0] !== '/') return null;
|
||||
const sp = t.search(/\s/);
|
||||
const head = (sp < 0 ? t.slice(1) : t.slice(1, sp)).toLowerCase();
|
||||
const rest = sp < 0 ? '' : t.slice(sp + 1).trim();
|
||||
if (!/^[a-z][a-z0-9_-]*$/.test(head)) return { normal: true };
|
||||
if (!CMDS.has(head)) return { unknown: head };
|
||||
if (rest && head !== 'new') return { normal: true };
|
||||
return { cmd: head, rest };
|
||||
}
|
||||
|
||||
const HELP_TEXT = [
|
||||
'可用命令:',
|
||||
'/new [文本] 新建会话并切换(带文本则作为首条消息直接开跑;不打断旧会话正在跑的回合)',
|
||||
'/stop 终止当前回合',
|
||||
'/compact 压缩上下文(摘要稍后作为一条回复出现在会话里)',
|
||||
'/clear 清空当前会话(回到顾问模式,会话继续用)',
|
||||
'/status 查看当前会话状态',
|
||||
'/help 显示本帮助',
|
||||
].join('\n');
|
||||
|
||||
const STATUS_TEXT = { active: '活跃中', held: '保持中', completed: '已完成', cancelled: '已终止' };
|
||||
const PHASE_TEXT = { advising: '顾问', executing: '执行' };
|
||||
|
||||
function fmtTime(ts) {
|
||||
if (!ts) return '--';
|
||||
const d = new Date(ts);
|
||||
const pad = n => String(n).padStart(2, '0');
|
||||
return (d.getMonth() + 1) + '-' + pad(d.getDate()) + ' ' + pad(d.getHours()) + ':' + pad(d.getMinutes());
|
||||
}
|
||||
|
||||
function statusReply(db, s) {
|
||||
const run = engine.getRun(s.id);
|
||||
const looping = !!(run && run.looping);
|
||||
const lines = [
|
||||
'会话 ' + s.id + '「' + (s.title || '未命名') + '」',
|
||||
'状态:' + (looping ? '回合进行中' : (STATUS_TEXT[s.status] || s.status))
|
||||
+ '|阶段:' + (PHASE_TEXT[s.phase] || s.phase || '-'),
|
||||
'模型:' + (s.model_id || '未绑定'),
|
||||
];
|
||||
const t = db.prepare('SELECT cron_expr, next_run_at, last_run_at, last_status FROM scheduled_tasks WHERE session_id = ?').get(s.id);
|
||||
lines.push(t
|
||||
? '定时任务:cron「' + t.cron_expr + '」下次 ' + fmtTime(t.next_run_at) + '(上次 ' + fmtTime(t.last_run_at) + ' ' + (t.last_status || '-') + ')'
|
||||
: '定时任务:无');
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
// ---------- 入口 ----------
|
||||
// POST /api/channel/send {channel?, text} → {kind, reply, session_id, message_id?}
|
||||
// - kind='message':普通消息已入会话开跑;kind='command':reply 即命令回执(纯文本,IM 直接转发)。
|
||||
// - AI 的正式回复不在本接口返回:接入端复用 SSE GET /api/sessions/:id/stream 或轮询会话详情。
|
||||
// - 引擎主动拒绝的(回合进行中点压缩/清空)走 HTTP 4xx {error},语义与 Web 路由一致。
|
||||
router.post('/send', wrap((req, res) => {
|
||||
const db = engine.getDb();
|
||||
const user = String(req.user || '').trim().slice(0, 64); // 认证用户;未开认证为空串(自用单用户)
|
||||
const channel = String((req.body || {}).channel || '').trim().slice(0, 64);
|
||||
const text = String((req.body || {}).text || '').trim();
|
||||
if (!text) throw Object.assign(new Error('text 不能为空'), { status_code: 400 });
|
||||
const tag = (user || '-') + ' [' + (channel || 'default') + ']';
|
||||
|
||||
const parsed = parseCommand(text);
|
||||
|
||||
// 普通消息:解析当前会话,无绑定自动新建(IM 用户不会先打 /new 才能聊天)
|
||||
if (!parsed || parsed.normal) {
|
||||
let s = boundSession(db, user, channel);
|
||||
let sent;
|
||||
if (!s) {
|
||||
const r = newSessionFor(db, user, channel, text);
|
||||
s = r.s; sent = r.sent;
|
||||
} else {
|
||||
sent = engine.postUserMessage(s.id, text);
|
||||
}
|
||||
log.info('msg', tag + ' channel 消息 → ' + s.id);
|
||||
return res.json({ kind: 'message', reply: '已发送到会话 ' + s.id, session_id: s.id, message_id: sent.message_id });
|
||||
}
|
||||
|
||||
if (parsed.unknown) {
|
||||
const s = boundSession(db, user, channel);
|
||||
return res.json({ kind: 'command', reply: '/' + parsed.unknown + ' 不是有效命令,发送 /help 查看清单', session_id: s ? s.id : null });
|
||||
}
|
||||
|
||||
const cmd = parsed.cmd;
|
||||
|
||||
if (cmd === 'help') {
|
||||
const s = boundSession(db, user, channel);
|
||||
return res.json({ kind: 'command', reply: HELP_TEXT, session_id: s ? s.id : null });
|
||||
}
|
||||
|
||||
if (cmd === 'new') {
|
||||
const r = newSessionFor(db, user, channel, parsed.rest);
|
||||
log.info('task', tag + ' channel /new → ' + r.s.id + (parsed.rest ? '(含首条消息)' : ''));
|
||||
return res.json({
|
||||
kind: 'command',
|
||||
reply: '已新建会话 ' + r.s.id + (parsed.rest ? ',首条消息已发出' : '(发普通消息或 /status 查看状态)'),
|
||||
session_id: r.s.id,
|
||||
message_id: r.sent ? r.sent.message_id : undefined,
|
||||
});
|
||||
}
|
||||
|
||||
// 其余命令都作用于当前会话;无绑定时不隐式新建(那不是用户点这条命令的意图)
|
||||
const s = boundSession(db, user, channel);
|
||||
if (!s) {
|
||||
return res.json({ kind: 'command', reply: '当前没有会话(先 /new,或直接发一条普通消息自动新建)', session_id: null });
|
||||
}
|
||||
|
||||
if (cmd === 'stop') {
|
||||
// 与 Web 按钮语义对齐:只有回合真在跑才停,idle 不误伤(stop 会把 held 刷成 cancelled)
|
||||
const run = engine.getRun(s.id);
|
||||
if (!(run && run.looping)) {
|
||||
return res.json({ kind: 'command', reply: '当前没有进行中的回合(无需终止)', session_id: s.id });
|
||||
}
|
||||
engine.stop(s.id);
|
||||
log.info('msg', tag + ' channel /stop ' + s.id);
|
||||
return res.json({ kind: 'command', reply: '已发送终止指令,回合收尾中', session_id: s.id });
|
||||
}
|
||||
|
||||
if (cmd === 'compact') {
|
||||
engine.summarizeContext(s.id); // 回合进行中 engine 抛 409(请先终止),冒给调用方
|
||||
log.info('msg', tag + ' channel /compact ' + s.id);
|
||||
return res.json({ kind: 'command', reply: '已发起上下文压缩,摘要稍后会作为一条回复出现在会话里', session_id: s.id });
|
||||
}
|
||||
|
||||
if (cmd === 'clear') {
|
||||
engine.clearSessionMessages(s.id); // 同上,回合进行中 409
|
||||
log.info('msg', tag + ' channel /clear ' + s.id);
|
||||
return res.json({ kind: 'command', reply: '已清空当前会话(回到顾问模式),继续发消息即从零开始', session_id: s.id });
|
||||
}
|
||||
|
||||
// cmd === 'status'
|
||||
return res.json({ kind: 'command', reply: statusReply(db, s), session_id: s.id });
|
||||
}));
|
||||
|
||||
module.exports = router;
|
||||
@@ -22,8 +22,8 @@ const bus = createBus();
|
||||
|
||||
engine.setModelPool(cfg, db, bus);
|
||||
engine.init();
|
||||
// 定时任务调度器(scheduler.js):必须在 engine.init() 之后启动——init 先把 active
|
||||
// 退回队列 / held 结版归位,首轮 tick 才不会看到脏状态。
|
||||
// 定时任务调度器(scheduler.js):必须在 engine.init() 之后启动——init 先把会话状态归位
|
||||
//(active/遗留 queued → held),首轮 tick 才不会看到脏状态。
|
||||
scheduler.start(engine);
|
||||
|
||||
const app = express();
|
||||
@@ -53,13 +53,15 @@ app.use('/api/platforms', require('./routes/platforms'));
|
||||
app.use('/api/system', require('./routes/system'));
|
||||
// 用户画像(账户设置):读写按登录用户隔离,逻辑在 user-profile.js
|
||||
app.use('/api/profile', require('./routes/profile'));
|
||||
// 文本命令接入端(IM/CLI 等无 UI 客户端):命令解析 + (user, channel) 当前会话绑定,见 routes/channel.js
|
||||
app.use('/api/channel', require('./routes/channel'));
|
||||
// data-page 技能配套:任务 app/ 子树页面向导 /app/{task_id}/ + 数据 API /api/db/{task_id}/query。
|
||||
// 随其余业务路由一样挂在 auth.middleware 之后(登录态才能访问)。
|
||||
app.use(require('./routes/data-page'));
|
||||
|
||||
// 模型池状态(前端可展示空闲/占用)+ 每模型 token 用量(今日/累计,输入/输出分开)。
|
||||
// 模型池状态(前端展示在用会话数/在用会话列表,key 非独占)+ 每模型 token 用量(今日/累计,输入/输出分开)。
|
||||
// 从生效配置补齐平台维度字段(platform/mid/vision/type + 平台 key 数 key_count):
|
||||
// model_pool 表只有 id/display_name/占用态,会话页「选择模型」弹窗需要按平台分组展示。
|
||||
// model_pool 表只有 id/display_name/last_used_at,会话页「选择模型」弹窗需要按平台分组展示。
|
||||
// 配置里新增但重启前未进池的模型不在此返回(池才是运行时真相)。
|
||||
app.get('/api/models', (req, res) => {
|
||||
// 池行是平台物理 key(id=「平台#下标」):key 为共享资源——非独占,多个会话可同时绑同一个 key
|
||||
|
||||
@@ -51,6 +51,7 @@ agent/
|
||||
│ │ │ ├── sessions.js /api/sessions CRUD + 列表分页
|
||||
│ │ │ ├── messages.js /api/sessions/:id/messages + SSE 流 + stop/release
|
||||
│ │ │ ├── files.js /api/sessions/:id/files 上传/列表/下载/删除
|
||||
│ │ │ ├── channel.js /api/channel/send 文本命令接入(IM/CLI 等无 UI 端;当前会话绑定 + /new /stop /compact /clear /status /help)
|
||||
│ │ │ ├── config.js /api/config 读写(含 api_key/password 脱敏)
|
||||
│ │ │ ├── platforms.js /api/platforms/balance 余额查询
|
||||
│ │ │ ├── skills.js /api/skills 技能文件管理
|
||||
@@ -147,7 +148,7 @@ graph LR
|
||||
5. `engine.setModelPool(cfg, db, bus); engine.init()`:按 cfg.models 重建 `model_pool` 槽位表;会话状态归位(active/遗留 queued → held,绑定不清);指向已删/禁用模型的绑定在下次发言时由 `ensureBinding` 自动改选。
|
||||
6. `scheduler.start(engine)`:启动定时任务轮询(30s 一次,`unref`)。**必须在 engine.init() 之后**——先让会话状态归位,首轮 tick 才看不到脏状态(见 §5.12)。
|
||||
7. `createAuth(cfg)` 装配登录中间件;未配 `auth.users` 则认证关闭(可交给前置 nginx-proxy basic auth)。
|
||||
8. `express.static(public)` + 路由挂载(`/api/sessions`、`/api/skills`、`/api/config`、`/api/platforms`、`/api/system`)。
|
||||
8. `express.static(public)` + 路由挂载(`/api/sessions`、`/api/skills`、`/api/config`、`/api/platforms`、`/api/system`、`/api/channel`)。
|
||||
9. `mcp.init(cfg).then(...)`:对每个 MCP 服务 initialize → tools/list,发现的工具存在 `mcp` 模块内。
|
||||
10. `skills.listSkills(...)` → `llm.setSkillListText(...)` 快照注入 system prompt(`llm.js`)。
|
||||
11. `server.listen(PORT)`,打 startup 行:workspace_root / data_root / models / mcp_servers / auth / log_level。
|
||||
@@ -197,6 +198,11 @@ scheduled_tasks session_id PK (FK sessions, ON DELETE CASCADE) / cron_expr /
|
||||
# 定时任务:每会话至多一个(session_id 主键兼防重),按 next_run_at 索引;
|
||||
# 创建只经 AI 工具 schedule;频次/提示词可在会话详情弹窗改(PATCH /:id/schedule,
|
||||
# 改频次后端重校验并重算 next_run_at);删除走 CASCADE 或 DELETE /:id/schedule(见 §5.12)
|
||||
|
||||
channel_sessions user + channel 复合 PK / session_id / updated_at
|
||||
# 文本命令接入端(routes/channel.js)的「当前会话」映射:接入端无会话列表 UI,
|
||||
# 普通消息与 /new 等命令都路由到绑定的会话;无外键,删会话后懒解析自愈;
|
||||
# /api/channel/send 是唯一读写方,Web 路由不碰这张表
|
||||
```
|
||||
|
||||
**session.status 状态机**(`engine.js`,无排队版):
|
||||
@@ -456,6 +462,7 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks`
|
||||
| `/api/platforms` | `routes/platforms.js` | `GET /balance?pi=&ki=` 余额 |
|
||||
| `/api/system` | `routes/system.js` | `GET /status` + `/restart?force=...`(原 `model_profiles` 可用名单字段已删,前端无消费方) |
|
||||
| `/api/profile` | `routes/profile.js` | `GET /` 读画像、`PUT /` 保存(三字段 + enabled);按 `req.user` 隔离,逻辑全在 `user-profile.js`(快照冻结见 engine `createSession`/`clearSessionMessages`,提取见 `enterExecuting`) |
|
||||
| `/api/channel` | `routes/channel.js` | `POST /send {channel, text}` 文本命令接入端(IM/CLI 等无 UI 客户端,走 Basic/cookie 鉴权):命令仅在本入口解析(Web 消息路由不受影响,防误伤路径/代码文本);严格匹配白名单 `/new[文本] /stop /compact /clear /status /help`,未知斜杠词回提示、不像命令的当普通消息;(user,channel) 经 `channel_sessions` 表绑定当前会话(普通消息无绑定自动建);命令动作不落消息行(与 Web 按钮对称),AI 回复由接入端复用既有 SSE/详情接口获取 |
|
||||
| `/api/models` | `server.js` | 模型池(在用会话数 slots_used / 在用会话列表,非独占展示)+ token 用量 |
|
||||
| `/api/health` | `server.js` | 健康检查 |
|
||||
| `/api/login` `/api/login_restore` `/api/logout` `/api/password` `/api/me` | `auth.js` | 认证路由(认证前) |
|
||||
|
||||
Reference in New Issue
Block a user