From b4f473a40360c6370fb0d546c10164c4715ea0cd Mon Sep 17 00:00:00 2001 From: kicer Date: Sun, 27 Sep 2026 22:23:17 +0800 Subject: [PATCH] =?UTF-8?q?wxbot=20=E5=B9=B6=E5=85=A5=E4=BB=93=E5=BA=93?= =?UTF-8?q?=EF=BC=9A=E6=A0=B9=20compose=20=E6=96=B0=E5=A2=9E=20wxbot=20?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1=EF=BC=88=E4=BB=85=E5=86=85=E7=BD=91=20agent-?= =?UTF-8?q?mcp-net=E3=80=81=E9=9B=B6=E9=85=8D=E7=BD=AE=E6=96=87=E4=BB=B6?= =?UTF-8?q?=EF=BC=8CWXBOT=5FTOKEN/CORE=5FURL=20=E7=94=B1=20env=20=E6=B3=A8?= =?UTF-8?q?=E5=85=A5=EF=BC=89=EF=BC=9B=E4=BB=A3=E7=A0=81/README/.gitignore?= =?UTF-8?q?=20=E5=85=A5=E5=BA=93=EF=BC=8C=E5=87=AD=E8=AF=81=E4=B8=8E?= =?UTF-8?q?=E6=9C=AC=E5=9C=B0=20config=20=E7=BB=A7=E7=BB=AD=20gitignore?= =?UTF-8?q?=EF=BC=9B=E5=88=A0=E9=99=A4=E5=B7=B2=E5=BA=9F=E5=BC=83=E7=9A=84?= =?UTF-8?q?=20.env.example/config.yml.example=EF=BC=8C=E5=85=A8=E4=BB=93?= =?UTF-8?q?=E3=80=8C=E4=B8=8D=E5=85=A5=20git=E3=80=8D=E8=A1=A8=E8=BF=B0?= =?UTF-8?q?=E7=BF=BB=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docker-compose.yml | 25 ++++ docs/ARCHITECTURE.md | 14 +- scripts/init.sh | 4 +- wxbot/.gitignore | 10 ++ wxbot/README.md | 82 +++++++++++ wxbot/app/.dockerignore | 4 + wxbot/app/Dockerfile | 21 +++ wxbot/app/package.json | 20 +++ wxbot/app/src/server.js | 312 ++++++++++++++++++++++++++++++++++++++++ 9 files changed, 486 insertions(+), 6 deletions(-) create mode 100644 wxbot/.gitignore create mode 100644 wxbot/README.md create mode 100644 wxbot/app/.dockerignore create mode 100644 wxbot/app/Dockerfile create mode 100644 wxbot/app/package.json create mode 100644 wxbot/app/src/server.js diff --git a/docker-compose.yml b/docker-compose.yml index f9255a4..fac7922 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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】。 diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 75ed72b..eba83ba 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -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 代理给页面 ``,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message → 分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`。 diff --git a/scripts/init.sh b/scripts/init.sh index f6074e5..648a76f 100755 --- a/scripts/init.sh +++ b/scripts/init.sh @@ -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"; } diff --git a/wxbot/.gitignore b/wxbot/.gitignore new file mode 100644 index 0000000..dd9a3ec --- /dev/null +++ b/wxbot/.gitignore @@ -0,0 +1,10 @@ +# wxbot 已作为根 compose 的服务并入仓库;以下为本地私密/生成物,不入库 +# (.env、node_modules、data 根 .gitignore 同样覆盖,这里重复声明以显式表达意图、双保险) + +# 可选覆盖配置——服务零配置文件为默认形态,只有真要改旋钮时才在部署机本地创建 +config.yml + +.env +node_modules/ +data/ +*.log diff --git a/wxbot/README.md b/wxbot/README.md new file mode 100644 index 0000000..f58fd1a --- /dev/null +++ b/wxbot/README.md @@ -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//`,容器重启自动恢复登录免扫码; + 启动时扫描该目录逐个拉起实例(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/` 公网链喂 `bot.send(userId, {url})`(SDK 自动下载上传 CDN)。 +- core 未配 `WXBOT_URL` 时微信功能整体静默关闭(设置页不出现入口,服务零报错)。 diff --git a/wxbot/app/.dockerignore b/wxbot/app/.dockerignore new file mode 100644 index 0000000..52357dc --- /dev/null +++ b/wxbot/app/.dockerignore @@ -0,0 +1,4 @@ +node_modules +npm-debug.log +*.md +data/ diff --git a/wxbot/app/Dockerfile b/wxbot/app/Dockerfile new file mode 100644 index 0000000..9a533b4 --- /dev/null +++ b/wxbot/app/Dockerfile @@ -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"] diff --git a/wxbot/app/package.json b/wxbot/app/package.json new file mode 100644 index 0000000..7c093e1 --- /dev/null +++ b/wxbot/app/package.json @@ -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" + } +} diff --git a/wxbot/app/src/server.js b/wxbot/app/src/server.js new file mode 100644 index 0000000..cbe93ae --- /dev/null +++ b/wxbot/app/src/server.js @@ -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//(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 " }); + } + 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} 个`); +});