修復webhok，消息穩定不掉，同時登錄沒按鈕，可以切換win 或者車載接口，登錄成功在退出，用原key使用pad進行掃描登錄，後期新登錄通過喚醒登錄默認支持自動心跳二次登錄

#135 #135
多种登录方式支持
✅ 二维码登录 - 支持获取登录二维码，绕过验证码流程
✅ 验证码登录 - 自动处理验证码提交，无需手动获取ticket
✅ 短信登录 - 支持短信验证码登录方式
✅ 设备登录 - 支持A16数据登录和设备ID登录
2. 自动验证码处理
✅ 自动获取ticket - 系统自动从Redis或状态缓存中获取ticket
✅ 自动生成data62 - 如果data62为空，系统会自动根据设备信息生成
✅ 多重数据源 - 从Redis、状态缓存、用户信息、连接管理器等多个来源获取ticket
✅ 智能参数验证 - 自动检查必要参数，提供友好错误提示
3. 实时状态检测
✅ 登录状态监控 - 实时检测扫码状态和登录进度
✅ 验证码状态跟踪 - 自动识别是否需要验证码
✅ 连接健康检查 - 实时监控连接状态，自动检测连接健康度
✅ 心跳监控 - 增加心跳时间记录，超过10秒无心跳认为连接不健康
4. RabbitMQ消息队列支持
✅ 智能重连机制 - 只在连接确实断开时才重连，避免频繁重连
✅ 连接健康检查 - 实时监控连接状态，自动检测连接健康度
✅ 并发安全 - 使用互斥锁确保重连过程的线程安全
✅ 消息持久化 - 确保消息在服务器重启后不丢失
5. 多账号管理
✅ 多账号并行 - 支持同时管理多个微信账号
✅ 账号隔离 - 每个账号独立运行，互不影响
✅ 统一管理 - 通过统一接口管理所有账号状态
6. 自动Token刷新
✅ 自动刷新 - 系统自动检测并刷新过期的Token
✅ 无缝切换 - Token刷新过程中不影响正常使用
✅ 状态同步 - 刷新后自动同步所有相关状态

Webhook配置详细说明

配置文件：webhook_config.json

基础配置

{
    "url": "http://192.168.0.101:8000/webhook",           // Webhook接收端点URL
    "secret": "your_secret_key_2024_enhanced_v1",          // 用于消息签名验证的密钥（建议32字符以上）
    "enabled": true,                                        // 是否启用Webhook功能
    "timeout": 10,                                          // HTTP请求超时时间（秒）
    "retryCount": 3,                                        // 失败重试次数
    "messageTypes": ["*"],                                  // 要接收的消息类型
    "includeSelfMessage": true,                             // 是否包含自己发送的消息
    "wxId": "",                                             // 微信ID，用于消息过滤
    "useDirectStream": true,                                // 启用直接消息流（零延迟推送）
    "useRedisSync": false,                                  // 是否使用Redis同步（独立模式建议关闭）
    "independentMode": true,                                // 启用完全独立模式（与WebSocket消息流分离）
    "lastSendTime": 0,                                      // 最后发送消息的时间戳（系统自动维护）
    "lastSendStatus": false,                                // 最后一次发送的状态（系统自动维护）
    "totalSent": 0,                                         // 总发送消息数量（系统自动维护）
    "totalFailed": 0                                        // 总失败消息数量（系统自动维护）
}

配置项详解

🔧 基础配置

🌐 网络配置

📨 消息过滤配置

⚡ 独立模式配置

📊 统计信息字段（系统自动维护）

消息类型说明

支持的消息类型

{
    "messageTypes": ["*"]           // 接收所有消息类型
}

或者指定特定类型：

{
    "messageTypes": ["1", "3", "47", "49"]  // 只接收文本、图片、表情、链接消息
}

消息类型对照表

配置示例

示例1：客服系统配置

{
    "url": "https://customer-service.company.com/webhook",
    "secret": "cs_webhook_secure_key_2024",
    "enabled": true,
    "timeout": 8,
    "retryCount": 3,
    "messageTypes": ["1", "3", "47", "49"],
    "includeSelfMessage": true,
    "useDirectStream": true,
    "useRedisSync": false,
    "independentMode": true,
    "wxId": "",
    "lastSendTime": 0,
    "lastSendStatus": false,
    "totalSent": 0,
    "totalFailed": 0
}

示例2：营销自动化配置

{
    "url": "https://marketing-bot.company.com/webhook",
    "secret": "marketing_automation_key_2024",
    "enabled": true,
    "timeout": 5,
    "retryCount": 2,
    "messageTypes": ["*"],
    "includeSelfMessage": false,
    "useDirectStream": true,
    "useRedisSync": false,
    "independentMode": true,
    "wxId": "",
    "lastSendTime": 0,
    "lastSendStatus": false,
    "totalSent": 0,
    "totalFailed": 0
}

示例3：多账号管理配置

{
    "url": "https://multi-account.company.com/webhook",
    "secret": "multi_account_key_2024",
    "enabled": true,
    "timeout": 10,
    "retryCount": 3,
    "messageTypes": ["*"],
    "includeSelfMessage": true,
    "useDirectStream": true,
    "useRedisSync": false,
    "independentMode": true,
    "wxId": "wxid_abc123def456",
    "lastSendTime": 0,
    "lastSendStatus": false,
    "totalSent": 0,
    "totalFailed": 0
}

示例4：高性能生产环境配置

{
    "url": "https://high-performance.company.com/webhook",
    "secret": "hp_production_key_2024",
    "enabled": true,
    "timeout": 3,
    "retryCount": 1,
    "messageTypes": ["1", "3"],
    "includeSelfMessage": false,
    "useDirectStream": true,
    "useRedisSync": false,
    "independentMode": true,
    "wxId": "",
    "lastSendTime": 0,
    "lastSendStatus": false,
    "totalSent": 0,
    "totalFailed": 0
}

最佳实践

🔒 安全配置

• 使用HTTPS协议（生产环境）
• 使用强密钥（≥32字符）
• 定期更换密钥
• 实现签名验证

⚡ 性能优化

• 合理设置超时时间（5-10秒）
• 适当的重试次数（1-3次）
• 启用独立模式
• 过滤不需要的消息类型

🛡️ 稳定性保证

• 实现幂等性处理
• 添加消息去重机制
• 设置健康检查
• 监控Webhook状态

故障排查

常见问题

1. Webhook无法接收消息

   • 检查URL是否可访问
   • 确认配置是否启用（enabled: true）
   • 验证消息类型过滤是否正确

2. 消息延迟或丢失

   • 确保useDirectStream为true
   • 确保useRedisSync为false
   • 确保independentMode为true

3. 频繁重试失败

   • 检查服务端是否正常响应
   • 调整超时时间
   • 减少重试次数

4. 签名验证失败

   • 确认密钥是否正确
   • 检查签名算法是否一致
   • 验证时间戳是否在有效范围内

版本信息

• 配置文件版本: v2.0
• 更新时间: 2025-07-21
• 适用版本: WeChatPadPro v8.6.1+
• 配置格式: JSON

WeChatPadPro:基於WeChat Pad協議的高級管理工具【穩定版】

修復頻繁掉綫
修復webhook參數不全
修復ws掉綫大量推送信息
修復webhook頻繁掉綫
修復强制退出問題
修復修復消息啓動后頻繁推送重複消息
重購消息隊列

📢 重要！老用戶必讀

如果您是長期使用WeChatPadPro的用戶，請先閱讀本節內容！

為避免首次啓動或長時間未使用後啓動時收到大量過期消息，我們強烈建議：

1. 先運行 start_webhook_client.bat(Windows) 或 start_webhook_client.sh(MacOS/Linux) 啓動消息緩存服務
2. 然後再啓動主程序

詳細教程： 請參閱 usage_guide_for_old_users.md 文件

項目簡介

WeChatPadPro是一個跨平臺應用程序，支持Windows、MacOS、Linux、FreeBSD和OpenBSD等多種操作系統和架構。

支持平臺

• Windows PC (64-bit)
• Windows ARM64設備
• Mac (Intel CPU)
• Mac (M1/M2 CPU)
• Linux (多種架構: amd64, arm64, mips64, mips64le, ppc64, ppc64le, riscv64)
• FreeBSD (amd64, arm64)
• OpenBSD (amd64, arm64)

安裝說明

1. 下載對應您系統的壓縮包：wechatpadpro_v{版本號}_{構建日期}_{平臺}.zip
2. 解壓縮文件到任意目錄
3. 配置環境變量(可選)

配置說明

1. 在程序目錄中複製.env.example文件並重命名為.env
2. 根據需要修改.env文件中的配置項
3. 根據需要修改webhook_config.json配置文件

運行方法

🔴 老用戶推薦啓動順序

1. 運行 webhook 客戶端（避免大量消息堆積）

   • Windows: 雙擊 start_webhook_client.bat
   • MacOS/Linux: 執行 ./start_webhook_client.sh

2. 啓動主程序

   • Windows: 雙擊 run.bat
   • MacOS/Linux: 執行 ./run.sh

Windows系統

# 在命令提示符或PowerShell中
cd 程序目錄路徑
.\run.bat

MacOS/Linux/BSD系統

# 在終端中
cd 程序目錄路徑
chmod +x ./run.sh
./run.sh

常見問題

如遇到權限問題，請確保二進制文件具有執行權限：

chmod +x ./wechatpadpro-*

版本信息

當前版本: ios18.61-861
構建時間: 2025-07-18

每個發行版中包含version.txt文件，其中包含詳細的構建信息和平台支持情況。

WeChatPadPro v18.6 版本说明

版本信息

• 版本号：18.6
• 构建时间：2025年7月4日
• 发布日期：2025年7月4日

产品简介

WeChatPadPro 是一款功能强大的微信辅助工具，支持多平台部署，提供API接口实现微信功能的自动化操作。本版本进一步优化了系统稳定性，增强了跨平台兼容性，并新增了多项实用功能。

主要特性

1. 核心功能

• 微信消息管理：自动接收、发送和管理微信消息
• 联系人管理：批量管理好友、群组和标签
• 自动回复：支持关键词触发的智能回复
• 消息转发：支持多渠道消息转发
• 文件发送：支持发送各类文件，包括图片、视频、文档等
• 修复wxmcp工具集
• Webhook集成：支持通过Webhook接收消息通知并触发自定义事件
• 登录验证：支持扫码登录和验证码登录，提供安全认证机制
• API接口：提供RESTful API接口，方便与其他系统集成

2. v18.6 新增功能

• 授权码管理优化：改进了授权码授权设备管理api接口
• 远程Docker支持：新增对远程Docker环境的支持
• 多平台构建优化：支持更多操作系统和CPU架构
• 数据库连接增强：优化了数据库连接池和错误处理
• Webhook配置增强：支持更多Webhook触发事件和自定义配置
• 文件传输加速：优化了大文件传输性能和稳定性
• 验证码识别：集成验证码自动识别功能，提高登录成功率

3. 性能优化

• 降低了CPU和内存占用
• 优化了网络连接处理
• 提高了大规模消息处理的效率
• 改进了错误处理和日志记录
• 加速了文件传输和处理速度
• 提高了Webhook响应速度

支持平台

WeChatPadPro v18.6 支持以下操作系统和CPU架构：

安装说明

1. 系统要求

• 操作系统：Windows 7+、macOS 10.13+、Linux (内核 3.10+)、FreeBSD 12+、OpenBSD 6.8+
• 内存：至少 2GB RAM
• 存储：至少 200MB 可用空间
• 网络：稳定的互联网连接
  wechatpadpro_v18.6_20250704_linux-ppc64le.zip

2. 安装步骤

1. 下载：根据您的操作系统和CPU架构，从上表中选择对应的压缩包下载。
2. 解压：将下载的压缩包解压到您选择的目录。
3. 配置：
   • 修改 config.json 文件，设置必要的参数
   • 配置 webhook_config.json 文件，设置Webhook相关参数
   • 设置环境变量（可选）：

     # Linux/macOS
     export ADMIN_KEY="您的管理密钥"
     
     # Windows
     $env:ADMIN_KEY="您的管理密钥"
     

4. 运行：
   • Windows: 双击 wechatpadpro.exe 或在命令行中运行
   • Linux/macOS/BSD: 执行 ./wechatpadpro

功能使用说明

1. 文件发送

WeChatPadPro 支持发送多种类型的文件，包括图片、视频、文档等。

POST /api/v1/message/sendFile
Content-Type: multipart/form-data

{
  "toUserName": "接收者微信ID",
  "filePath": "本地文件路径",  // 与fileData二选一
  "fileData": "base64编码的文件数据",  // 与filePath二选一
  "fileName": "文件名称",
  "fileType": "文件类型"  // 可选值: image, video, file
}

2. Webhook配置

Webhook 可以将微信消息实时推送到您指定的URL。配置方法：

1. 编辑 webhook_config.json 文件：

{
  "enabled": true,
  "url": "http://您的服务器地址/webhook/receiver",
  "events": ["message", "login", "logout", "friend_request"],
  "retry_count": 3,
  "retry_interval": 5,
  "secret_key": "您的密钥"
}

2. 接收Webhook消息的服务器需要处理POST请求，消息格式为：

{
  "event_type": "message",
  "timestamp": 1656789012,
  "data": {
    // 事件相关数据
  },
  "signature": "消息签名"
}

3. 登录验证

WeChatPadPro 支持多种登录验证方式：

1. 扫码登录：

GET /api/v1/login/qrcode

返回二维码图片，扫描后完成登录。

2. 验证码登录：

POST /api/v1/login/sms
Content-Type: application/json

{
  "phone": "手机号码"
}

3. 提交验证码：

POST /api/v1/login/verify
Content-Type: application/json

{
  "phone": "手机号码",
  "code": "验证码"
}

授权说明

使用本软件需要有效的授权码。您可以通过以下方式获取授权码：

1. 使用管理员密钥生成授权码：

   POST /api/v1/admin/genAuthKey?key=您的管理员密钥
   Content-Type: application/json
   
   {
     "count": 1,
     "days": 30,
     "remark": "测试授权"
   }
   

2. 激活授权码：

   POST /api/v1/auth/activate
   Content-Type: application/json
   
   {
     "authKey": "您的授权码"
   }
   

常见问题

1. Q: 如何检查服务是否正常运行？
   A: 访问 http://您的服务器IP:8080/api/v1/health 查看服务状态。

2. Q: 授权码验证失败怎么办？
   A: 请确认授权码未过期且输入正确，如问题持续存在，请联系技术支持。

3. Q: 如何更新到最新版本？
   A: 下载最新版本并替换原有文件，保留您的配置文件和数据目录。

4. Q: 支持哪些消息队列？
   A: 支持 RocketMQ、RabbitMQ 和 Kafka，可在配置文件中选择。

5. Q: Webhook 推送失败怎么办？
   A: 检查网络连接、目标服务器状态，以及 webhook_config.json 配置是否正确。

6. Q: 如何处理登录验证码无法接收的问题？
   A: 确认手机号码正确、短信服务正常，或尝试使用扫码登录方式。

更新日志

v18.6 (2025-07-04)

• 新增：Swagger文档嵌入功能
• 新增：Docker支持
• 新增：Webhook配置增强功能
• 新增：文件传输加速优化
• 新增：验证码识别功能
• 优化：授权码管理机制
• 优化：数据库连接处理
• 修复：多个稳定性问题
  wechatpadpro_v18.6_20250704_linux-arm64.zip
  wechatpadpro_v18.6_20250704_linux-mips64.zip
  wechatpadpro_v18.6_20250704_linux-mips64le.zip
  wechatpadpro_v18.6_20250704_linux-ppc64.zip