@@ -0,0 +1,312 @@
// wxbot:Agent 栈的微信「调制解调器」(wxbot 只服务本 agent、不对外暴露,作为根 compose 的 wxbot 服务已并入仓库)。
// - 基于 @wechatbot/wechatbot(官方 iLink 协议 Node SDK),同进程多实例:
// 一个实例 = 一个 core 用户的 bot 账号(扫码登录后仅本人可与 bot 单线对话,协议保证无陌生人入口)。
// - 本服务不保存任何业务状态:绑定(core 用户 ↔ 实例)权威在 agent-core 的 wechat_bindings 表;
// 这里只做三件事——实例控制(core 调 /api/instances*)、收信转发(POST core /wxhook/inbox)、
// 外发投递(core 调 /api/deliver → bot.send)。二维码呈现挪进 core 的 Web 设置页。
// - 凭证按实例隔离在 bot.storage_dir/<binding_id>/( compose 卷 ./data),重启自动恢复登录免扫码;
// 启动时扫描目录逐个拉起实例(core 起来与否不影响;上线状态经 /wxhook/hook 回报 core, core 不在线则丢弃,
// 首条消息的 inbox 会顺带把状态纠回 online)。
// - 零配置文件:必需接线全走 compose env( WXBOT_TOKEN / CORE_URL,同 executor 的 EXECUTOR_* 模式),
// config.yml 降级为「可选覆盖」(端口/日志等级/占位文案),不存在就用内置默认值。
// - 鉴权:/api/* 需 Bearer token; env WXBOT_TOKEN 自动并入白名单,与 core 侧同一值即双向打通;
// 仅 /health 开放。凭证 = 微信账号权限,./wxbot/data 卷勿外泄。
import express from "express" ;
import fs from "node:fs" ;
import path from "node:path" ;
import yaml from "js-yaml" ;
import QRCode from "qrcode" ;
import { WeChatBot } from "@wechatbot/wechatbot" ;
// ── 配置加载(含 ${ENV_VAR} 展开)────────────────────────────────────────────
const DEFAULTS = {
server : { port : 8093 } ,
auth : { enabled : true , tokens : [ ] } ,
core : {
url : "" , // agent-core 内网地址;一般不配,由 compose env CORE_URL 兑底注入
token : "" , // 调 core /wxhook/* 的凭据;由 env WXBOT_TOKEN 兑底(与 auth 白名单同源)
} ,
bot : {
storage _dir : "/data/bots" , // 每绑定一个子目录(目录名 = binding id)
log _level : "info" , // debug | info | warn | error | silent
empty _hint : "(暂时只收得到文字哦,发文字或 /help 试试)" , // 非文本消息的本地兜底回执
} ,
} ;
function deepMerge ( base , patch ) {
const out = { ... base } ;
for ( const [ k , v ] of Object . entries ( patch || { } ) ) {
const b = base [ k ] ;
if (
v && typeof v === "object" && ! Array . isArray ( v ) &&
b && typeof b === "object" && ! Array . isArray ( b )
) {
out [ k ] = deepMerge ( b , v ) ;
} else {
out [ k ] = v ;
}
}
return out ;
}
function expandEnv ( value ) {
if ( typeof value === "string" ) {
return value . replace ( /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g , ( _m , name ) => {
const v = process . env [ name ] ;
if ( v === undefined || v === "" ) {
console . error ( ` [wxbot] config 引用了 \$ { ${ name } },但环境变量 ${ name } 未设置 ` ) ;
process . exit ( 1 ) ;
}
return v ;
} ) ;
}
if ( Array . isArray ( value ) ) return value . map ( expandEnv ) ;
if ( value && typeof value === "object" ) {
const out = { } ;
for ( const [ k , v ] of Object . entries ( value ) ) out [ k ] = expandEnv ( v ) ;
return out ;
}
return value ;
}
function asList ( v ) {
if ( Array . isArray ( v ) ) return v . map ( ( x ) => String ( x ) . trim ( ) ) . filter ( Boolean ) ;
if ( typeof v === "string" ) return v . split ( "," ) . map ( ( s ) => String ( s ) . trim ( ) ) . filter ( Boolean ) ;
return [ ] ;
}
function loadConfig ( ) {
const cfgPath = process . env . WXBOT _CONFIG || path . resolve ( process . cwd ( ) , "config.yml" ) ;
let fileCfg = { } ;
if ( fs . existsSync ( cfgPath ) ) {
fileCfg = yaml . load ( fs . readFileSync ( cfgPath , "utf8" ) ) || { } ;
} else {
console . warn ( ` [wxbot] 未找到配置文件 ${ cfgPath } ,使用内置默认值 ` ) ;
}
return deepMerge ( DEFAULTS , expandEnv ( fileCfg ) ) ;
}
const CONFIG = loadConfig ( ) ;
// env 兑底(同 agent-core 的 EXECUTOR_URL/EXECUTOR_TOKEN 模式):compose 注入这两个变量后,
// 本服务零配置文件即可上线;config.yml 只在需要改次要旋钮时出现。
CONFIG . auth . tokens = asList ( CONFIG . auth . tokens ) ;
const ENV _TOKEN = String ( process . env . WXBOT _TOKEN || "" ) . trim ( ) ;
if ( ENV _TOKEN && ! CONFIG . auth . tokens . includes ( ENV _TOKEN ) ) CONFIG . auth . tokens . push ( ENV _TOKEN ) ;
CONFIG . core . url = String ( CONFIG . core . url || process . env . CORE _URL || "" ) . trim ( ) . replace ( /\/+$/ , "" ) ;
CONFIG . core . token = String ( CONFIG . core . token || ENV _TOKEN ) . trim ( ) ;
const AUTH _TOKENS = new Set ( CONFIG . auth . tokens ) ;
if ( CONFIG . auth . enabled && AUTH _TOKENS . size === 0 ) {
console . warn ( "[wxbot] tokens 为空且未注入 WXBOT_TOKEN:所有 /api 请求都会被 401 拒绝" ) ;
}
if ( ! CONFIG . core . url ) {
console . warn ( "[wxbot] core.url 未配置且未注入 CORE_URL:收信无法转发给 Agent(实例仍可登录,回复会提示服务未配置)" ) ;
}
fs . mkdirSync ( CONFIG . bot . storage _dir , { recursive : true } ) ;
// ── 鉴权 ─────────────────────────────────────────────────────────────────────
function requireAuth ( req , res , next ) {
if ( ! CONFIG . auth . enabled ) return next ( ) ;
const h = req . headers . authorization || "" ;
const token = h . startsWith ( "Bearer " ) ? h . slice ( 7 ) . trim ( ) : "" ;
if ( ! token || ! AUTH _TOKENS . has ( token ) ) {
return res . status ( 401 ) . json ( { error : "缺少或无效的 Authorization: Bearer <WXBOT_TOKEN>" } ) ;
}
next ( ) ;
}
// ── core 客户端 ─────────────────────────────────────────────────────────
async function corePost ( p , body , timeoutMs = 15000 ) {
const res = await fetch ( CONFIG . core . url + p , {
method : "POST" ,
headers : {
"Content-Type" : "application/json" ,
Authorization : "Bearer " + CONFIG . core . token ,
} ,
body : JSON . stringify ( body ) ,
signal : AbortSignal . timeout ( timeoutMs ) ,
} ) ;
const text = await res . text ( ) . catch ( ( ) => "" ) ;
let data = null ;
try { data = text ? JSON . parse ( text ) : null ; } catch { /* 非 JSON 保留文本 */ }
if ( ! res . ok ) {
const e = new Error ( ( data && data . error ) || text . slice ( 0 , 160 ) || ( "core HTTP " + res . status ) ) ;
e . status = res . status ;
throw e ;
}
return data ;
}
// fire-and-forget: core 不在线/超时只留日志,绝不抛出
function sendHook ( inst , event , extra = { } ) {
corePost ( "/wxhook/hook" , { id : inst . id , event , ... extra } , 8000 )
. catch ( ( e ) => console . warn ( ` [wxbot: ${ inst . id } ] hook( ${ event } ) 上报失败: ${ e . message } ` ) ) ;
}
// ── 实例管理(binding id ↔ WeChatBot)───────────────────────────────────────
// id 只允许安全字符:它直接当存储目录名用(路径穿越防线)。
const ID _RE = /^[A-Za-z0-9_-]{1,64}$/ ;
const instances = new Map ( ) ; // id -> inst
function storageDirOf ( id ) {
return path . join ( CONFIG . bot . storage _dir , id ) ;
}
function setState ( inst , state ) {
if ( inst . state === state ) return ;
inst . state = state ;
console . log ( ` [wxbot: ${ inst . id } ] state → ${ state } ` ) ;
}
function destroyInstance ( id , rmStorage ) {
const inst = instances . get ( id ) ;
if ( ! inst ) return false ;
instances . delete ( id ) ;
inst . dead = true ;
Promise . resolve ( inst . bot ? . stop ? . ( ) ) . catch ( ( ) => { } ) ;
if ( rmStorage ) {
try { fs . rmSync ( storageDirOf ( id ) , { recursive : true , force : true } ) ; }
catch ( e ) { console . warn ( ` [wxbot: ${ id } ] 清理凭证目录失败: ${ e . message } ` ) ; }
}
return true ;
}
function createInstance ( id ) {
if ( instances . has ( id ) ) return instances . get ( id ) ;
const inst = { id , state : "starting" , qrUrl : null , accountId : null , bot : null , dead : false } ;
const callbacks = {
onQrUrl : ( url ) => { inst . qrUrl = String ( url || "" ) ; setState ( inst , "qr" ) ; } ,
onScanned : ( ) => setState ( inst , "scanned" ) ,
onExpired : ( ) => { inst . qrUrl = null ; setState ( inst , "expired" ) ; sendHook ( inst , "expired" ) ; } ,
} ;
const bot = new WeChatBot ( {
storage : "file" ,
storageDir : storageDirOf ( id ) ,
logLevel : CONFIG . bot . log _level ,
loginCallbacks : callbacks ,
} ) ;
inst . bot = bot ;
bot . on ( "login" , ( creds ) => {
inst . accountId = creds ? . accountId ? ? null ;
inst . qrUrl = null ;
setState ( inst , "online" ) ;
sendHook ( inst , "online" , { accountId : inst . accountId } ) ;
} ) ;
bot . on ( "session:restored" , ( creds ) => {
inst . accountId = creds ? . accountId ? ? inst . accountId ? ? null ;
} ) ;
bot . on ( "error" , ( e ) => console . error ( ` [wxbot: ${ id } ] bot error: ` , e ? . message || e ) ) ;
bot . onMessage ( ( msg ) => onIncoming ( inst , msg ) ) ;
instances . set ( id , inst ) ;
// login() + start():有持久凭证则免扫码直接恢复;失败置 error 并上报(expired 已在回调里)
bot . run ( { callbacks } )
. then ( ( ) => { if ( ! inst . dead && inst . state !== "online" ) setState ( inst , "online" ) ; } )
. catch ( ( e ) => {
if ( inst . dead ) return ;
setState ( inst , "error" ) ;
sendHook ( inst , "error" , { note : String ( e ? . message || e ) . slice ( 0 , 200 ) } ) ;
console . error ( ` [wxbot: ${ id } ] 登录/轮询失败: ${ e ? . message || e } ` ) ;
} ) ;
return inst ;
}
// 收信 → 转发 core inbox。命令回执(kind=command)同步回文本;
// 普通消息(kind=message)不回执——最终回复稍后由 core 经 /api/deliver 推过来。
async function onIncoming ( inst , msg ) {
const text = String ( msg ? . text ? ? "" ) . trim ( ) ;
const userId = String ( msg ? . userId ? ? "" ) ;
if ( ! text ) {
try { await inst . bot . reply ( msg , CONFIG . bot . empty _hint ) ; } catch { /* 尽力而为 */ }
return ;
}
inst . bot . sendTyping ( userId ) . catch ( ( ) => { } ) ;
try {
const r = await corePost ( "/wxhook/inbox" , { id : inst . id , from : userId , text } ) ;
if ( r && r . kind === "command" && r . reply ) await inst . bot . send ( userId , r . reply ) ;
} catch ( e ) {
if ( e . status === 404 ) {
// core 侧绑定已删(解绑通知丢失的孤儿实例):告知用户并自毁(连凭证一起清,避免复活再骚扰)
try { await inst . bot . send ( userId , "⚠️ 该微信已解绑,请到 Agent 网页端设置里重新绑定。" ) ; } catch { /* 忽略 */ }
destroyInstance ( inst . id , true ) ;
return ;
}
console . error ( ` [wxbot: ${ inst . id } ] inbox 转发失败: ${ e . message } ` ) ;
try { await inst . bot . send ( userId , "⚠️ Agent 服务异常:" + String ( e . message || e ) . slice ( 0 , 120 ) ) ; } catch { /* 忽略 */ }
}
}
// ── HTTP 服务 ────────────────────────────────────────────────────────────────
const app = express ( ) ;
app . disable ( "x-powered-by" ) ;
app . use ( express . json ( { limit : "1mb" } ) ) ;
app . get ( "/health" , ( _req , res ) => {
res . json ( {
ok : true ,
instances : Array . from ( instances . values ( ) ) . map ( ( i ) => ( { id : i . id , state : i . state } ) ) ,
} ) ;
} ) ;
app . get ( "/api/instances" , requireAuth , ( _req , res ) => {
res . json ( Array . from ( instances . values ( ) ) . map ( ( i ) => ( {
id : i . id , state : i . state , accountId : i . accountId , hasQr : Boolean ( i . qrUrl ) ,
} ) ) ) ;
} ) ;
// 幂等确保实例存在(core 启动恢复 / 新建绑定 / refresh 共用)
app . post ( "/api/instances" , requireAuth , ( req , res ) => {
const id = String ( ( req . body || { } ) . id || "" ) ;
if ( ! ID _RE . test ( id ) ) return res . status ( 400 ) . json ( { error : "非法实例 id" } ) ;
const existed = instances . has ( id ) ;
createInstance ( id ) ;
res . json ( { ok : true , existed } ) ;
} ) ;
// 重发登录流程(二维码过期/失败后用):销毁但不清凭证(有凭证则 refresh 直接恢复在线而不是出二维码)
app . post ( "/api/instances/:id/refresh" , requireAuth , ( req , res ) => {
const id = req . params . id ;
if ( ! ID _RE . test ( id ) ) return res . status ( 400 ) . json ( { error : "非法实例 id" } ) ;
destroyInstance ( id , false ) ;
createInstance ( id ) ;
res . json ( { ok : true } ) ;
} ) ;
// 解绑销毁:停实例 + 删登录凭证(重新绑定需再扫码)
app . delete ( "/api/instances/:id" , requireAuth , ( req , res ) => {
const id = req . params . id ;
if ( ! ID _RE . test ( id ) ) return res . status ( 400 ) . json ( { error : "非法实例 id" } ) ;
res . json ( { ok : true , existed : destroyInstance ( id , true ) } ) ;
} ) ;
// 当前登录二维码(SVG)——core 设置页代理呈现,不经公网
app . get ( "/api/instances/:id/qr.svg" , requireAuth , async ( req , res ) => {
const inst = instances . get ( req . params . id ) ;
if ( ! inst || ! inst . qrUrl ) return res . status ( 404 ) . json ( { error : "当前没有待扫二维码" } ) ;
const svg = await QRCode . toString ( inst . qrUrl , { type : "svg" , margin : 1 } ) ;
res . type ( "image/svg+xml" ) . send ( svg ) ;
} ) ;
// core → wxbot 外发投递(assistant 最终回复,core 已按微信长度分好段)
app . post ( "/api/deliver" , requireAuth , async ( req , res ) => {
const { id , to , text } = req . body || { } ;
const inst = instances . get ( String ( id || "" ) ) ;
if ( ! inst ) return res . status ( 404 ) . json ( { error : "实例不存在" } ) ;
if ( ! to || ! String ( text || "" ) . trim ( ) ) return res . status ( 400 ) . json ( { error : "to/text 不能为空" } ) ;
try {
await inst . bot . send ( String ( to ) , String ( text ) ) ;
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 ) ;
}
app . listen ( CONFIG . server . port , "0.0.0.0" , ( ) => {
console . log ( ` [wxbot] listening on : ${ CONFIG . server . port } , core= ${ CONFIG . core . url || "(未配置)" } , 恢复实例 ${ instances . size } 个 ` ) ;
} ) ;