From 5b005cc042420edaf52f9c86c287e44fde20a877 Mon Sep 17 00:00:00 2001 From: kicer Date: Mon, 26 Oct 2026 10:41:28 +0800 Subject: [PATCH] =?UTF-8?q?=E5=BE=AE=E4=BF=A1=E4=B8=AD=E9=80=94=E6=B6=88?= =?UTF-8?q?=E6=81=AF=E6=94=B9=E8=B5=B0=E5=B9=B2=E9=A2=84=E9=98=9F=E5=88=97?= =?UTF-8?q?=EF=BC=9B=E5=B7=A5=E5=85=B7=E5=A4=B1=E8=B4=A5=E4=B8=8D=E5=86=8D?= =?UTF-8?q?=E6=8E=A8=E7=BB=99=E5=BE=AE=E4=BF=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 微信与渠道普通消息改用 enqueueMessage(mode:'interject'):回合中插话在当前工具跑完后生效,不再把 user 行插进 tool 批次中间;interject 入队插到队列 messages 之前,保证边界检查能命中队首。 微信端不再下发任何工具失败(多数是 AI 参数用错,模型下一轮自行纠正):去掉即时「工具调用失败」行与尾段失败清单,台账只保留中性计数与「N 次因你介入未执行」。 --- README.md | 1 + app/AGENTS.md | 14 +++++++-- app/server/engine.js | 23 +++++++++++---- app/server/routes/channel.js | 19 ++++++++++--- app/server/wechat.js | 55 ++++++++++++++---------------------- 5 files changed, 66 insertions(+), 46 deletions(-) diff --git a/README.md b/README.md index 9c0a132..74e672c 100644 --- a/README.md +++ b/README.md @@ -200,6 +200,7 @@ mcp_servers: 在「设置 → 账户 → 微信绑定」生成二维码,扫码后即可单线对话: - 微信消息复用同一套会话和命令层,支持 `/new`、`/list`、`/switch`、`/delete`、`/rename`、`/models`、`/think`、`/stop`、`/compact`、`/clear`、`/status`、`/help`。 +- 回合进行中发消息=自动干预:当前工具调用跑完就插话(同批剩余调用标记为「因你介入未执行」),不会等本轮结束,也不会打断正在执行的命令。要立刻中止用 `/stop`。 - 图片、视频、文件会落到当前会话目录;单发媒体只留痕,不唤醒 AI。 - AI 最终回复会推回微信;较长回复自动分段,超长时落成 `.md` 文件卡片。 - 定时任务完成或失败也会通知微信。 diff --git a/app/AGENTS.md b/app/AGENTS.md index cc54329..0f25145 100644 --- a/app/AGENTS.md +++ b/app/AGENTS.md @@ -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`,只中断当前回合、保留队首。 diff --git a/app/server/engine.js b/app/server/engine.js index 342632e..f21d989 100644 --- a/app/server/engine.js +++ b/app/server/engine.js @@ -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) }; } diff --git a/app/server/routes/channel.js b/app/server/routes/channel.js index 4a06bb6..fb263b7 100644 --- a/app/server/routes/channel.js +++ b/app/server/routes/channel.js @@ -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) { diff --git a/app/server/wechat.js b/app/server/wechat.js index ebe8939..7df1235 100644 --- a/app/server/wechat.js +++ b/app/server/wechat.js @@ -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;