发行说明：v2.9.5
发布日期: 2026-03-23
概述
v2.9.5 是一个重大功能扩展版本，主要新增了对五个额外即时通讯平台的支持，并进行了全面的架构优化和 Bug 修复。
核心特性
1. 多平台支持扩展
新增支持以下平台：
| 平台 |
状态 |
核心能力 |
| 企业微信 (WeCom) |
✅ 完整支持 |
文本交互、消息收发 |
| Telegram |
✅ 完整支持 |
文本交互、Inline 键盘 |
| QQ (OneBot) |
✅ 完整支持 |
文本交互、群聊支持 |
| WhatsApp |
✅ 完整支持 |
文本交互、媒体消息 |
| 个人微信 (Weixin) |
✅ 完整支持 |
扫码登录、文本交互 |
2. 平台能力对齐
- 全平台能力对齐飞书 baseline
- 统一平台抽象层 (
PlatformSender)
- 支持按平台启用/禁用控制
功能增强
命令系统完善
- 完善微信命令支持
- 完善 Telegram 命令支持
- 统一多平台命令语法
可靠性与稳定性
| 修复项 |
说明 |
| 企业微信消息接收 |
修复企业微信接入收不到消息 BUG |
| 个人微信稳定性 |
修复个人微信相关 BUG |
| 模型配置 |
修复指定默认模型首次会话报错 |
配置管理
- 飞书能力独立开关，匹配后端配置
- 修复
npm run manage:bridge 无法停止 web 后台 BUG
Bug 修复
Windows 兼容性
| 问题 |
状态 |
| Windows 后台运行 BUG |
✅ 已修复 |
| Windows 后台终止问题 |
✅ 已修复 |
| 国内安装报错 |
✅ 已修复 |
| 时区自动判断镜像 |
✅ 已实现 |
显示与文档
| 问题 |
状态 |
| WEB 展示效果优化 |
✅ 已完成 |
| 显示问题修复 |
✅ 已完成 |
| 文档补充 |
✅ 已完成 |
架构优化
| 优化项 |
行为变化 |
状态 |
| 密码比较长度泄露 |
更安全，行为不变 |
✅ |
| 目录查询失败静默 |
仅增加日志，行为不变 |
✅ |
| 卡片动作错误处理 |
返回错误提示而非静默 |
✅ |
| setImmediate 错误处理 |
失败时通知用户 |
✅ |
| 发送文件指令歧义 |
更精确匹配 |
✅ |
| 会话清理时间复杂度 |
性能优化 |
✅ |
| 子进程僵尸进程 |
增加清理逻辑 |
✅ |
| 定时器清理时机 |
更健壮 |
✅ |
| 连接失败错误处理 |
统一错误格式 |
✅ |
| 临时文件清理 |
启动时清理残留 |
✅ |
| 流状态管理器封装 |
重构，API 不变 |
✅ |
| API 路由抽取 |
重构，端点不变 |
✅ |
| 会话存储反向索引 |
性能优化 |
✅ |
| 配置模块拆分 |
重构，导出不变 |
✅ |
| 主入口文件拆分 |
重构，功能不变 |
✅ |
| 日志格式统一 |
已符合规范 |
✅ |
主要涉及文件
src/platform/adapters/
├── wecom-adapter.ts # 企业微信适配器
├── telegram-adapter.ts # Telegram 适配器
├── qq-adapter.ts # QQ 适配器
├── whatsapp-adapter.ts # WhatsApp 适配器
└── weixin-adapter.ts # 个人微信适配器
src/handlers/
├── wecom.ts # 企业微信消息处理
├── telegram.ts # Telegram 消息处理
└── discord.ts # Discord 消息处理
src/utils/
├── text-builder.ts # 统一文本构建器
└── logger.ts # 日志工具
升级指南
升级步骤
# 1. 拉取最新代码
git pull origin beta
# 2. 安装依赖
npm install
# 3. 构建 Web 前端 (如有变更)
cd web && pnpm install && pnpm build
# 4. 重启服务
npm run start
配置新平台
- 访问
http://localhost:4098 进入配置面板
- 在「平台配置」中配置对应平台凭据
- 在「核心路由」中启用对应平台
注意事项
- 平台凭据: 新增平台需在对应平台申请开发者凭据
- 国内镜像: 系统会根据时区自动判断是否使用国内镜像源
- Windows 用户: 已修复多项 Windows 兼容性问题
统计
| 指标 |
数值 |
| 新增平台 |
5 (WeCom, Telegram, QQ, WhatsApp, Weixin) |
| 新增文件 |
10+ |
| 修改文件 |
30+ |
| 架构优化 |
16 项 |
版本历史
v2.9.3-beta → v2.9.5 变更总览
| 阶段 |
版本 |
主要贡献 |
| 起点 |
v2.9.3-beta |
Web 可视化配置中心发布 |
| 功能扩展 |
v2.9.4-beta |
架构优化与可靠性增强 |
| 当前 |
v2.9.5 |
多平台支持扩展与架构优化 |
Full Changelog: v2.9.1...v2.9.5
