微信中途消息改走干预队列;工具失败不再推给微信

微信与渠道普通消息改用 enqueueMessage(mode:'interject'):回合中插话在当前工具跑完后生效,不再把 user 行插进 tool 批次中间;interject 入队插到队列 messages 之前,保证边界检查能命中队首。

微信端不再下发任何工具失败(多数是 AI 参数用错,模型下一轮自行纠正):去掉即时「工具调用失败」行与尾段失败清单,台账只保留中性计数与「N 次因你介入未执行」。
This commit is contained in:
2026-10-26 10:41:28 +08:00
parent 7a34f612e7
commit 5b005cc042
5 changed files with 66 additions and 46 deletions
+1
View File
@@ -200,6 +200,7 @@ mcp_servers:
在「设置 → 账户 → 微信绑定」生成二维码,扫码后即可单线对话:
- 微信消息复用同一套会话和命令层,支持 `/new`、`/list`、`/switch`、`/delete`、`/rename`、`/models`、`/think`、`/stop`、`/compact`、`/clear`、`/status`、`/help`。
- 回合进行中发消息=自动干预:当前工具调用跑完就插话(同批剩余调用标记为「因你介入未执行」),不会等本轮结束,也不会打断正在执行的命令。要立刻中止用 `/stop`。
- 图片、视频、文件会落到当前会话目录;单发媒体只留痕,不唤醒 AI。
- AI 最终回复会推回微信;较长回复自动分段,超长时落成 `.md` 文件卡片。
- 定时任务完成或失败也会通知微信。
+11 -3
View File
@@ -103,10 +103,15 @@ POST /api/sessions/:id/messages
| 模式 | 入口 | 行为 |
|---|---|---|
| `queue`(默认) | 运行中点发送 | 本轮 `finalize` 后作为新回合的第一条消息发出 |
| `interject`(干预) | 条幅「干预」 | 当前工具跑完(或本条回复落库)后,闭合批次、就地插话,同一回合继续 |
| `queue`(默认) | 网页端运行中点发送 | 本轮 `finalize` 后作为新回合的第一条消息发出 |
| `interject`(干预) | 条幅「干预」/ **IM 渠道消息** | 当前工具跑完(或本条回复落库)后,闭合批次、就地插话,同一回合继续 |
| `now`(立即发送) | 条幅「立即发送」 | 杀进程 + abort 流,本回合判 `cancelled`,收尾后立刻发 |
微信 / `POST /api/channel/send` 的普通消息走 `enqueueMessage(..., {mode:'interject'})`:
IM 用户在实时对话,回合中插话应当“当前这步跑完就插”,不排队等本轮结束;且**必须走队列**
(旧的直接 `postUserMessage` 会把 user 行插进工具批次中间)。`interject` 入队时插到所有
`queue` 之前(已在队列里的 interject 仍保持先来后到),这样它立刻成为队首,边界检查才能命中。
**铁律:队列里的消息绝不先落 `messages` 表。** 只在安全边界写库——① 工具批次闭合
(本批每个 `tool_call_id` 都有回执);② 无 `tool_calls` 的回复已落库;③ 回合 finalize。
否则 `user` 行会夹在 `assistant.tool_calls` 与 `tool` 回执之间,或批次没闭合就收尾,
@@ -114,7 +119,10 @@ POST /api/sessions/:id/messages
- `closeToolBatch(sessionId, reason)` 是配对兜底的唯一写入口:给最后一条带 `tool_calls` 的
assistant 里缺回执的调用补一条 `is_error=1` 的合成 tool 行(「用户介入/终止,本次调用未执行」)。
`finalize` 无条件调一次,取消路径与干预路径各调一次。
`finalize` 无条件调一次,取消路径与干预路径各调一次。广播的 `tool_result` 带 `skipped:true`,
微信端据此显示「N 次因你介入未执行」。
- **微信端不下发任何工具失败**(即使 `is_error=true`):多数是模型参数用错、下一轮自己会改,
推给用户既看不懂也帮不上忙;要交代就由模型自己的回复说。失败仍完整保留在库里与网页端工具卡上。
- 读侧还有一层纯过滤(`llm.buildMessages` 的 `pairedByAssistant` / `emittedCallIds`):只下发
「本批(紧邻的连续 tool 行)确有回执」的调用,孤儿回执也不下发。DB/UI 不动,专门兜历史脏数据。
- `stop()`(用户点「停止」)**会清空队列**(全停语义);「立即发送」不走 `stop`,只中断当前回合、保留队首。
+18 -5
View File
@@ -495,9 +495,11 @@ function closeToolBatch(sessionId, reason) {
const name = (c.function && c.function.name) || '未知工具';
const text = 'Error: ' + reason + '本次调用未执行(' + name + ')。';
const msgId = saveMessage(sessionId, { role: 'tool', tool_call_id: c.id, name, content: text, is_error: true });
// 同步广播:前端工具卡不能停在「调用中」呼吸态
// 同步广播:前端工具卡不能停在「调用中」呼吸态。
// skipped:这不是工具自己失败,而是用户介入导致没执行——微信端据此不报
// 「工具调用失败」、不计入失败数(否则一次干预会换来一串误导性告警)。
bus.emit(sessionId, 'tool_result', {
tool_call_id: c.id, name, content: text, is_error: true, msg_id: msgId,
tool_call_id: c.id, name, content: text, is_error: true, skipped: true, msg_id: msgId,
});
n++;
}
@@ -1186,11 +1188,16 @@ function clearPendings(sessionId) {
}
// 入队。没有在跑的回合时,任何模式都等价于立即发送(队列只对运行中的回合有意义)。
// opts.mode:
// queue(默认)→ 排到队尾,本轮收尾后发(网页端发消息走这条)
// interject → 插队到所有 queue 之前,下一个安全边界就投递(IM/渠道消息走这条:
// 用户是在实时对话,不应该排在网页端被动排队的消息后面)
function enqueueMessage(sessionId, content, opts) {
const session = getSession(sessionId);
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
const text = String(content == null ? '' : content).trim();
if (!text) throw Object.assign(new Error('content 不能为空'), { status_code: 400 });
const mode = (opts && opts.mode) === 'interject' ? 'interject' : 'queue';
const run = runs.get(sessionId);
if (!run || !run.looping) {
const r = postUserMessage(sessionId, text, { deepThink: !!(opts && opts.deepThink) });
@@ -1198,13 +1205,19 @@ function enqueueMessage(sessionId, content, opts) {
}
const item = {
id: newPendingId(), content: text,
deepThink: !!(opts && opts.deepThink), mode: 'queue', created_at: now(),
deepThink: !!(opts && opts.deepThink), mode, created_at: now(),
};
const list = pendingList(sessionId).slice();
list.push(item);
if (mode === 'interject') {
// 插到第一条「排队」消息之前;已在队列里的干预消息仍保持先来后到(不反序)。
const i = list.findIndex(x => x.mode === 'queue');
if (i < 0) list.push(item); else list.splice(i, 0, item);
} else {
list.push(item);
}
pendings.set(sessionId, list);
bus.emit(sessionId, 'pending_added', publicPending(item));
log.info('msg', sessionId + ' 待投递消息入队(队列 ' + list.length + '):' + text.slice(0, 60).replace(/\s+/g, ' '));
log.info('msg', sessionId + ' 待投递消息入队(' + mode + ',队列 ' + list.length + '):' + text.slice(0, 60).replace(/\s+/g, ' '));
return { pending_id: item.id, queued: true, pending: list.map(publicPending) };
}
+15 -4
View File
@@ -236,7 +236,11 @@ function handleSend(db, opts) {
// 普通消息:解析当前会话,无绑定自动新建(IM 用户不会先打 /new 才能聊天)。
// 微信通道以 binding 行的全局 deep_think 开关作消息的 deepThink 取值(与 H5 按钮 body 同义,
// 只是没得点、改用 /think 拨);非 wx 通道照旧不传 opts,行为零变化。
// 只是没得点、改用 /think 拨);非 wx 通道照旧不传 deepThink,行为零变化。
// 投递走 mode:'interject':IM 用户是在实时对话,回合中插话应当「当前工具跑完就插话」,
// 而不是排队等本轮结束。没在跑时 enqueueMessage 等价于立即发送,行为与旧 postUserMessage 一致。
// (旧实现直接 postUserMessage → live 追投:user 行可能落在 assistant.tool_calls 与
// tool 回执之间,批次配对当场断裂。走队列才能保证只在安全边界写库。)
if (!parsed || parsed.normal) {
const wx = String(channel).startsWith('wx:');
const deepThink = wx ? !!((db.prepare('SELECT deep_think FROM wechat_bindings WHERE id = ?').get(channel.slice(3)) || {}).deep_think) : undefined;
@@ -246,10 +250,17 @@ function handleSend(db, opts) {
const r = newSessionFor(db, user, channel, text, wx ? { deepThink } : undefined);
s = r.s; sent = r.sent;
} else {
sent = engine.postUserMessage(s.id, text, wx ? { deepThink } : undefined);
sent = engine.enqueueMessage(s.id, text, wx ? { deepThink, mode: 'interject' } : { mode: 'interject' });
}
log.info('msg', tag + ' channel 消息 → ' + s.id);
return { kind: 'message', reply: '已发送到会话 ' + s.id, session_id: s.id, message_id: sent.message_id };
const queued = !!(sent && sent.queued);
log.info('msg', tag + ' channel 消息 → ' + s.id + (queued ? '(已排队,等安全边界投递)' : ''));
return {
kind: 'message',
reply: (queued ? '已排队到会话 ' : '已发送到会话 ') + s.id,
session_id: s.id,
message_id: sent && sent.message_id,
pending_id: sent && sent.pending_id,
};
}
if (parsed.unknown) {
+21 -34
View File
@@ -418,9 +418,10 @@ function saveTaskMedia(s, buf, kind, rawName) {
// 预算够 → 全文 + 附件卡片;放不下但 ≥2 → 降级「截断头部 + 全文写会话
// .md 转文件卡片」(内容零丢失);<2 → 放弃并告警(网页端完整可见)。
// 4. 工具台账(重结果轻过程;微信端不再有独立台账消息):tool_call/tool_result 只在 st.tools
// 记账;失败即时单发一行「工具调用失败: 名称 + 参数」(预算保不住结论储备则留给尾段汇总);
// done 时汇总为一句「本轮工具调用 N 次(name x c, ...),其中 M 次失败」搭结论尾段,
// 纯工具轮(无结论文本)则汇总与文件卡片合成一条兜底消息(网页端始终全量可见)。
// 记账;**工具失败一律不下发**(多数是 AI 参数用错,模型下一轮自己改,推给用户既看不懂
// 也帮不上忙;网页端工具卡与库里的 is_error 照旧保留)。done 时只汇总一句中性计数
// 「本轮工具调用 N 次(name x c, ...)」搭结论尾段,若本轮有因用户介入而未执行的调用,
// 额外补「N 次因你介入未执行」;纯工具轮(无结论文本)则汇总与文件卡片合成一条兜底消息。
// 5. 通用 ui_card(MCP 工具回包的预览卡片块):按 URL 去重攒进 st.cards,不独立占配额,
// done 时作「文件」小节搭结论尾段;每条 markdown 链接 + 原始 URL 各一行(防纯文化退化
// 后点不开);未知 action 或未配公网前缀在微信端静默忽略。
@@ -439,13 +440,13 @@ function attachBus() {
else if (event === 'done') enqueueDelivery(bid, () => flushHeld(bid));
else {
// 工具调用/回执:心跳 + 台账记账(台账不再独立成消息,见策略注释第 4 条);
// 失败经串行队列即时单发一行;ui_card 攒进本回合卡片列表(done 时随尾段投)。
// 失败一律**不下发**(多数是 AI 参数用错,模型下一轮自己改;用户看到
// 「工具调用失败」既看不懂也帮不上忙)。网页端工具卡与库里的 is_error 照旧保留。
// ui_card 攒进本回合卡片列表(done 时随尾段投)。
// reasoning_delta(思考流)不进台账,只走下面的心跳——微信用户能看到「正在输入」在思考。
if (event === 'tool_call') toolDigestPush(bid, data);
else if (event === 'tool_result') {
toolDigestMark(bid, data);
if (data && data.is_error) enqueueDelivery(bid, () => flushFailedLine(bid));
} else if (event === 'ui_card') cardCollect(bid, data, sessionId);
else if (event === 'tool_result') toolDigestMark(bid, data);
else if (event === 'ui_card') cardCollect(bid, data, sessionId);
maybeTypingPing(bid); // 「正在输入」心跳:长工具/思考回合里微信持续看到 AI 还在干活
}
} catch (e) {
@@ -572,32 +573,34 @@ function toolDigestPush(bid, data) {
const name = String((data && data.name) || '');
if (!name) return;
const hint = argHint(data && data.arguments);
const ex = st.tools.find(t => t.name === name && t.hint === hint && !t.err);
// 同参数同名归并成一条(失败也不再单开一条:失败对用户不可见,没必要为它拆行)
const ex = st.tools.find(t => t.name === name && t.hint === hint && !t.skipped);
if (ex) { ex.count++; if (data.id) ex.ids.push(data.id); return; }
st.tools.push({ name, hint, count: 1, err: false, ids: data && data.id ? [data.id] : [] });
st.tools.push({ name, hint, count: 1, skipped: false, ids: data && data.id ? [data.id] : [] });
} catch (_) { /* 摘要锦上添花,绝不动摇投递 */ }
}
// 只记「未执行」(用户介入/终止导致没跑的调用)。工具自身失败不进台账展示:
// 多数是 AI 参数写错,模型下一轮会自己改;它要不要告诉用户,由模型自己的回复决定。
function toolDigestMark(bid, data) {
try {
if (!data || !data.is_error) return;
if (!data || !data.skipped) return;
const st = getTurn(bid);
const t = st.tools.find(x => x.ids.indexOf(data.tool_call_id) >= 0);
if (t) t.err = true;
if (t) t.skipped = true;
} catch (_) { /* 同上 */ }
}
// 降级路径的渲染(peek 不清空):台账单发预算不足/失败时搭结论尾段,结论投递成功后调用方清空。
// 若 wxbot 开 WXBOT_STRIP_MARKDOWN 回退纯文化,stripMarkdown 会把围栏/标题降为普通行,信息不丢。
// done 尾段的工具汇总(peek 不清空):一句计数 + 未即时送达的失败行;结论投递成功后由调用方清空。
// done 尾段的工具汇总(peek 不清空):一句中性计数 + 「因你介入未执行」的条数。
// 刻意不列失败:工具报错是 AI 自己该处理的事,往里推只会让用户困惑(详见 toolDigestMark 注释)。
function peekToolDigest(st) {
const ts = st && st.tools;
if (!ts || !ts.length) return '';
const total = ts.reduce((n, t) => n + (t.count || 1), 0);
const breakdown = ts.map(t => t.name + (t.count > 1 ? ' x' + t.count : '')).join(', ');
const errN = ts.filter(t => t.err).length;
let s = '---\n\n### 工具\n\n本轮工具调用 ' + total + ' 次(' + breakdown + ')';
if (errN) s += ',其中 ' + errN + ' 次失败';
const unnotified = ts.filter(t => t.err && !t.warned);
if (unnotified.length) s += '\n' + unnotified.map(t => '- 失败: ' + t.name + (t.hint ? ' ' + t.hint : '')).join('\n');
const skipN = ts.filter(t => t.skipped).length;
if (skipN) s += ',' + skipN + ' 次因你介入未执行';
return s;
}// 正文与 digest 一起分段:正文照旧 splitText,digest 原子追尾——markdown 代码围栏不能被
// 1800 字分段拦腰斩断;尾段能与正文同段就同段(不多占配额),放不下才单独成段。
@@ -610,22 +613,6 @@ function digestSegs(body, digest) {
else segs.push(digest);
return segs;
}
// 独立台账消息:一批 ≤8 行整屏渲染,无折叠(零头等下一班车,done 时补发)。
// 失败即时单发:一次 tool_result 失败事件触发一次;预算保不住结论储备就留给尾段汇总兜底。
async function flushFailedLine(bid) {
const st = getTurn(bid);
const t = st.tools.find(x => x.err && !x.warned);
if (!t) return;
const b = bindReady(bid);
if (!b) return;
if (st.sent + 1 > REPLY_QUOTA - CONCLUSION_RESERVE) return;
try {
await wxbotApi('POST', '/api/deliver', { id: b.id, to: b.wx_to_user, text: '工具调用失败: ' + t.name + (t.hint ? '\n' + t.hint : '') }, 15000);
st.sent++;
t.warned = true;
} catch (_) { /* 投失败不紧:done 时尾段汇总仍会列出 */ }
}
// ---------- 通用 UI 卡片(bus ui_card 事件,见 wechat 策略注释第 5 条)----------
// open_preview → 绝对预览 URL:与前端 pvOfficeUrl/网关寻址同款,前缀真相在 core(public_link.base_url)。
function uiCardUrl(data, sessionId) {
@@ -671,7 +658,7 @@ async function flushTail(bid) {
// 留给结论尾段搭便车;直投失败归还队首(串行队列调度,与正文消息天然排队,无并发互踩)。
// 过程消息:直发窗口内且投完后仍给结论留足储备才投;否则计入 omitted,并进结论的注记行。
// 正文不携带工具信息——工具信息自有出口(失败即时行/done 尾段汇总),不重复。
// 正文不携带工具信息——工具信息自有出口(done 尾段汇总),不重复;工具失败不下发。
async function deliverProcess(bid, m, sessionId) {
const b = bindReady(bid);
if (!b || stale(b, m)) return;