微信渠道上下文与出站文件卡片:收信幂等注入 channel_note(微信环境说明+「给链接即交付」约定)并强制 executing(跳过顾问 handoff,同定时任务理由);deliverNow 扫 /p/ 链接→归属硬校验→deliver_media→SDK 自动路由 image/video/file 卡片(链接文字兜底);wxbot /api/deliver_media 30mb 解析器前置

This commit is contained in:
2026-09-28 00:27:57 +08:00
parent dbe6b22cdd
commit 27a71d182d
5 changed files with 118 additions and 16 deletions
+3
View File
@@ -219,3 +219,6 @@ router.post('/send', wrap((req, res) => {
module.exports = router;
module.exports.handleSend = handleSend;
module.exports.ensureSession = ensureSession;
// 微信桥(wechat.js)直调面:命令识别(渠道上下文注入时机)与「建会话+换绑不发消息」(/new 带尾随文本)
module.exports.parseCommand = parseCommand;
module.exports.newSessionFor = newSessionFor;
+80 -9
View File
@@ -9,6 +9,7 @@
// Web → routes/wechat.js → 本模块 → wxbot /api/instances*(实例控制 / QR 代理)
// wxbot → core /wxhook/{inbox,hook}(Bearer 服务 token,挂在 auth.middleware 之前)
// core → wxbot /api/deliver(assistant 最终回复推送;总线内部监听驱动,游标落库不重发)
// + /api/deliver_media(正文里的 /p/ 链接→本地读字节→微信文件/图片卡片,尽力而为)
// 降级承诺:wxbot.url 未配置 = 功能整体静默关闭;配置了但 wxbot 没起 = 启动只留一行日志,
// 面板显示「未连接」、操作时报可读错误,绝不抛出未捕获异常影响 Web 主流程。
const crypto = require('crypto');
@@ -16,7 +17,8 @@ const fs = require('fs');
const path = require('path');
const engine = require('./engine');
const log = require('./log');
const channel = require('./routes/channel'); // 只用 handleSend/ensureSession(模块加载无副作用;engine 不 require 本模块,无环)
const publicFiles = require('./public-files');
const channel = require('./routes/channel'); // 只用 handleSend/ensureSession/newSessionFor/parseCommand(模块加载无副作用;engine 不 require 本模块,无环)
let cfg, db, bus;
let busAttached = false;
@@ -238,10 +240,32 @@ function handleHook(body) {
// wxbot 会把 error 文案直接回给用户(IM 里「出错要出声」)。
// 媒体消息(inbox 带 media:{b64,kind,filename?},wxbot 已从 CDN 下好):统一落会话任务目录
// + 记 files 元数据表 → 按 web 上传同款拼「用户上传了文件:<名>」作正文走 handleSend。
// 命名规则:图片/视频微信侧本无名 → 生成 wximg-/wxvid- 时间戳名;文件保留原名(sanitise 后,
// 对 AI 可读性重要),撞名加 -N;扩展名以 magic 嗅探为准(不信声明值)。
// 渠道上下文(普通/媒体/带尾随文本的 /new 在消息入库前先幂等确保):微信会话直接落 executing
// 跳过顾问 handoff(与定时任务投递同理由:异步接入不能被顾问话术卡住),channel_note 把微信
// 环境说明注入历史(UI 可见的 user 行,模型当普通消息看)——先于首条消息,AI 第一回合就看得到。
const MEDIA_MAX_BYTES = 20 * 1024 * 1024;
const MEDIA_KINDS = new Set(['image', 'video', 'file']);
const CHANNEL_NOTE = [
'【渠道说明】本会话来自微信单聊,用户只能收发文本与文件,无可点击界面。',
'- 交流风格:简短口语化,适配手机阅读;内容较长时整理成文件交付,不刷屏。',
'- 交付文件:生成文件后,在回复正文中给出下载链接,系统会自动将其转为微信文件卡片,',
' 链接文字保留作兜底。含敏感内容的文件不要外链。',
'- 接收文件:用户发来的图片/视频/文件已存入当前工作目录,用户消息中会说明文件名,可直接读取。',
].join('\n');
function ensureChannelContext(s) {
if (!s) return;
if (s.phase !== 'executing') {
db.prepare("UPDATE sessions SET phase='executing', updated_at=? WHERE id=?").run(now(), s.id);
s.phase = 'executing';
}
if (!db.prepare("SELECT 1 FROM messages WHERE session_id = ? AND type = 'channel_note' LIMIT 1").get(s.id)) {
engine.saveMessage(s.id, { role: 'user', type: 'channel_note', content: CHANNEL_NOTE });
log.info('wechat', s.id + ' 渠道上下文注入(executing + channel_note)');
}
}
function handleInbox(body) {
const b = getBinding(String((body || {}).id || ''));
if (!b) throw Object.assign(new Error('绑定不存在(可能已解绑)'), { status_code: 404 });
@@ -251,16 +275,30 @@ function handleInbox(body) {
if (b.status !== 'online') touchBinding(b.id, { status: 'online', note: null });
let text = String((body || {}).text || '').trim();
const m = (body || {}).media;
if (m && String(m.b64 || '').trim()) {
const kind = MEDIA_KINDS.has(String(m.kind || '')) ? String(m.kind) : 'file';
let buf;
const hasMedia = !!(m && String(m.b64 || '').trim());
// 媒体先验完再建会话:坏数据不该白造一个会话出来
let buf = null, kind = '';
if (hasMedia) {
kind = MEDIA_KINDS.has(String(m.kind || '')) ? String(m.kind) : 'file';
try { buf = Buffer.from(String(m.b64).trim().slice(0, Math.ceil(MEDIA_MAX_BYTES / 3) * 4 + 1024), 'base64'); } catch (_) { buf = null; }
if (!buf || !buf.length) throw Object.assign(new Error('媒体数据无法解析'), { status_code: 400 });
if (buf.length > MEDIA_MAX_BYTES) throw Object.assign(new Error('附件过大(限 20MB)'), { status_code: 400 });
const s = channel.ensureSession(db, b.user, 'wx:' + b.id);
}
const parsed = text ? channel.parseCommand(text) : null;
// 需要「先确保会话+渠道上下文」的三类:媒体 / 普通消息 / 带尾随文本的 /new(先建会话换绑,
// 尾随文本随后当普通消息发出);裸命令(/help /status /裸 /new 等)不隐式建会话。
const newWithText = !!(parsed && parsed.cmd === 'new' && parsed.rest);
const plainMsg = hasMedia || !!(text && (!parsed || parsed.normal));
let s = null;
if (newWithText) s = channel.newSessionFor(db, b.user, 'wx:' + b.id, '').s;
else if (plainMsg) s = channel.ensureSession(db, b.user, 'wx:' + b.id);
if (s) ensureChannelContext(s);
if (hasMedia) {
const name = saveTaskMedia(s, buf, kind, String(m.filename || ''));
text = text ? '用户上传了文件:' + name + '\n\n' + text : '用户上传了文件:' + name;
log.info('file', (b.user || '-') + ' [微信 ' + b.id + '] ' + kind + ' 落任务目录 ' + s.id + '/' + name + '(' + buf.length + ' 字节)');
} else if (newWithText) {
text = parsed.rest;
}
return channel.handleSend(db, {
user: b.user,
@@ -340,7 +378,7 @@ function attachBus() {
try {
const cs = db.prepare('SELECT user, channel FROM channel_sessions WHERE session_id = ?').get(sessionId);
if (!cs || !String(cs.channel || '').startsWith('wx:')) return;
enqueueDelivery(cs.channel.slice(3), () => deliverNow(cs.channel.slice(3), data));
enqueueDelivery(cs.channel.slice(3), () => deliverNow(cs.channel.slice(3), data, sessionId));
} catch (e) {
log.warn('wechat', '投递监听异常:' + msg(e));
}
@@ -356,7 +394,7 @@ function enqueueDelivery(key, fn) {
next.then(() => { if (deliveryQ.get(key) === next) deliveryQ.delete(key); });
}
async function deliverNow(bid, m) {
async function deliverNow(bid, m, sessionId) {
const b = getBinding(bid);
if (!b || b.status !== 'online' || !b.wx_to_user) return;
if (m.type === 'errAck') return;
@@ -373,10 +411,43 @@ async function deliverNow(bid, m) {
return;
}
}
// 链接→卡片:扫正文里的 /p/<22位id>(本会话 mint 过的公网链)→ 同进程查表 + 归属硬校验 →
// 本地读字节推 wxbot(SDK 按扩展名自动路由 image/video/file 卡片,CDN 上传加密全自带)。
// 尽力而为:任一附件失败只 warn(链接文字已在正文,用户可点),不影响游标推进。
for (const a of findAttachments(content, sessionId)) {
try { await wxbotApi('POST', '/api/deliver_media', { id: b.id, to: b.wx_to_user, filename: a.filename, b64: a.b64 }, 60000); }
catch (e) { log.warn('wechat', b.id + ' 附件投递失败(' + a.filename + ',链接文字兜底):' + msg(e)); }
}
if (id > (b.last_msg_id || 0)) touchBinding(b.id, { last_msg_id: id });
log.info('wechat', b.id + ' 已投递消息 ' + id + '(' + segs.length + ' 段)→ 微信');
}
// 扫回复文本里的 /p/<22位id> 链 → 可卡片化的本地附件({filename, b64},最多 5 个,单文件限 20MB)。
// 归属硬校验:只转本会话签发的链接(AI 复述他会话/被注入的链接时不外流文件);过期(resolve 为
// 空)、文件已删、跳出任务目录、超限全部静默跳过——链接文字本身留在正文,用户仍可点。
const ATTACH_MAX_BYTES = 20 * 1024 * 1024;
const ATTACH_MAX_COUNT = 5;
function findAttachments(content, sessionId) {
const out = [];
const seen = new Set();
for (const m of String(content).matchAll(/\/p\/([A-Za-z0-9_-]{22})(?![A-Za-z0-9_-])/g)) {
const pid = m[1];
if (seen.has(pid) || out.length >= ATTACH_MAX_COUNT) continue;
seen.add(pid);
try {
const f = publicFiles.resolve(pid);
if (!f || String(f.sessionId) !== String(sessionId)) continue;
const dir = engine.taskDirOf(sessionId);
const abs = path.resolve(dir, String(f.rel));
if (!abs.startsWith(dir + path.sep)) continue; // rel 签发时已验,此处再兑一层
const st = fs.statSync(abs);
if (!st.isFile() || st.size > ATTACH_MAX_BYTES) continue;
out.push({ filename: path.basename(abs), b64: fs.readFileSync(abs).toString('base64') });
} catch (_) { /* 过期/已删/异常:跳过 */ }
}
return out;
}
// 微信单条上限按 ~1800 字保守分段:先按行聚合,超长行硬切。
function splitText(text, max = 1800) {
const out = [];
+7 -4
View File
@@ -181,7 +181,8 @@ messages id PK / session_id FK / role (system|user|assistant|tool) /
is_error / created_at
# type 取值: summary / archived / errAck / task_brief (任务书快照,advising→executing 切换后首条上下文) /
# session_context (name 列 = SESSION_CONTEXT_NAME) /
# scheduler_note(定时任务删除通知,未知 type 按普通 user 消息发模型)
# scheduler_note(定时任务删除通知)/ channel_note(微信渠道上下文说明,每微信会话一条;
# 未知 type 一律按普通 user 消息发模型、UI 照常展示)
# 旧版遗留: summarize_request(压缩指令 user 消息,已废弃,仅 buildMessages 兼容旧库)
files id PK / session_id / filename / size / created_at
@@ -253,7 +254,7 @@ stateDiagram-v2
唯一出口是 `handoff` 工具:handler 把 `brief` 原样落盘根 `task.md`(reason ∈ ready/user_skip/user_stuck,
空 brief 拒回不切);`handoff` 与 `lab` 同入全局 `tools_deny`,advising 组合显式 `tools_deny: []` 独享可见。
- executing(执行):回到常规 profile 链路(模型配置 > 默认全量);单会话只解决一个问题,一路走到底,回头路只有「清空」。
- 上下文压缩对 phase 中性(原来什么模式、压完仍什么模式);定时任务投递前强制 `executing`(无人值守不能被顾问话术卡住)。
- 上下文压缩对 phase 中性(原来什么模式、压完仍什么模式);定时任务投递与微信渠道消息前强制 `executing`(无人值守/异步接入不能被顾问话术卡住,微信侧由 wechat.ensureChannelContext 幂等保证,见 §5.13)。
- 切换瞬间全史标 `archived`、插一条 `type='task_brief'` user 行(task.md 磁盘快照)作执行阶段唯一上下文起点;
幂等:执行中再改 task.md 只是普通文件编辑。
- 存量会话启动时统一回填 `executing`(旧值 planning 废弃,见 db.js 迁移);与 status 状态机正交,不影响模型调度。
@@ -427,8 +428,10 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks`
背景:仓库内 `wxbot/`(已入库,作为根 compose 的 `wxbot` 服务)是基于官方 iLink 协议 SDK 的微信「调制解调器」,只挂 `agent-mcp-net` 内网、不暴露公网;身份权威与全部会话逻辑在 core,引擎不感知微信。
- **模型**:一条 `wechat_bindings` = 一个 core 用户 = 一个 bot 实例(一人一绑,换号先解绑)。binding id 三用:实例控制/投递的寻址键、wxbot 凭证目录名、channel 键(`channel='wx:'+id`,因此命令层、会话自动新建、投递游标查询全部白借 §5.4 的 channel 机制,零新逻辑)。iLink 协议保证扫码登录后仅本人可与 bot 单线对话,无陌生人入口,故无联系人授权面。
- **方向三条线**:① Web(设置页→账户→微信内联卡)→ `/api/wechat` → wxbot `/api/instances*`(实例控制;QR SVG 代理内联渲染,只在 has_qr 就绪后取码,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(文本;image/video/file 媒体先落会话任务目录再拼「用户上传了文件」告知行,同 web 附件链路,voice 二期——命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message → 分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`。
- **投递游标** `last_msg_id` 落库 + 每绑定串行队列:重启不重发旧回复,wxbot 短暂不可达不丢(下一条连带补齐);errAck/纯工具轮(空文本)不进微信,`__blocks__` 图消息降级为占位文案。
- **方向三条线**:① Web(设置页→账户→微信内联卡)→ `/api/wechat` → wxbot `/api/instances*`(实例控制;QR SVG 代理内联渲染,只在 has_qr 就绪后取码,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(文本;image/video/file 媒体先落会话任务目录再拼「用户上传了文件」告知行,同 web 附件链路,voice 二期——命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message → 分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`;wxbot 出口统一 stripMarkdown(微信不渲染 markdown)。
- **渠道上下文**(ensureChannelContext,普通/媒体/带尾随文本的 /new 收信时幂等确保,先于首条消息入库):微信会话直接落 executing(跳过顾问 handoff,与定时任务同理由)+ 注入一条 `channel_note` user 行(微信环境说明:单线纯文本、给链接即交付卡片、入站文件已存工作目录等,AI 第一回合即知);/clear 删光历史后下条消息自动重注入。
- **出站文件(链接→卡片)**:deliverNow 扫正文 `/p/<22位id>` 链 → 同进程 `publicFiles.resolve` + 归属硬校验(只转本会话签发的链接,防外流)→ 本地读字节(单文件≤20MB、每条回复最多 5 个)→ `POST wxbot:/api/deliver_media` → SDK 按扩展名自动路由 image/video/file 卡片;尽力而为:失败只 warn,链接文字留在正文作兜底(AI 无需感知卡片机制,channel_note 已告知「给链接即交付」)。
- **投递游标** `last_msg_id` 落库 + 每绑定串行队列:重启不重发旧回复,wxbot 短暂不可达不丢(下一条连带补齐);errAck/纯工具轮(空文本)不进微信,`__blocks__` 图消息降级为占位文案。文本投递经 wxbot 出口统一 stripMarkdown(微信不渲染 markdown)。
- **降级承诺**:`wxbot.url` 未配 = 功能整体静默关闭(启动零日志噪声、设置页入口隐藏);配了但 wxbot 没起 = restore 只留一行 info,面板显示未连接,所有外呼失败只 warn,绝不阻塞/抛出未捕获异常影响 Web 主流程(鉴权/探活失败同样只降级)。绑定/刷新/解绑对 wxbot 均 **fire-and-forget**(点击秒回,不拿 wxbot 网络往返卡按钮;失败落 note 由轮询/刷新按钮恢复);`overview()` 每轮访问拿实例快照双向纠偏(补建缺失实例/纠正丢的 hook),`restore()` 启动对账兼清孤儿实例;前端内联卡按渲染串比对增量更新,QR 只在 has_qr 就绪后才取码,无闪烁无坏图帧。
- 鉴权:双向共用一个服务 token(根 .env `WXBOT_TOKEN`,init.sh 生成/复用)——core→wxbot 时 wxbot 把该 env 自动并入 /api 白名单;wxbot→core 走 `/wxhook`(挂 auth.middleware 之前,Bearer 哈希后定长比较,token 未配一律 503 fail-closed)。wxbot 零配置文件(同 executor 模式),接线全靠 env,config.yml 仅作可选覆盖。
+4 -2
View File
@@ -65,7 +65,8 @@ docker compose up -d agent-core # core 带 WXBOT_URL/WXBOT_TOKEN 重建(
| POST | `/api/instances/:id/refresh` | 重发登录流程(二维码过期/失败后;保留凭证) |
| DELETE | `/api/instances/:id` | 销毁实例并删登录凭证(解绑) |
| GET | `/api/instances/:id/qr.svg` | 当前登录二维码(core 设置页代理渲染) |
| POST | `/api/deliver {id,to,text}` | 外发投递(core 已按微信长度分段) |
| POST | `/api/deliver {id,to,text}` | 文本投递(core 已分段;出口统一 stripMarkdown,微信不渲染 markdown) |
| POST | `/api/deliver_media {id,to,filename,b64}` | 附件投递(core 已把正文里的 /p/ 链接换成本地字节并做归属/大小校验;SDK 按扩展名自动路由 image/video/file 卡片) |
## 本地调试
@@ -80,5 +81,6 @@ WXBOT_TOKEN=$WXBOT_TOKEN CORE_URL=http://127.0.0.1:8090 \
- 语音消息目前回 `bot.empty_hint` 占位(二期:SDK `bot.download(msg)` 拿 WAV(需 `silk-wasm`)
→ tools/asr `/api/transcribe` 转写后进会话)。
- 出站图片/文件二期:core 的 `GET /p/<id>` 公网链喂 `bot.send(userId, {url})`(SDK 自动下载上传 CDN)。
- 出站文件/图片已实现「链接→卡片」:AI 在回复正文里给 mint 链接,core 自动换成微信文件卡片
(链接文字保留兜底);AI 侧约定见 core 注入的 channel_note。
- core 未配 `WXBOT_URL` 时微信功能整体静默关闭(设置页不出现入口,服务零报错)。
+24 -1
View File
@@ -265,9 +265,12 @@ async function onIncoming(inst, msg) {
}
}
// ── HTTP 服务 ────────────────────────────────────────────────────────────────
// ── HTTP 服务 ──────────────────────────────────────────────────────────────────────
const app = express();
app.disable("x-powered-by");
// 附件投递带 base64 大 body:该路径单独先挂大限额解析器(早于全局 1mb;body-parser 幂等,
// 全局那份见到 req._body 会自动跳过),与 core 侧 /wxhook 同法。
app.use("/api/deliver_media", express.json({ limit: "30mb" }));
app.use(express.json({ limit: "1mb" }));
app.get("/health", (_req, res) => {
@@ -330,6 +333,26 @@ app.post("/api/deliver", requireAuth, async (req, res) => {
}
});
// core → wxbot 附件投递(链接→卡片):core 已把正文里的 /p/ 链接换成本地读好的字节并做
// 归属/大小/数量校验;这里只转发 SDK——bot.send 的 file 按扩展名自动路由 image/video/file 卡片,
// CDN 上传 + 加密全在 SDK 内。
app.post("/api/deliver_media", requireAuth, async (req, res) => {
const { id, to, filename, b64 } = req.body || {};
const inst = instances.get(String(id || ""));
if (!inst) return res.status(404).json({ error: "实例不存在" });
if (!to || !String(b64 || "").trim()) return res.status(400).json({ error: "to/b64 不能为空" });
const buf = Buffer.from(String(b64).slice(0, 30 * 1024 * 1024), "base64");
if (!buf.length) return res.status(400).json({ error: "b64 解码失败" });
if (buf.length > 20 * 1024 * 1024) return res.status(413).json({ error: "附件过大(限 20MB)" });
const safeName = String(filename || "file").split(/[\\/]/).pop().slice(0, 120) || "file";
try {
await inst.bot.send(String(to), { file: buf, fileName: safeName });
res.json({ ok: true });
} catch (e) {
res.status(502).json({ error: "附件发送失败:" + String(e?.message || e).slice(0, 200) });
}
});
// 启动即恢复:扫描凭证目录逐个拉起实例(core 不在线也照常上线;状态回调失败不影响)
for (const ent of fs.readdirSync(CONFIG.bot.storage_dir, { withFileTypes: true })) {
if (ent.isDirectory() && ID_RE.test(ent.name)) createInstance(ent.name);