4.7 KiB
企业微信升级自动适配修复
使用
退出正在运行的旧版客服助手,再打开:
C:\wechat_rpa\dist\auto-adaptation\ZhenAI-WeCom-Assistant-v1.5.1\ZhenAI-WeCom-Assistant-v1.5.1.exe
这是本地修复构建,保留当前工程版本号 1.5.1,尚未发布云端更新。 整个程序目录必须一起保留,不能只复制 EXE。原客户端配置仍使用当前 Windows 用户的数据目录。
在“自动化设置 → 协议模式”点击“检测本机协议”。本机 5.0.11.6029 的预期状态为: 自动适配完成,待首次发送验证。
本次按用户选择只进行了无消息检测。首次启用这个新构建时, 仍需在界面的“首次发送验证”中指定专用测试单聊并确认;取得服务器回执且核对账号、 会话和正文后,才开放该账号的协议自动回复。本次没有执行这个发送步骤。
修复内容
原程序在发现未登记的补丁号后立即退出检测;截图中的 6029 因此无法进入账号和消息库检查。
现在先保留已登记构建的精确匹配,对新构建自动执行:
- 校验 x86 PE 文件、节区和地址边界。
- 从类型信息定位消息服务、登录服务及服务管理器虚函数表。
- 完整匹配 9 个函数,共 6,656 字节,保留对象字段偏移、分支和栈清理。 只允许已登记的地址操作数变化,并核对跨函数指针及调用关系。
- 要求工厂函数和服务根指针的完整关系唯一匹配。
- 校验运行中客户端的 12 个区域,正确处理 ASLR 地址重定位。
- 按完整文件 SHA-256 缓存布局;每次发送仍核对实际客户端文件、登录身份和实时接口。
- 首次发送验证绑定文件哈希和适配规则修订号。同一版本号的不同构建不会复用旧回执或去重键。
不会通过修改版本白名单、复用旧地址或伪造“已验证”标记启用新客户端。 自动定位使用 Python 标准库;用户电脑不需要安装 Capstone、pefile 或开发环境。
已完成验证(2026-09-28)
- 37 项相关回归测试通过:22 项新测试,以及既有回执证据和发送账本的 15 项测试。
- JavaScript 完整语法检查、协议卡片渲染检查通过。
- Python 语法检查和 Git 空白差异检查通过。
- 源码对本机 5.0.11.6029 的实际接口、登录身份和消息库检测通过,约 4.63 秒。
- 独立修复 EXE 的打包自检通过,退出码 0,使用临时数据目录和精简 PATH。
- 修复 EXE 的实际协议检测通过,退出码 0;包含深度文件检查,约 11.70 秒。
- 两次实际检测均为
native_validation_required:autoAdapted=true、loginVerified=true、databaseReady=true、canSend=false。 - 没有发送真实消息,也没有声称发送或服务器回执已实测成功。
记录位于 protocol-validation-reports:
auto-adaptation-tests.jsonauto-adaptation-6029-readonly.jsonauto-adaptation-6029-packaged.jsonauto-adaptation-acceptance.json
新增测试可用以下命令复现(不发送消息):
.\.build-venv\Scripts\python.exe -X utf8 -B -m unittest test_wecom_native_adaptation -v
兼容范围
自动适配依据接口结构,而不是补丁号。只移动地址、保持上述调用结构的升级可自动定位; 即使版本号不在登记表中,也可以完成适配。
不能保证未来所有企业微信版本自动兼容。x64/ARM64、对象结构、调用约定、回执结构或核心函数 发生变化时,需要更新适配规则。接口匹配不唯一或运行中代码不一致时,程序会说明失败原因并 保留报告入口。升级后先完成检测和新构建的首次验证,再启动协议监听。
维护
后续本机验证:经用户授权,已向高瑞发送一次“协议通道测试,请忽略”,服务器回执和
本地消息库均确认成功。详情见 protocol-validation-reports/gaorui-protocol-test-20260928.json
及 gaorui-after-send-20260928.json,后者状态为 native_ready。
随后修复了旧运行目录缺失控制台等资源的问题,完整修复版安装位置为
dist/ZhenAI-WeCom-Assistant-v1.5.1。原构建目录 dist/auto-adaptation 中的应用已移入
该位置;安装摘要及旧目录备份位置见 protocol-validation-reports/console-repair-installation.json。
主要实现:wecom_native_adaptation.py;
特征数据:wecom_native_signatures.py;
测试:test_wecom_native_adaptation.py。
tools/generate_wecom_signatures.py 仅用于开发期生成特征,
要求已审查的 6018 客户端原始 SHA-256 完全一致。修改函数契约时必须审查实际调用方式、
更新特征修订号并重新验证发送。不得仅为了匹配新版本而放宽结构检查。