微信接入 core 侧:wechat.js 桥接(绑定权威/实例控制/inbox 转 channel/总线投递带游标)+ /api/wechat 设置页 + /wxhook 内网回调;wxbot 缺席全程静默降级

This commit is contained in:
2026-09-27 21:55:40 +08:00
parent 9acac53343
commit 953438a82a
11 changed files with 588 additions and 25 deletions
+272
View File
@@ -0,0 +1,272 @@
// 微信接入桥接(core 侧大脑)。信任与分工模型(设计讨论见 docs/ARCHITECTURE.md §5.13):
// - wxbot(独立容器,只挂 agent-mcp-net)= 纯微信「调制解调器」:iLink SDK 多实例、收信转发、外发投递;
// 对 core 的一切认知只有共享服务 token,不持有任何用户凭据。
// - core = 身份与调度的唯一权威:wechat_bindings 表维护 (core 用户 ↔ binding ↔ 微信 bot 账号);
// 微信会话复用 routes/channel.js 同一套命令层(channel = 'wx:'+binding_id),引擎不感知微信。
// - 扫码登录的呈现挪进 core 的 Web 设置页(QR 经本模块代理 wxbot 的 SVG);
// iLink 协议保证扫码后仅本人可与 bot 单线对话,故无联系人授权面。
// 方向:
// Web → routes/wechat.js → 本模块 → wxbot /api/instances*(实例控制 / QR 代理)
// wxbot → core /wxhook/{inbox,hook}(Bearer 服务 token,挂在 auth.middleware 之前)
// core → wxbot /api/deliver(assistant 最终回复推送;总线内部监听驱动,游标落库不重发)
// 降级承诺:wxbot.url 未配置 = 功能整体静默关闭;配置了但 wxbot 没起 = 启动只留一行日志,
// 面板显示「未连接」、操作时报可读错误,绝不抛出未捕获异常影响 Web 主流程。
const crypto = require('crypto');
const engine = require('./engine');
const log = require('./log');
const channel = require('./routes/channel'); // 只用 handleSend(模块加载无副作用;engine 不 require 本模块,无环)
let cfg, db, bus;
let busAttached = false;
function init(cfg_, db_, bus_) {
cfg = cfg_; db = db_; bus = bus_;
attachBus();
}
const now = () => Date.now();
const msg = e => String((e && e.message) || e || 'unknown');
// ---------- 开关与 wxbot 客户端 ----------
function enabled() { return !!(cfg && cfg.wxbot && cfg.wxbot.url); }
function wxUrl() { return (cfg.wxbot && cfg.wxbot.url) || ''; }
function wxToken() { return (cfg.wxbot && cfg.wxbot.token) || ''; }
async function wxbotApi(method, path, body, timeoutMs) {
if (!enabled()) throw Object.assign(new Error('微信接入未配置:wxbot.url 为空'), { status_code: 409 });
const res = await fetch(wxUrl() + path, {
method,
headers: Object.assign(
{ Authorization: 'Bearer ' + wxToken() },
body ? { 'Content-Type': 'application/json' } : {}
),
body: body ? JSON.stringify(body) : undefined,
signal: AbortSignal.timeout(timeoutMs || 8000),
});
const text = await res.text();
if (!res.ok) {
let detail = text;
try { detail = (JSON.parse(text) || {}).error || text; } catch (_) {}
throw Object.assign(new Error('wxbot ' + res.status + ': ' + String(detail).slice(0, 200)), { status_code: 502 });
}
if (!text) return null;
try { return JSON.parse(text); } catch (_) { return text; }
}
// 存活探测(GET /wxbot 面板用):带 5s 缓存,wxbot 挂掉只表现为 false,绝不外抛。
let aliveCache = { at: 0, ok: false };
async function wxbotAlive() {
if (!enabled()) return false;
if (now() - aliveCache.at < 5000) return aliveCache.ok;
let ok = false;
try {
const r = await fetch(wxUrl() + '/health', { signal: AbortSignal.timeout(2500) });
ok = r.ok;
} catch (_) { /* 不在线 */ }
aliveCache = { at: now(), ok };
return ok;
}
// ---------- 绑定表 ----------
const BIND_COLS = 'id, user, status, note, bot_account_id, wx_to_user, last_msg_id, created_at, updated_at';
function getBinding(id) {
return db.prepare('SELECT * FROM wechat_bindings WHERE id = ?').get(id);
}
function touchBinding(id, fields) {
const sets = ['updated_at = ?'];
const vals = [now()];
for (const [k, v] of Object.entries(fields || {})) { sets.push(k + ' = ?'); vals.push(v); }
vals.push(id);
db.prepare('UPDATE wechat_bindings SET ' + sets.join(', ') + ' WHERE id = ?').run(...vals);
}
// 一人一绑(自用形态;换微信号走「解绑→重绑」);id 兼作 channel 后缀与 wxbot 存储目录名 → 只允许安全字符。
async function createBinding(user) {
if (!enabled()) throw Object.assign(new Error('微信接入未配置(wxbot.url 为空),请联系管理员在 config.yml / 环境变量 WXBOT_URL 启用后重启'), { status_code: 409 });
const dup = db.prepare('SELECT id FROM wechat_bindings WHERE user = ?').get(user);
if (dup) throw Object.assign(new Error('你已绑定微信(' + dup.id + '),请先解绑'), { status_code: 409 });
const id = 'wx' + crypto.randomBytes(5).toString('hex');
db.prepare(
"INSERT INTO wechat_bindings (id, user, status, last_msg_id, created_at, updated_at) VALUES (?,?,'pending',0,?,?)"
).run(id, user, now(), now());
try {
await wxbotApi('POST', '/api/instances', { id });
} catch (e) {
touchBinding(id, { status: 'error', note: msg(e) });
log.warn('wechat', id + ' 创建绑定成功但 wxbot 实例启动失败:' + msg(e));
}
log.info('wechat', (user || '-') + ' 新建微信绑定 ' + id);
return getBinding(id);
}
// 重发登录(二维码过期/失败后用):清状态 → wxbot 重起登录流程。
async function refreshBinding(id) {
const b = mustBinding(id);
await wxbotApi('POST', '/api/instances/' + encodeURIComponent(b.id) + '/refresh');
touchBinding(b.id, { status: 'pending', note: null });
return getBinding(b.id);
}
// 解绑:wxbot 停实例并删凭证(尽力而为,网络断了本地也必须删干净)。
async function deleteBinding(id) {
const b = mustBinding(id);
try { await wxbotApi('DELETE', '/api/instances/' + encodeURIComponent(b.id)); }
catch (e) { log.warn('wechat', b.id + ' 通知 wxbot 销毁实例失败(本地继续解绑):' + msg(e)); }
db.prepare('DELETE FROM wechat_bindings WHERE id = ?').run(b.id);
db.prepare("DELETE FROM channel_sessions WHERE channel = ?").run('wx:' + b.id);
log.info('wechat', (b.user || '-') + ' 解绑微信 ' + b.id);
return { ok: true };
}
function mustBinding(id) {
const b = getBinding(id);
if (!b) throw Object.assign(new Error('绑定不存在'), { status_code: 404 });
return b;
}
function listBindings(user) {
return db.prepare('SELECT ' + BIND_COLS + ' FROM wechat_bindings WHERE user = ? ORDER BY created_at DESC').all(user);
}
// QR 代理:wxbot 的 SVG 原样透传给 core 前端 <img>(cookie 鉴权在路由层,wxbot token 只在内网)。
// wxbot 404(无待扫二维码)翻译成 {none:true},前端按状态渲染,避免 img 报错红叉。
async function qrSvg(b) {
if (!enabled()) return { none: true };
try {
const res = await fetch(wxUrl() + '/api/instances/' + encodeURIComponent(b.id) + '/qr.svg', {
headers: { Authorization: 'Bearer ' + wxToken() },
signal: AbortSignal.timeout(8000),
});
if (!res.ok) return { none: true };
return { svg: await res.text() };
} catch (_) { return { none: true }; }
}
// 启动恢复:把表里的 binding 逐个 POST 到 wxbot(幂等,wxbot 端 Map 去重)。
// wxbot 不在线只留一行 info(它起来后用户点一次「刷新」或重新绑定即可自愈,不追着重试)。
async function restore() {
if (!enabled()) return;
const rows = db.prepare('SELECT id FROM wechat_bindings').all();
if (!rows.length) return;
let ok = 0, fail = 0;
for (const r of rows) {
try { await wxbotApi('POST', '/api/instances', { id: r.id }, 4000); ok++; }
catch (_) { fail++; }
}
if (fail) log.info('wechat', '启动恢复:' + ok + '/' + rows.length + ' 个实例已确保存在,' + fail + ' 个失败(wxbot 未启动?可在设置页刷新重试)');
else log.info('wechat', '启动恢复:' + ok + ' 个微信实例已确保存在');
}
// ---------- wxbot → core 回调(/wxhook,Bearer 服务 token,auth.middleware 之前挂载) ----------
function handleHook(body) {
const b = getBinding(String((body || {}).id || ''));
if (!b) return false;
const event = String(body.event || '');
if (event === 'online') touchBinding(b.id, { status: 'online', bot_account_id: body.accountId || b.bot_account_id, note: null });
else if (event === 'expired') touchBinding(b.id, { status: 'expired', note: String(body.note || '二维码已过期').slice(0, 200) });
else if (event === 'error') touchBinding(b.id, { status: 'error', note: String(body.note || '实例异常').slice(0, 200) });
else if (event === 'offline') touchBinding(b.id, { status: 'error', note: '实例已离线' });
else return false;
log.info('wechat', b.id + ' 状态 → ' + event);
return true;
}
// 微信来消息 → channel 层同一入口。返回 handleSend 结果;抛错冒给 hook 路由映射成非 2xx,
// wxbot 会把 error 文案直接回给用户(IM 里「出错要出声」)。
function handleInbox(body) {
const b = getBinding(String((body || {}).id || ''));
if (!b) throw Object.assign(new Error('绑定不存在(可能已解绑)'), { status_code: 404 });
const from = String((body || {}).from || '').trim().slice(0, 128);
if (from && from !== b.wx_to_user) touchBinding(b.id, { wx_to_user: from });
// 能收到消息就说明实例活着;漏收 online 回调(core 重启窗口)时顺带纠偏
if (b.status !== 'online') touchBinding(b.id, { status: 'online', note: null });
return channel.handleSend(db, {
user: b.user,
channel: 'wx:' + b.id,
text: (body || {}).text,
tag: (b.user || '-') + ' [微信 ' + b.id + ']',
});
}
// ---------- 投递:进程内总线监听 → 分段 push wxbot /api/deliver ----------
// 只推最终 assistant 文本(type=errAck / 纯工具轮空文本 / 存档类事件都不进微信);
// 游标 last_msg_id 落库:core 重启不补发历史,wxbot 短暂不可达时不丢(下一条事件连带补齐)。
function attachBus() {
if (busAttached || !bus) return;
busAttached = true;
bus.onInternal((sessionId, event, data) => {
if (event !== 'assistant_message' || !data) return;
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));
} catch (e) {
log.warn('wechat', '投递监听异常:' + msg(e));
}
});
}
// 每绑定一条串行链:assistant 事件按序到达也按序投递,且防并发推进游标互相覆盖。
const deliveryQ = new Map();
function enqueueDelivery(key, fn) {
const prev = deliveryQ.get(key) || Promise.resolve();
const next = prev.then(fn, fn).catch(() => {});
deliveryQ.set(key, next);
next.then(() => { if (deliveryQ.get(key) === next) deliveryQ.delete(key); });
}
async function deliverNow(bid, m) {
const b = getBinding(bid);
if (!b || b.status !== 'online' || !b.wx_to_user) return;
if (m.type === 'errAck') return;
let content = String(m.content || '').trim();
if (!content) return; // 纯工具调用轮(无文本)不打扰微信
if (content.startsWith('{"__blocks__"')) content = '【富文本消息,请到网页端查看】';
const id = Number(m.id) || 0;
if (id && id <= (b.last_msg_id || 0)) return;
const segs = splitText(content);
for (const s of segs) {
try { await wxbotApi('POST', '/api/deliver', { id: b.id, to: b.wx_to_user, text: s }, 15000); }
catch (e) {
log.warn('wechat', b.id + ' 投递失败,游标未推进(下次回复连带补齐):' + msg(e));
return;
}
}
if (id > (b.last_msg_id || 0)) touchBinding(b.id, { last_msg_id: id });
log.info('wechat', b.id + ' 已投递消息 ' + id + '(' + segs.length + ' 段)→ 微信');
}
// 微信单条上限按 ~1800 字保守分段:先按行聚合,超长行硬切。
function splitText(text, max = 1800) {
const out = [];
let cur = '';
for (const line of String(text).split('\n')) {
if (line.length > max) {
if (cur) { out.push(cur); cur = ''; }
for (let i = 0; i < line.length; i += max) out.push(line.slice(i, i + max));
continue;
}
if (cur && (cur.length + 1 + line.length) > max) { out.push(cur); cur = line; }
else cur = cur ? cur + '\n' + line : line;
}
if (cur) out.push(cur);
return out;
}
module.exports = {
init,
restore,
enabled,
wxbotAlive,
getBinding,
listBindings,
createBinding,
refreshBinding,
deleteBinding,
qrSvg,
handleHook,
handleInbox,
};