3 Commits
Author SHA1 Message Date
kicer dbd67ec273 PDF 预览改用 inline 直连,支持 Range 与 304 缓存
新增 /files/inline;桌面面板与窄窗口统一用 iframe 直连,不再 fetch 整包转 blob;下载接口保持 attachment/no-store 不变。
2026-10-26 11:16:26 +08:00
kicer 774d09a07a 图片预览改为服务端派生 WebP 直连,修复大图加载慢
新增 /files/preview:按宽度生成 WebP 并落盘缓存,inline + ETag,原图仅下载时取;前端图片与全屏查看器改用派生直链,不再 fetch 整包转 blob。
2026-10-26 11:07:19 +08:00
kicer 5b005cc042 微信中途消息改走干预队列;工具失败不再推给微信
微信与渠道普通消息改用 enqueueMessage(mode:'interject'):回合中插话在当前工具跑完后生效,不再把 user 行插进 tool 批次中间;interject 入队插到队列 messages 之前,保证边界检查能命中队首。

微信端不再下发任何工具失败(多数是 AI 参数用错,模型下一轮自行纠正):去掉即时「工具调用失败」行与尾段失败清单,台账只保留中性计数与「N 次因你介入未执行」。
2026-10-26 10:41:28 +08:00
7 changed files with 217 additions and 52 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) };
}
+53 -5
View File
@@ -25,6 +25,18 @@ function pvOfficeUrl(rel) {
String(rel).split('/').filter(Boolean).map(encodeURIComponent).join('/') + '/';
}
// 图片预览派生地址:服务端按 w 生成并缓存 WebP,<img> 直连可边下边画;原图只留给“下载”。
function pvPreviewUrl(rel, w) {
return '/api/sessions/' + encodeURIComponent(state.sessionId) +
'/files/preview?path=' + encodeURIComponent(rel) + '&w=' + w;
}
// PDF 预览直连:让内建查看器自己发 Range 请求,不必先 fetch 整包转 blob。
function pvPdfUrl(rel) {
return '/api/sessions/' + encodeURIComponent(state.sessionId) +
'/files/inline?path=' + encodeURIComponent(rel);
}
function pvKind(name) {
const low = String(name).toLowerCase();
if (/\.html?$/i.test(low)) return 'html';
@@ -36,8 +48,8 @@ function pvKind(name) {
}
// 文件面板「当前目录」里的图片作为一组,供查看器左右滑动切换。
// 同组直接用下载直链(<img> 不受 Content-Disposition: attachment 影响),不必逐张取 blob。
// 依赖 files.js 的 filesNodeAt / filesCurDir / assetDownloadUrl(同为全局,加载顺序在前)。
// 同组直接用预览派生直链(2048px),不必逐张取原图/blob,滑动的预取也不会打满带宽。
// 依赖 files.js 的 filesNodeAt / filesCurDir(同为全局,加载顺序在前)。
function pvImgGroup(name) {
try {
if (typeof filesNodeAt !== 'function') return null;
@@ -46,7 +58,7 @@ function pvImgGroup(name) {
const paths = node.files.map(f => f.filename).filter(p => PV_IMG.test(p));
if (paths.length < 2) return null;
return {
list: paths.map(p => ({ src: assetDownloadUrl(p), alt: p.split('/').pop() })),
list: paths.map(p => ({ src: pvPreviewUrl(p, 2048), alt: p.split('/').pop() })),
at: paths.indexOf(name),
};
} catch (_) { return null; }
@@ -54,8 +66,9 @@ function pvImgGroup(name) {
// 刷新/新窗口两个钮对**所有**预览类型统一开放:
// refresh → pvState.reload(各类型都注入「按同一路径重开」,与地址条回车同一条路)
// popup → pvState.url(office=预览网关;文本/HTML/图片/PDF=blob URL;不支持的类型=下载地址)
// 服务端文件响应一律是 attachment,直接导航只会触发下载,所以能用 blob 的一律走 blob。
// popup → pvState.url(office=预览网关;图片/PDF=inline 直链;
// 文本/HTML=blob URL;不支持的类型=下载地址)
// 下载接口是 attachment,直接导航只会触发下载;图片/PDF 走各自的 inline 路由可直接开新窗口。
function pvToolbar(o) {
document.getElementById('pv-refresh').classList.toggle('hidden', !o.refresh);
document.getElementById('pv-popup').classList.toggle('hidden', !o.popup);
@@ -223,6 +236,40 @@ async function openFilePreview(name, sizeText) {
show(pvInfoNode(name, sizeText, hint), tbAll);
return;
}
// 图片走服务端派生预览:<img> 直连边下边画,不再 fetch 整包转 blob;原图只在“下载”时取。
// SVG 保留原路径(移动端还要展示源码),其余图片统一交给 /files/preview。
if (kind === 'img' && !/\.svg$/i.test(name)) {
const alt = String(name).split('/').pop();
const g = pvImgGroup(name);
if (desk) {
const im = document.createElement('img');
im.className = 'pv-img'; im.alt = String(name); im.decoding = 'async';
// 面板宽度约半屏,交给浏览器按 DPR 选 640/1280/2048,手机不会去拉大图
im.sizes = '(min-width: 960px) 50vw, 100vw';
im.srcset = [640, 1280, 2048].map(w => pvPreviewUrl(name, w) + ' ' + w + 'w').join(',');
const url = pvPreviewUrl(name, 2048);
im.src = url;
im.addEventListener('click', () => openImageViewer(url, alt, g && g.list, g && g.at));
im.addEventListener('error', () => {
if (my !== pvSeq) return;
show(pvInfoNode(name, sizeText, '图片读取失败:文件可能已被删除,或格式无法解码。'), tbAll);
});
show(im, Object.assign({}, tbAll, { url }));
} else {
openImageViewer(pvPreviewUrl(name, 2048), alt, g && g.list, g && g.at);
}
return;
}
// PDF 直连 inline 路由:桌面面板与窄窗口(全屏 overlay)都让内建查看器按 Range 取字节,
// 不再 fetch 整包转 blob。show() 会按 desk 自动落到右侧面板或 #fs-viewer。
if (kind === 'pdf') {
const url = pvPdfUrl(name);
const fr = document.createElement('iframe');
fr.className = desk ? 'pv-frame' : 'fs-html-frame';
fr.title = String(name); fr.src = url;
show(fr, Object.assign({}, tbAll, { url }));
return;
}
let r;
try {
r = await fetch('/api/sessions/' + state.sessionId + '/files/download?path=' + encodeURIComponent(name));
@@ -358,6 +405,7 @@ async function pvRenderLegacy(name, r, my) {
pvOverlayShow(iframe, { bar: true, name: name, source: html }); // 全宽沉浸,源码可看/可复制
if (my !== pvSeq) return;
} else if (/\.pdf$/i.test(name)) {
// 正常路径已在 openFilePreview 用 /files/inline 直连;这里仅作旧路径兜底。
const u = URL.createObjectURL(await r.blob());
if (state.lastPdfBlobUrl) { try { URL.revokeObjectURL(state.lastPdfBlobUrl); } catch (_) {} }
state.lastPdfBlobUrl = u;
+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) {
+98 -1
View File
@@ -1,5 +1,6 @@
// 文件管理 API:上传 / 列表 / 下载 / 删除
// 文件管理 API:上传 / 列表 / 下载 / 预览 / 删除
const express = require('express');
const crypto = require('crypto');
const fs = require('fs');
const path = require('path');
const multer = require('multer');
@@ -146,6 +147,102 @@ router.get('/:id/files/download', serveDownload);
// 供解析不了 Content-Disposition 的下载器兜底;path 参数与验签逻辑完全一致。
router.get('/:id/files/download-name/*', serveDownload);
// ---------- 图片预览派生图(inline,供 <img> 直连;与下载接口的 attachment/no-store 语义分开) ----------
// 大图慢的三层原因:整包 fetch 完才渲染、每次都要重下、把原始像素丢给浏览器解码。
// 这里按宽度用 sharp 生成 WebP 落盘缓存,前端 <img> 直连即可边下边画;原图只留给“下载”。
const PREVIEW_IMG_RE = /\.(png|jpe?g|gif|webp|svg|bmp|avif|ico)$/i;
const PREVIEW_WIDTHS = new Set([320, 640, 960, 1280, 1600, 2048]);
let sharp = null;
try { sharp = require('sharp'); } catch (_) { /* 未安装 sharp 时整条路由降级为原图直出 */ }
// 预览响应不能带 Content-Disposition: attachment;.imgcache 是点目录,sendFile 需显式放行。
function sendInline(res, abs) {
res.setHeader('Cache-Control', 'private, max-age=0, must-revalidate');
res.sendFile(abs, { cacheControl: false, dotfiles: 'allow', etag: true, lastModified: true });
}
router.get('/:id/files/preview', async function (req, res) {
try {
const rel = String(req.query.path || '');
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
if (!PREVIEW_IMG_RE.test(rel)) return res.status(400).json({ error: '不是图片' });
const w = PREVIEW_WIDTHS.has(Number(req.query.w)) ? Number(req.query.w) : 1600;
const taskDir = engine.taskDirOf(req.params.id);
const abs = resolveInTask(taskDir, rel);
const st = fs.statSync(abs);
if (!st.isFile()) return res.status(400).json({ error: '不是文件' });
// SVG 是矢量;GIF 可能在预览里要保留动画;没有 sharp 时只能原图直出。
if (/\.svg$/i.test(rel) || /\.gif$/i.test(rel) || !sharp) {
return sendInline(res, abs);
}
// 缓存 key 带 size+mtime:文件被 AI 覆盖后自动失效,不需要额外的清理逻辑。
const key = crypto.createHash('sha1')
.update(rel + '|' + st.size + '|' + st.mtimeMs + '|' + w)
.digest('hex');
const outDir = path.join(path.resolve(taskDir), '.imgcache', 'preview');
const out = path.join(outDir, key + '.webp');
if (!fs.existsSync(out)) {
// sharp 默认只取动图首帧,直接给原图避免“预览不动了”。metadata 只读文件头,不解码像素。
let meta = null;
try { meta = await sharp(abs).metadata(); } catch (_) { /* 交给下面原图兜底 */ }
if (meta && meta.pages && meta.pages > 1) return sendInline(res, abs);
// 小文件不一定像素少(高压缩的大尺寸图仍解码很慢):体积与像素都小才直出原图,
// 避免“压缩后反而更大”,也避免把 24MP 的 200KB 图原样丢给低端机解码。
const px = meta && meta.width && meta.height ? meta.width * meta.height : 0;
if (st.size <= 256 * 1024 && (!px || px <= 2 * 1000 * 1000)) return sendInline(res, abs);
fs.mkdirSync(outDir, { recursive: true });
// 随机临时名 + rename:并发请求不会读到半截文件,也不互相覆盖。
const tmp = out + '.' + crypto.randomBytes(4).toString('hex') + '.tmp.webp';
try {
await sharp(abs, { limitInputPixels: 80 * 1000 * 1000 })
.rotate()
.resize({ width: w, height: w, fit: 'inside', withoutEnlargement: true })
.webp({ quality: 85 })
.toFile(tmp);
fs.renameSync(tmp, out);
} catch (err) {
try { fs.unlinkSync(tmp); } catch (_) {}
return sendInline(res, abs); // 解码失败/格式不支持 → 原图兜底
}
}
sendInline(res, out);
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
// ---------- PDF 预览(inline,供 iframe 直连) ----------
// 现有下载接口是 attachment + no-store:前端只能 fetch 整包再转 blob,查看器要等整包下完才出现。
// 这里单独给预览一条 inline 路由,保留 sendFile 的 Range 支持,让内建查看器自己按需取字节;
// ETag/Last-Modified 让重复打开走 304,不再重下。下载按钮仍走原 /files/download,语义不变。
router.get('/:id/files/inline', function (req, res) {
try {
const rel = String(req.query.path || '');
if (!rel) return res.status(400).json({ error: '缺少 path 参数' });
if (!/\.pdf$/i.test(rel)) return res.status(400).json({ error: '不是 PDF' });
const abs = resolveInTask(engine.taskDirOf(req.params.id), rel);
const st = fs.statSync(abs);
if (!st.isFile()) return res.status(400).json({ error: '不是文件' });
res.setHeader('Content-Type', 'application/pdf');
res.setHeader('Content-Disposition', 'inline');
res.setHeader('Cache-Control', 'private, max-age=0, must-revalidate');
res.sendFile(abs, {
cacheControl: false,
dotfiles: 'allow',
etag: true,
lastModified: true,
acceptRanges: true,
});
} catch (err) {
res.status(404).json({ error: '文件不存在' });
}
});
// ---------- 打包下载(选中项含文件夹时,后端把整个选择打成 zip 流式返回) ----------
// 纯 Node 实现(STORE 不压缩 + 手拼 zip 结构):任务目录里多是媒体/生成产物,
// 压缩收益低;两遍读文件(先算 CRC 再磁盘流发送),内存占用与总大小无关。
+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;