wxbot 并入仓库:根 compose 新增 wxbot 服务(仅内网 agent-mcp-net、零配置文件,WXBOT_TOKEN/CORE_URL 由 env 注入);代码/README/.gitignore 入库,凭证与本地 config 继续 gitignore;删除已废弃的 .env.example/config.yml.example,全仓「不入 git」表述翻正

This commit is contained in:
2026-09-27 22:23:17 +08:00
parent b9b5517c3b
commit b4f473a403
9 changed files with 486 additions and 6 deletions
+25
View File
@@ -21,6 +21,11 @@ services:
# 调用鉴权 token:两侧同一值。从 .env 读取(已 gitignore),不再硬编码进仓库;
# 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
# 微信接入(wechat.js ↔ wxbot 服务,同 executor 模式的双向服务 token):由 scripts/init.sh 生成并写进 .env;
# 未设置直接报错避免静默半启用。wxbot 容器没起也不影响 core(探活失败 = 设置页自动隐藏入口);
# .env 置 WXBOT_URL= 可整体关闭微信功能。
- WXBOT_URL=${WXBOT_URL:-http://wxbot:8093}
- WXBOT_TOKEN=${WXBOT_TOKEN:?WXBOT_TOKEN not set - run scripts/init.sh}
networks:
- agent-mcp-net
@@ -123,6 +128,26 @@ services:
networks:
- agent-mcp-net
# 微信接入:iLink 协议多实例调制解调器(agent 栈的私有组件,与 core 共用 WXBOT_TOKEN 互信)。
# 仅挂内网 agent-mcp-net、不暴露任何公网端口:扫码二维码在 agent-core 设置页呈现(core 代理其 /api/instances/:id/qr.svg)。
# 零配置文件:接线全靠下方 env(同 executor 模式);代码在 ./wxbot/(已并入仓库)。
wxbot:
build: ./wxbot/app
image: wxbot:latest
container_name: wxbot
restart: unless-stopped
environment:
- WXBOT_TOKEN=${WXBOT_TOKEN:?WXBOT_TOKEN not set - run scripts/init.sh}
- CORE_URL=http://agent-core:8090
- TZ=Asia/Shanghai
volumes:
- ./wxbot/data:/data # iLink 登录凭证(每绑定一个子目录),等于微信账号权限,勿外泄
# 可选覆盖(端口/日志等级/占位文案):需要时新建 ./wxbot/config.yml 再取消下行注释
# (不能无条件挂载:bind 单文件源不存在时 docker 会建同名目录而不是报错)
# - ./wxbot/config.yml:/app/config.yml:ro
networks:
- agent-mcp-net
networks:
# 全部服务共用一个网络;由本仓库创建(固定名字,避免被加上 compose 项目名前缀),mcp 侧声明为
# external 直接加入 —— 所以全新机器上要【先起 agent,再起 mcp】。
+10 -4
View File
@@ -14,7 +14,7 @@
```
agent/
├── README.md 设计文档(API/数据模型/部署总览)
├── docker-compose.yml 编排:agent-core / agent-executor(+init) / wxbot(微信接入,代码在 ./wxbot 不入 git)
├── docker-compose.yml 编排:agent-core / agent-executor(+init) / wxbot(微信接入)
├── config.yml 运行时配置(含密钥,已 .gitignore)
├── data/ 默认数据卷(任务目录、SQLite、prompt dump)
├── tasks/ 任务目录挂载点(同 ./data 顶层等价,二选一)
@@ -38,7 +38,7 @@ agent/
│ │ ├── llm.js 上游 OpenAI 兼容 /chat/completions 流式调用 + 消息组装
│ │ ├── mcp.js 极简 MCP 客户端(Streamable HTTP,init→tools/list→tools/call)
│ │ ├── remote-exec.js agent-executor 远端执行客户端(SSE 收流)
│ │ ├── wechat.js 微信接入桥接(wechat_bindings 权威 / 实例控制 / inbox / 总线投递;wxbot 为仓库内私有组件不入 git,见 §5.13)
│ │ ├── wechat.js 微信接入桥接(wechat_bindings 权威 / 实例控制 / inbox / 总线投递;对端服务见 wxbot/,§5.13)
│ │ ├── balance.js 余额查询适配器(按 platform.type 分发)
│ │ ├── version.js 版本信息(package.json + git 短提交号)
│ │ ├── tools/
@@ -84,6 +84,12 @@ agent/
│ ├── server.js 零依赖单文件 HTTP 服务(仅 Node 内置 http)
│ └── smoke-test.js Executor 自身冒烟(/health / exec 流式 / 鉴权 / 取消)
│
├── wxbot/ ── 微信接入容器(根 compose 的 wxbot 服务)──
│ ├── app/Dockerfile node:22-slim + @wechatbot/wechatbot / express / js-yaml / qrcode
│ ├── app/src/server.js iLink 多实例调制解调器:实例管理 + /api/{instances,deliver} + 收信转发 core
│ ├── README.md 部署/接口/零配置接线(WXBOT_TOKEN/CORE_URL 全靠 env 注入)
│ └── data/ iLink 登录凭证(gitignore,绝不入库)
│
└── docs/
├── DEPLOY.md 部署(Docker,IP:端口直连)
├── v2-develop.md v2 移动端单聊视图开发说明
@@ -416,9 +422,9 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks`
---
### 5.13 `wechat.js` —— 微信接入桥接(wxbot 为私有组件,不入 git)
### 5.13 `wechat.js` —— 微信接入桥接
背景:仓库内 `wxbot/`(未入库)是基于官方 iLink 协议 SDK 的微信「调制解调器」,只挂 `agent-mcp-net` 内网、不暴露公网;身份权威与全部会话逻辑在 core,引擎不感知微信。
背景:仓库内 `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 代理给页面 `<img>`,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message → 分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`。
+2 -2
View File
@@ -6,7 +6,7 @@
# 用法:
# ./scripts/init.sh # 全用默认值(无模型、admin/admin)
# BIGMODEL_KEY=xxx AUTH_USER=me ./scripts/init.sh # 给几个变量就行
# ./scripts/init.sh --env-only # 只刷新 .env(含同步 wxbot/.env),不动 config.yml
# ./scripts/init.sh --env-only # 只刷新 .env 密钥(幂等,不碰 config.yml)
#
# 输入(都可选):
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(0~3 个)
@@ -48,7 +48,7 @@ AGENT_PORT_INPUT="${AGENT_PORT:-}"
AGENT_PORT="${AGENT_PORT_INPUT:-8090}"
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-}"
AUTH_SECRET="${AUTH_SECRET:-}"
# 微信接入服务 token(core ↔ wxbot 双向共用,compose 两侧同值注入;wxbot/ 子项目不入 git)
# 微信接入服务 token(core ↔ wxbot 双向共用,compose 两侧同值注入;wxbot 已并入仓库)
WXBOT_TOKEN="${WXBOT_TOKEN:-}"
log() { echo -e "\n\033[1;32m===== $* =====\033[0m"; }
+10
View File
@@ -0,0 +1,10 @@
# wxbot 已作为根 compose 的服务并入仓库;以下为本地私密/生成物,不入库
# (.env、node_modules、data 根 .gitignore 同样覆盖,这里重复声明以显式表达意图、双保险)
# 可选覆盖配置——服务零配置文件为默认形态,只有真要改旋钮时才在部署机本地创建
config.yml
.env
node_modules/
data/
*.log
+82
View File
@@ -0,0 +1,82 @@
# wxbot
Agent 栈的微信「调制解调器」:基于官方 iLink 协议的 Node SDK
[`@wechatbot/wechatbot`](https://www.wechatbot.dev/zh/nodejs),同进程多实例,
一个实例对应 agent-core 的一个用户绑定(扫码登录后,该微信里出现 bot 好友,
发给它的消息即进入你的 Agent 会话,回复实时推回)。
**本服务不保存业务状态、不对外服务**:绑定关系(core 用户 ↔ bot 账号)的权威在
agent-core 的 `wechat_bindings` 表;扫码二维码呈现在 agent-core 的 Web 设置页
(账户 → 微信绑定)。本服务已并入根 `docker-compose.yml`(`wxbot` 服务),目录代码已入 git 库;
零配置文件运行,接线全靠 compose 注入的 env(见下)。
## 架构与数据流
```
微信用户 ⇄ [iLink] ⇄ wxbot(本服务, :8093, 仅内网 agent-mcp-net)
│ 收信转发 POST core:/wxhook/inbox {id, from, text}
│ 状态回调 POST core:/wxhook/hook {id, event, accountId?}
│ 接收投递 POST self:/api/deliver ← core 推最终回复
agent-core ⇄ 浏览器 ⇄ core:/api/wechat(cookie 鉴权,绑定管理 + QR SVG 代理)
│ 实例控制 POST/DELETE wxbot:/api/instances*
└ 总线监听 assistant 消息 → 分段投递(游标落库不重发)
```
- 收信 → core `/wxhook/inbox` 复用 **channel 命令层**(`/new /stop /compact /clear /status /help`),
命令回执同步回文本;普通消息(AI 回复)异步由 core 经 `/api/deliver` 推送(`bot.send`)。
- **单线对话**:iLink 扫码登录后只有绑定者本人能与 bot 会话,无陌生人入口,故无联系人授权面。
- 实例凭证按绑定隔离在 `./data/bots/<binding_id>/`,容器重启自动恢复登录免扫码;
启动时扫描该目录逐个拉起实例(core 不在线也照常上线,状态回调失败不影响,首条消息会纠偏)。
- **一个微信账号全集群只允许一个实例在轮询**(SDK 硬约束):绑定表 + wxbot 实例 Map 双重防重。
## 配置:零文件(同 executor 模式)
接线全靠根 compose 注入的环境变量,**不需要 wxbot/.env,也不需要 config.yml**:
| env | 来源 | 用途 |
| --- | --- | --- |
| `WXBOT_TOKEN` | 根 `.env`(`scripts/init.sh` 生成/复用) | 本服务 `/api/*` 鉴权白名单(自动并入)+ 回调 core `/wxhook/*` 的凭据,与 core 侧同一值双向互信 |
| `CORE_URL` | compose 静态注 `http://agent-core:8090` | 转发目标 |
端口、日志等级、非文本消息占位文案等次要旋钮走 `src/server.js` 内置 DEFAULTS;
确需覆盖时按 `config.yml.example` 头部三步说明操作(建文件 + 解开 compose 里注释的挂载行)。
## 部署
```sh
./scripts/init.sh --env-only # 生成/复用根 .env 的 WXBOT_TOKEN(幂等,不碰 config.yml)
docker compose up -d --build wxbot # 首次构建镜像(npm 源可 --build-arg NPM_REGISTRY= 换)
docker compose up -d agent-core # core 带 WXBOT_URL/WXBOT_TOKEN 重建(compose 检测到 env 变化自动 recreate)
```
之后绑定在 **agent-core 的 Web 设置页 → 账户 → 微信绑定** 完成:生成二维码 → 扫一扫 →
手机确认 → 上线;换微信号先解绑再重绑。core 侧关闭微信入口:根 `.env` 置 `WXBOT_URL=`
(设置页自动隐藏,服务零报错)。
## 接口(仅内网可达;除 /health 外需 Bearer WXBOT_TOKEN)
| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/health` | `{ok, instances:[{id,state}]}`,免鉴权 |
| GET | `/api/instances` | 实例列表(core 启动对账用) |
| POST | `/api/instances {id}` | 幂等确保实例存在(新建绑定/重启恢复) |
| POST | `/api/instances/:id/refresh` | 重发登录流程(二维码过期/失败后;保留凭证) |
| DELETE | `/api/instances/:id` | 销毁实例并删登录凭证(解绑) |
| GET | `/api/instances/:id/qr.svg` | 当前登录二维码(core 设置页代理渲染) |
| POST | `/api/deliver {id,to,text}` | 外发投递(core 已按微信长度分段) |
## 本地调试
```sh
set -a && . ./.env && set +a # 仓库根的 .env(WXBOT_TOKEN)
npm --prefix wxbot/app install
WXBOT_TOKEN=$WXBOT_TOKEN CORE_URL=http://127.0.0.1:8090 \
node wxbot/app/src/server.js
```
## 已知边界 / 后续扩展
- 非文本消息(图/语音/文件)目前只回 `bot.empty_hint` 占位。二期:
语音 → SDK `bot.download(msg)` 拿 WAV(需 `silk-wasm`)→ tools/asr `/api/transcribe`;
图片/文件 → core 的 `GET /p/<id>` 公网链喂 `bot.send(userId, {url})`(SDK 自动下载上传 CDN)。
- core 未配 `WXBOT_URL` 时微信功能整体静默关闭(设置页不出现入口,服务零报错)。
+4
View File
@@ -0,0 +1,4 @@
node_modules
npm-debug.log
*.md
data/
+21
View File
@@ -0,0 +1,21 @@
FROM node:22-slim
WORKDIR /app
# 国内构建慢:npm 默认源在国外。想换回官方:
# docker compose build --build-arg NPM_REGISTRY=https://registry.npmjs.org/ wxbot
ARG NPM_REGISTRY=https://mirrors.cloud.tencent.com/npm/
# 复制 package.json 并安装依赖
COPY package.json ./
RUN npm config set registry "$NPM_REGISTRY" && npm install --omit=dev
# 复制源码与页面
COPY . .
EXPOSE 8093
# 微信 iLink 多实例调制解调器(agent 栈私有组件,根 compose 的 wxbot 服务),监听 8093;
# 零配置文件:接线全靠 compose 注入的 WXBOT_TOKEN/CORE_URL(见 wxbot/README);
# iLink 登录凭证持久化在 /data(每绑定一个子目录,compose 挂 ./wxbot/data)
CMD ["node", "src/server.js"]
+20
View File
@@ -0,0 +1,20 @@
{
"name": "wxbot",
"version": "1.0.0",
"description": "wxbot.foresh.com: WeChat iLink bot console - QR login page + echo bot via @wechatbot/wechatbot",
"type": "module",
"main": "src/server.js",
"scripts": {
"start": "node src/server.js"
},
"engines": {
"node": ">=22"
},
"license": "ISC",
"dependencies": {
"@wechatbot/wechatbot": "^2.2.0",
"express": "^4.21.0",
"js-yaml": "^4.1.0",
"qrcode": "^1.5.4"
}
}
+312
View File
@@ -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} 个`);
});