Files
xieyi-weixin-/NATIVE_PROTOCOL_TRIAL.md
T
2026-09-21 10:56:48 +08:00

14 KiB
Raw Blame History

2026-09-15 安全状态更正:1.4.11 虽然完成实发回执验证,随后被 Defender 以 Behavior:Win32/DefenseEvasion.A!ml 隔离。以下是功能验证历史,不能据此认定适合分发。详见 安全复核记录。

原账号协议自动回复:1.4.11 验收记录

2026-09-15,企业微信 Windows 5.0.10.6023 x86。

普通聊天的 MessageService 已实际调用成功。2026-09-15 09:51:01,以当前原员工账号“高兴亮”向现有“高瑞”会话发送一条“协议通道测试,请忽略”,获得客户端成功回调。数据库按账号、会话、原发送人和完整文本复核成功,消息 ID 570,服务器消息 ID 1023368。该回执表示发送成功,不代表客户已读。

正式 1.4.11 EXE 于 10:18:16 完成第二次真实发送验收:原账号“高兴亮” → 现有“高瑞”会话,文本“协议通道测试,请忽略”,消息 ID 571,服务器消息 ID 1023370。客户端返回成功,数据库验证原发送人和全文一致。

随后用同一 EXE 重放同一测试请求,返回完全相同的已确认回执;数据库前后仍只有上述两条测试消息,新增重复消息为 0。真实发送累计两条:一次研究原型,一次最终 EXE。未启动面向其他客户的自动监听。

最终构建完成 Qt WebEngine、干净 PATH 下 HTTPS/证书、自动解密、消息导航、视觉发送保护及数据库回复等随包自检。静态检查确认最终 EXE 包含上下文设置修正和正式协议模块,未包含研究注入原型。

EXE:C:/wechat_rpa/dist/ZhenAI-WeCom-Assistant-v1.4.11/ZhenAI-WeCom-Assistant-v1.4.11.exe。SHA-256:36dfa102dba15aba618c246ce613a03fce6b0fbdce2fd3c2f1ed11a456b6878a。 验收证据:native_protocol_acceptance_v1.4.11.json、tmp/packaged-native-send-v1.4.11.json、tmp/packaged-native-replay-v1.4.11.json、tmp/protocol-v1.4.11-final-build.log。

已实现

  • wecom_native_sender.py:当前登录身份检查、原有单聊消息服务调用、服务器回执与数据库复核、SQLite 持久化发送去重。
  • wecom_native_stub.py:离线生成的固定调用序列,运行时没有汇编器依赖。
  • protocol_engine.py:数据库增量文本监听、连续消息合并、AI 回复、审核放行、发送前会话变化检查、成功归档。
  • Qt 自动化设置:协议就绪状态、账号、自动/审核发送、合并与发送等待设置。
  • 协议队列保存在 pending_replies.protocol.json,发送结果保存在 protocol_sends.sqlite3。与视觉队列独立。
  • 发送结果不明确时暂停并保留任务,禁止自动重发;同一请求的成功回执跨重启复用。

最终在构建用 Python 3.12 中共 149 项回归通过:66 项协议/SDK/界面测试,以及83项共用设置与视觉队列回归。Python 3.11 的对应兼容性测试也已通过。隔离测试覆盖新消息作废旧回复、人工回复、同名会话、切换账号、取消、停止、审核、超时、重复调用和重启。

适用范围

需要企业微信保持登录,且本机消息数据库可以读取。当前适配的是已校验 SHA-256 的 5.0.10.6023 x86 客户端;客户端更新或入口改变会阻止发送。

本版自动处理和发送文本,单条最大 4096 UTF-8 字节。图片、语音等新消息留待人工处理。启动后处理新到的消息及原有协议待办,不批量回复历史聊天。

调用发生在运行中的企业微信消息服务,使用临时分配的一次性调用缓冲区;不操作鼠标、键盘或聊天输入框,不修改企业微信原有代码。它依赖本机企业微信客户端,不是可脱离客户端登录的独立网络协议实现。

之前的内置 WeClaw MCP 业务接口仍受灰度限制;本版使用经实际验证的普通聊天消息服务。以下记录是之前不同路径的历史测试结论。


2026-09-15 最新实测:原生连接已通,业务接口未开放

用户在明确知悉通道密钥读取和独立代理一次性代码执行方式后回复“全部授权”,本次重新提交的工具执行已获批准。仅对自己创建的隔离官方代理执行握手代码,主企业微信进程只读40字节本地通道状态,没有写入或修改主进程。通道密钥未写入报告。

实际结果:

  • initialize 成功:HTTP 200,weclaw-mcp / 1.0.0,协议版本 2025-03-26。
  • tools/list 成功:返回7个工具,包含 wecom_tool。
  • 工具清单声明的 arguments.data 返回参数错误;代理实际使用的 arguments.payload(内含 headers_json、arguments_json)可进入业务响应。
  • 使用完整官方代理请求头,openclaw/get_user_initialization_info 和最近一天 msg/get_msg_chat_list 均返回 -90020005 / user not in gray。帮助请求也返回同一错误。
  • 错误位于 HTTP 200 内多层 JSON 的 data.error,HTTP成功不能视为业务成功。
  • 当前尚未通过原账号身份、目标会话、发送和回执验收;没有向“小迷糊”或“高瑞”发送测试消息。

当前证据表明账号未进入该接口开放范围,不能用已成功的握手宣称协议自动回复可用。未修改功能准入开关。需要账号获得该接口的开放资格后,再进行业务验收。

成功测试代理PID为3252、3460、11596、13112,均由本次研究创建并已退出;进程监视器记录中的这些代理启动不代表客户端自行启动了智能体。

已新增 wecom_native_protocol.py:解析真实嵌套业务错误,并提供不含密钥和聊天正文的历史诊断。界面分别显示SDK运行时与“原生MCP上次实测”,明确记录时间、适用版本和非实时状态;历史报告不能启用发送。研究注入原型保持在 tmp 中,没有并入普通检测流程或EXE。

证据:logs/wecom-native-trial.json、tmp/official-agent-native-bridge/initialize-result.json、tools-list-result.json、identity-with-agent-header-result.json、chat-list-result.json。

本次更新已打包为 v1.4.10:C:/wechat_rpa/dist/ZhenAI-WeCom-Assistant-v1.4.10/ZhenAI-WeCom-Assistant-v1.4.10.exe,需保留同目录 _internal。37项单元/Qt回归通过,打包自检及新EXE实机诊断通过;EXE SHA256:9bb61f59be11799e0e096f4208c4cbec0920f6d4c931b30ebc7e46ddb91646a0。打包内容检查确认研究注入脚本、实测历史和密钥未进入发布包;本机脱敏历史单独保存在应用数据目录。该版本更新的是诊断能力,协议自动回复仍未就绪。

以下为先前分析记录,其中“未执行/待授权/待连接”描述只适用于对应历史阶段。


企业微信本机加密协议实测

日期:2026-09-14。目标:以原员工账号回复已有客户;授权测试对象为“小迷糊”或“高瑞”,文本为“协议通道测试,请忽略”。

结果:已完成本地 TCP 加密结构的静态分析,并执行加密 MCP 初始化尝试;连接在发送请求之前就会被关闭。未建立 MCP 会话,没有获取消息工具或调用原账号发送接口,没有向测试客户发送消息。

实际执行与结果

项目 实际结果
客户端 WXWork.exe 5.0.10.6023,x86;执行前核对整文件 SHA-256
服务归属 9882、9883、50018、50010 回环监听归属当时的 WXWork.exe PID 12612
本地加密状态 以只读权限读取已定位的 40 字节状态:密钥长度 32 字节、初始化标志 1;密钥不输出、不写入报告或文件
加密初始化尝试 对 127.0.0.1:9882 发送 AES 加密的 HTTP/MCP initialize 请求,两个收发方向组合均未收到响应,连接被重置
请求前检查 新建同端口 TCP 连接后不发送任何字节,连接已关闭(recv 返回 EOF);证据记录 requestSent=false
登录与客户映射 没有获得在线协议身份或可调用会话接口,仍未验证
真实发送、回执 未执行、未验证;不得计入已发送或协议可用

这次失败发生在应用请求前,不能用“JSON 参数不正确”“缺少 chatid”解释。静态代码存在来源进程和签名检查,与观察到的立即关闭行为相符;没有运行时日志证明具体拒绝分支,不能把该推断写成已确定的错误码。

已定位的实现

程序 SHA-256:47b5dfafc8def0b41a648610f1ba08bbf15f710c6f81c08d36c485bd82ce2842。以下虚拟地址基于 PE 首选 ImageBase 0x400000,仅适用于本文件;读取进程状态时按实际模块基址换算 RVA。

  • 0x10ec6a3:给服务内的字节数组分配 0x20 字节,调用 libcrypto RAND_bytes 生成本地通道密钥。
  • 0x1436bea:将 32 字节密钥复制到全局本地 TCP 状态,并写入长度 32 与初始化标志 1。
  • 0x1436a08、0x1436b50:Windows BCrypt 的 AES 分组加密与手动计数器/XOR 处理;按 16 字节分组,处理累计字节偏移。算法结构为 AES-256-CTR。
  • 0x1436c79、0x1436cc4:维护独立的两个 64 位方向字节计数器。初始化向量常量为 WECLAW_SEND_IV_1、WECLAW_RECV_IV_2。
  • 0x15c9018、0x15c9125:HTTP server connection backend 的解密、加密路径分别使用上述两个方向。按服务端调用关系,外部客户端发送方向应使用 SEND_IV_1,接收方向使用 RECV_IV_2。
  • 0x33b6040 附近:WeClawService 的连接前校验,读取 weclaw_check_signature_on_connect(默认开启),查询来源 PID/程序路径并检查签名,包含结果缓存和返回分支。

加密算法依据来自静态反汇编,运行时仅核对了状态的长度和初始化标志。没有成功的服务端响应用于完成整个加密传输的实机互通验收。

可复查材料

分析依赖 capstone 5.0.9 安装在 tmp/protocol-analysis-deps,没有加入应用运行依赖。本轮未更改企业微信程序、未注入代码、未关闭来源校验、未重新打包 EXE。

历史 官方 CLI 0.1.9 MCP 配置源码使用机器人凭据生成签名请求,也不能直接替代当前员工账号。内置 weclaw-cli 的本地传输与该公开 CLI 不是同一个已经验证的入口。

对后续实现的含义

单纯在外部 Python 中组装和加密 HTTP 请求,当前实测不能接入本机消息服务。后续需要研究客户端认可的正常桥接入口或客户端内部调用路径,并验证在线身份、会话和业务作用域;接通前不应猜测方法名和客户 ID 发送。连接准入和真实消息发送是两个独立验收步骤,本轮尚未通过前者。

继续验证:官方代理启动与真实请求格式

本轮成功在 tmp/official-agent-bootstrap-probe 中以独立工作目录启动安装包内腾讯签名的 wecom-agent.exe。使用 WECOM_AGENT_WORKSPACE_DIR、WECOM_AGENT_LOG_DIR、agent-client-config.json 的 client.mcp_url / client.websocket_url 指定本地模拟服务。代理启动、配置读取和请求封装已通过实际运行验证;该验证没有接入真实客户会话。测试进程已退出。

抓到的原生请求使用 tools/call -> wecom_tool,其 arguments.payload 是 JSON 字符串,内含 headers_json 与 arguments_json;后者编码成 [服务名, 方法名, 参数JSON字符串]。启动阶段观察到:

  • agent_resource/get_agent_resource_effective_list
  • memory/get_agent_memory
  • openclaw/get_user_initialization_info
  • graph_use/get_memory_md
  • memory/get_workai_tree

这些是代理发给本地模拟服务的初始化/读取请求,不是已经调用成功的企业微信业务接口,更不是原账号发送验证。

进一步静态分析定位到官方 IronBox 启动链路,安装目录内包含 wironboxd32/64.exe 与 wironboxh32/64.dll。本机普通外部进程对 9882、9883、50018、50010 的连接均在发送应用数据前关闭。

未执行的下一步与审批限制

已编写 tmp/native_agent_readonly_bridge.py 草案,计划仅在自己创建的隔离代理子进程中执行一次性 Winsock 握手代码,主客户端仅以只读权限读取已定位的本地通道状态。原型目前只允许 initialize、tools/list 和 ping,没有消息发送命令。

执行该草案的工具请求被自动审批拒绝,脚本没有运行。 审批指出:该操作读取客户端内存中的加密密钥,并通过子进程代码写入/远程线程通过来源校验,属于认证失败后的会话材料探测与安全边界绕过,缺少用户对这一具体高风险手段的明确授权。不能以其他命令、程序或间接执行规避拒绝。此方法也可能被安全软件阻止或导致测试子进程崩溃,需要明确授权后才可再次提交执行审批。

当前只获得了“官方代理可独立启动”和“原生请求封装格式”的验证;真实加密 MCP 连接、员工身份、客户发送及回执均未验收。未重新打包 EXE,也没有向测试客户发送消息。

可复核文件:

  • tmp/official-agent-bootstrap-probe/result.json:模拟服务收到的请求。
  • tmp/native-normal-bridge-xrefs.json:正常启动环境及签名检查的静态调用位置。
  • tmp/native-service-port-readonly-check.json:请求前断连检查。
  • tmp/native-bridge-followup-result.json:本轮机器可读状态。
  • tmp/native_agent_readonly_bridge.py:未执行的只读桥接草案。