// 文本命令接入端(channel)API:给没有可点击 UI 的端(IM 桥、CLI 等)提供会话内操作的文字入口。 // 设计(docs/ARCHITECTURE.md §4.1/§7): // - 命令只在 /api/channel/send 解析,不进普通消息路由——Web 上以斜杠开头的文本照常发给模型。 // 命令是无 UI 端的按钮替代品,不是全局协议(防误伤路径/代码讨论这类合法文本)。 // - 每个 (user, channel) 记一个「当前会话」(channel_sessions 表):接入端没有会话列表 UI, // 普通消息与命令都路由到它;/new /switch 换绑,旧会话不打断、按自己状态自然走完; // /list /rename /delete /models 覆盖 Web 端其余管理操作(同 engine 函数,数据面零特殊)。 // - 数据面零特殊:全部走 engine 既有函数(同一张 sessions/messages 表、同一 SSE), // Web 端打开这些会话与普通会话无差别。 // - 命令动作本身不落消息行(与 Web 点「终止」按钮不产生消息对称); // /new 尾随文本与普通消息是真实内容,照常入库。 const express = require('express'); const engine = require('../engine'); const scheduler = require('../scheduler'); // 只依赖 log/cron-parser,无环;/tasks 与 schedule op=list_all 同源 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 }; } // 解析 (user,channel) 的当前会话,无绑定则新建并绑定(不发消息)—— // 微信图片入口需要先拿到会话才能落任务目录文件,随后再走 handleSend 拼告知行。 function ensureSession(db, user, channel) { return boundSession(db, user, channel) || newSessionFor(db, user, channel, '').s; } // ---------- 会话列表与编号(/list /switch /delete) ---------- // 编号 = 本列表行号,最近更新在前(排序与用户隔离同 Web 会话列表 GET /api/sessions 一致)。 // 列表是动态的:switch/delete 回执复述目标标题,中间恰好有人新建/删除时用户能发现编号指错了对象。 // 命令回执占 1 条微信回复额度:截 10 行,更早的会话留给网页端管理。 const LIST_LIMIT = 10; function listedSessions(db, user) { const me = String(user || '').trim(); const where = me ? ' WHERE user = ?' : ''; const args = me ? [me] : []; const rows = db.prepare( 'SELECT id, title, model_id, status, updated_at FROM sessions' + where + ' ORDER BY updated_at DESC, id DESC LIMIT ?' ).all(...args, LIST_LIMIT); const total = db.prepare('SELECT COUNT(*) AS n FROM sessions' + where).get(...args).n; return { rows: rows, total: total }; } // 参数解析:纯数字 = /list 编号;否则按会话 id 前缀在列表内匹配(task-20260928-3 比记编号省事)。 function pickSession(rows, arg) { if (/^\d+$/.test(arg)) { const n = parseInt(arg, 10); return n >= 1 && n <= rows.length ? rows[n - 1] : null; } const hit = rows.filter(r => String(r.id).startsWith(arg)); return hit.length === 1 ? hit[0] : null; } function shortTitle(r) { const t = String(r.title || '').trim() || '未命名'; return t.length > 24 ? t.slice(0, 24) + '…' : t; } function listReply(db, user, curId) { const res = listedSessions(db, user); const rows = res.rows; if (!rows.length) return '**会话列表**\n还没有会话:直接发条消息会自动新建'; const lines = rows.map((r, i) => { const line = '- ' + (i + 1) + '. `' + shortTitle(r) + '` · ' + (r.model_id || '未绑模型') + ' · ' + (STATUS_TEXT[r.status] || r.status) + ' · ' + fmtTime(r.updated_at); return line + (r.id === curId ? ' [当前]' : ''); }); lines.push(res.total > rows.length ? '共 ' + res.total + ' 个会话,只列最近 ' + rows.length + ' 个' : '用 /switch <编号> 切换,/delete <编号> 删除'); return ['**会话列表**'].concat(lines).join('\n'); } // 定时任务全览(/tasks):跨会话列出本用户的周期任务(schedule op=list_all 同源数据)。 // 生命周期绑会话不拆:每行尾部标出会话 id,改删先 /switch 过去再让 AI 操作(与 /list 编号同源)。 function tasksReply(db, user, curId) { const rows = scheduler.listUserTasks(db, user); if (!rows.length) return '**定时任务**\n还没有任何定时任务(聊天里让 AI 设个闹钟即可)'; const lines = rows.map(t => { const last = t.last_run_at ? fmtTime(t.last_run_at) + ' ' + (t.last_status || '-') : '尚未执行'; return '- `' + (t.brief || String(t.prompt).slice(0, 24) + '…') + '` · cron `' + t.cron_expr + '` · 下次 ' + fmtTime(t.next_run_at) + ' · 上次 ' + last + (t.session_id === curId ? '(本会话)' : '|会话 `' + t.session_id + '`'); }); lines.push('修改/取消:先 /switch 到对应会话,再让 AI 处理;删会话会连带删它的任务'); return ['**定时任务**'].concat(lines).join('\n'); } // ---------- 模型清单(/models) ---------- // cfg.models 按 key 展开(同平台多 key 每个模型重复多份),按 id 去重保配置序; // enable:false 不列(bind 会被 engine 拒,列出来只会诱导白点)。上限 15 行,同样为回执占额度。 const MODELS_LIMIT = 15; function modelChoices() { const seen = new Set(); const out = []; for (const m of (engine.getConfig() || {}).models || []) { if (m.enable === false || seen.has(m.id)) continue; seen.add(m.id); out.push(m); } return out; } function modelsReply(ms, curModelId) { if (!ms.length) return '**模型清单**\n配置里没有启用的模型(网页端设置页添加后重启)'; const shown = ms.slice(0, MODELS_LIMIT); const lines = shown.map((m, i) => '- ' + (i + 1) + '. `' + m.id + '`' + (m.vision ? ' · 支持读图' : '') + (m.id === curModelId ? ' [当前]' : '')); if (ms.length > shown.length) lines.push('共 ' + ms.length + ' 个,只列前 ' + MODELS_LIMIT + ' 个'); lines.push('用 /models <编号> 给当前会话换模型'); return ['**模型清单**'].concat(lines).join('\n'); } // ---------- 命令解析 ---------- // 严格匹配:整条消息恰好是命令词(ARG_CMDS 内的可带参数)才算命令。 // 首词形如 /纯ASCII词 但不在清单 → 回「未知命令」提示、不转发模型(防弱模型就着 /hlep 演一段); // 其余一律普通消息:/home/x、/a.b 这类路径代码,以及 /clear abc 这种裸命令带尾巴的(用户约定:强检查不匹配)。 const CMDS = new Set(['new', 'stop', 'compact', 'clear', 'status', 'help', 'list', 'tasks', 'switch', 'rename', 'delete', 'models']); // 可带参数的命令:/new 尾随文本作首条消息;/switch /delete 吃 /list 编号(或会话 id 前缀); // /rename 吃新标题;/models 可带模型编号或完整 id。清单外的命令带尾巴仍按普通消息回落。 const ARG_CMDS = new Set(['new', 'switch', 'rename', 'delete', 'models']); 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 && !ARG_CMDS.has(head)) return { normal: true }; return { cmd: head, rest }; } // 命令输出统一用 markdown(channel 层的规范格式):支持渲染的接入端直接用, // 微信端渲染适配在 wxbot 出口:默认透传 markdown(微信已支持渲染),env WXBOT_STRIP_MARKDOWN=1 才 stripMarkdown 纯文化——格式信息留在生产方,渲染适配在消费方。 const HELP_TEXT = [ '**可用命令**', '- `/new [msg]` 新建会话并切换', '- `/list` 会话列表', '- `/tasks` 定时任务全览', '- `/switch <编号>` 切换当前会话', '- `/rename <标题>` 重命名当前会话', '- `/delete <编号>` 删除指定会话', '- `/models [编号]` 切换指定模型', '- `/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.title || s.id) + '`', '- 状态:' + (looping ? '回合进行中' : (STATUS_TEXT[s.status] || s.status)), '- 模型:`' + (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'); } // ---------- 入口 ---------- // 命令主流程:Web 接入(POST /api/channel/send)与微信桥接(wechat.js 直调)共用同一函数, // 命令表/会话绑定/自动建会话只有一份实现;来源差异(日志前缀 tag、身份解析)由调用方注入。 // 返回 {kind, reply, session_id, message_id?};引擎拒绝的(回合进行中压缩/清空)抛 {status_code},由调用方映射。 function handleSend(db, opts) { const user = String(opts.user || '').trim().slice(0, 64); const channel = String(opts.channel || '').trim().slice(0, 64); const text = String(opts.text || '').trim(); if (!text) throw Object.assign(new Error('text 不能为空'), { status_code: 400 }); const tag = opts.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 { kind: 'message', reply: '已发送到会话 ' + s.id, session_id: s.id, message_id: sent.message_id }; } if (parsed.unknown) { const u = boundSession(db, user, channel); return { kind: 'command', reply: '/' + parsed.unknown + ' 不是有效命令,发送 /help 查看清单', session_id: u ? u.id : null }; } const cmd = parsed.cmd; // 当前绑定会话:list/switch/delete 不依赖它(列表操作面向全部会话,switch 本身就是换绑), // 其余命令作用于它;help/new 只用它回 session_id。 const s = boundSession(db, user, channel); if (cmd === 'help') { return { 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 { kind: 'command', reply: '已新建会话 ' + r.s.id + (parsed.rest ? ',首条消息已发出' : '(发普通消息或 /status 查看状态)'), session_id: r.s.id, message_id: r.sent ? r.sent.message_id : undefined, }; } if (cmd === 'list') { return { kind: 'command', reply: listReply(db, user, s ? s.id : null), session_id: s ? s.id : null }; } if (cmd === 'tasks') { return { kind: 'command', reply: tasksReply(db, user, s ? s.id : null), session_id: s ? s.id : null }; } if (cmd === 'switch') { if (!parsed.rest) { return { kind: 'command', reply: '用法:/list 查看编号,再 /switch <编号>', session_id: s ? s.id : null }; } const t = pickSession(listedSessions(db, user).rows, parsed.rest); if (!t) { return { kind: 'command', reply: '没找到 ' + parsed.rest + ' 对应的会话(编号以最新的 /list 为准)', session_id: s ? s.id : null }; } if (s && s.id === t.id) { return { kind: 'command', reply: '当前就是会话「' + shortTitle(t) + '」', session_id: t.id }; } setBinding(db, user, channel, t.id); log.info('task', tag + ' channel /switch → ' + t.id); return { kind: 'command', reply: '已切到会话「' + shortTitle(t) + '」(' + (STATUS_TEXT[t.status] || t.status) + ' · ' + fmtTime(t.updated_at) + ')', session_id: t.id }; } if (cmd === 'delete') { if (!parsed.rest) { return { kind: 'command', reply: '用法:/list 查看编号,再 /delete <编号>', session_id: s ? s.id : null }; } const t = pickSession(listedSessions(db, user).rows, parsed.rest); if (!t) { return { kind: 'command', reply: '没找到 ' + parsed.rest + ' 对应的会话(编号以最新的 /list 为准)', session_id: s ? s.id : null }; } engine.deleteSession(t.id, true); // 同 Web 默认(删除弹窗「同时删除任务文件夹」预勾选):IM 没有二次确认 UI,对齐默认语义 const wasCur = s && s.id === t.id; if (wasCur) db.prepare('DELETE FROM channel_sessions WHERE user = ? AND channel = ?').run(user, channel); log.info('task', tag + ' channel /delete ' + t.id + '(含任务目录)' + (wasCur ? '(当前会话,已解绑)' : '')); return { kind: 'command', reply: '已删除会话「' + shortTitle(t) + '」(连同任务目录,不可恢复)' + (wasCur ? ',下次发消息自动新建会话' : ''), session_id: wasCur ? null : (s ? s.id : null) }; } // 裸 /models 只是看清单,不要求已有会话;带编号的在下面换绑分支里(需当前会话) if (cmd === 'models' && !parsed.rest) { return { kind: 'command', reply: modelsReply(modelChoices(), s ? s.model_id : ''), session_id: s ? s.id : null }; } // 其余命令都作用于当前会话;无绑定时不隐式新建(那不是用户点这条命令的意图) if (!s) { return { kind: 'command', reply: '当前没有会话,请直接发送消息', session_id: null }; } if (cmd === 'rename') { if (!parsed.rest) { return { kind: 'command', reply: '用法:/rename <标题>', session_id: s.id }; } const r = engine.renameSession(s.id, parsed.rest); // 空/超长/不存在校验与 Web 同源,400/404 冒给调用方 log.info('task', tag + ' channel /rename ' + s.id + ' → 「' + r.title + '」'); return { kind: 'command', reply: '已改名为「' + r.title + '」', session_id: s.id }; } if (cmd === 'models') { const ms = modelChoices(); // 编号或完整 id(如 deepseek/deepseek-flash)都认 const m = /^\d+$/.test(parsed.rest) ? ms[parseInt(parsed.rest, 10) - 1] : ms.find(x => x.id === parsed.rest); if (!m) { return { kind: 'command', reply: '没有 ' + parsed.rest + ' 对应的模型(/models 查看清单)', session_id: s.id }; } engine.bindToSession(s.id, m.id); // 与 Web 换绑弹窗同源:回合进行中/平台无 key 的 409 冒给调用方 log.info('model', tag + ' channel /models ' + s.id + ' → ' + m.id); return { kind: 'command', reply: '会话「' + shortTitle(s) + '」模型已切到 `' + m.id + '`', session_id: s.id }; } if (cmd === 'stop') { // 与 Web 按钮语义对齐:只有回合真在跑才停,idle 不误伤(stop 会把 held 刷成 cancelled) const run = engine.getRun(s.id); if (!(run && run.looping)) { return { kind: 'command', reply: '当前没有进行中的回合,无需终止', session_id: s.id }; } engine.stop(s.id); log.info('msg', tag + ' channel /stop ' + s.id); return { 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 { kind: 'command', reply: '已发起上下文压缩,摘要稍后回复', session_id: s.id }; } if (cmd === 'clear') { engine.clearSessionMessages(s.id); // 同上,回合进行中 409 log.info('msg', tag + ' channel /clear ' + s.id); return { kind: 'command', reply: '已清空当前会话,现在从零开始', session_id: s.id }; } // cmd === 'status' return { kind: 'command', reply: statusReply(db, s), session_id: s.id }; } // HTTP 入口:POST /api/channel/send {channel?, text} → handleSend 结果。 // - kind='message':普通消息已入会话开跑;kind='command':reply 即命令回执(纯文本,IM 直接转发)。 // - AI 的正式回复不在本接口返回:接入端复用 SSE GET /api/sessions/:id/stream 或轮询会话详情。 // - 引擎主动拒绝的走 HTTP 4xx {error},语义与 Web 路由一致。 router.post('/send', wrap((req, res) => { res.json(handleSend(engine.getDb(), { user: String(req.user || '').trim(), // 认证用户;未开认证为空串(自用单用户) channel: (req.body || {}).channel, text: (req.body || {}).text, })); })); module.exports = router; module.exports.handleSend = handleSend; module.exports.ensureSession = ensureSession; // 微信桥(wechat.js)直调面:命令识别(渠道上下文注入时机)与「建会话+换绑不发消息」(/new 带尾随文本) module.exports.parseCommand = parseCommand; module.exports.newSessionFor = newSessionFor;