在即时通讯工具的生态中，WhatsApp 凭借其庞大的用户基数和端到端加密特性一直是协议逆向工程的热门目标。wacli 项目是由开发者 steipete 构建的 WhatsApp 命令行客户端，基于 Go 语言实现的 whatsmeow 库，专注于消息历史本地同步、快速离线搜索以及消息发送功能。该项目目前已在 GitHub 获得超过 1200 颗星标，展现了社区对非官方 WhatsApp 客户端的高度关注。
协议逆向的技术起点
wacli 的核心依赖是 whatsmeow，这是一个专门为 WhatsApp Web 多设备协议设计的 Go 语言库。与早期单设备 Web 协议不同，多设备模式下的 WhatsApp 采用了全新的架构设计，每个 linked 设备都与主设备建立独立的加密会话。WhatsApp 的多设备实现使用成对端到端加密策略，即发送方为每台接收设备分别加密消息内容，而非像传统 Web 协议那样仅使用单一的会话密钥。这意味着即使攻击者能够截获某一设备的消息，也无法直接解密发送给其他设备的内容。
从协议层面来看，whatsmeow 库实现了 WhatsApp Web 的多设备 API 规范，包括消息收发、群组管理、收据处理和应用状态同步等功能。项目文档指出，大量代码为支持多设备而重写，部分实现借鉴了其他 WhatsApp 客户端的开源方案。这种开源社区的协作模式使得协议逆向的门槛显著降低，开发者无需从零开始分析 WhatsApp 的私有协议栈。
消息同步与本地存储架构
wacli 在设计上采用了本地优先的策略，将所有接收到的消息持久化存储到本地 SQLite 数据库中，并借助 SQLite 的 FTS5 扩展实现高效的全文搜索能力。默认存储路径为用户主目录下的.wacli文件夹，可通过--store参数自定义。首次运行时需要执行wacli auth命令进行认证，工具会显示二维码供用户扫描，完成认证后立即触发初始数据同步。
持续同步通过wacli sync --follow命令实现，该命令会启动一个非交互式的同步循环，持续接收 WhatsApp Web 推送的新消息。值得注意的是，由于 WhatsApp Web 协议的自身的限制，wacli 只能获取到用户登录后开始同步时刻之后的聊天记录历史。对于更早期的消息，工具提供了历史回填功能，通过向用户的主设备（手机）发送请求来拉取旧消息。项目文档明确指出这是 “尽力而为” 的操作，WhatsApp 服务器可能不会返回完整的历史记录，且每次请求的推荐数量为 50 条。
搜索功能是 wacli 的核心卖点之一。借助 SQLite FTS5，用户可以在离线状态下快速检索本地存储的消息内容。搜索支持多种消息类型，包括带有显示文本的反应消息、回复消息以及媒体类型标识。这对于需要频繁查阅历史记录的重度 WhatsApp 用户而言具有实际价值。
端到端加密的处理方式
尽管 wacli 能够解密和存储消息内容，但这并不违反 WhatsApp 的端到端加密承诺。关键在于理解加密的边界：端到端加密保护的是传输过程中的消息安全，发送方使用接收方的公钥加密消息，只有持有对应私钥的接收方才能解密。在 wacli 的场景中，用户主动授权客户端访问自己的 WhatsApp 账户，客户端在用户设备上完成加密会话的建立和解密操作，这本质上与在手机或网页版 WhatsApp 上使用没有区别。
多设备模式下的加密实现更具技术复杂性。每条消息需要为每个目标设备分别加密，使用预先建立的成对会话密钥。群组消息则继续使用 Signal Protocol 中的 Sender Key 机制，发送方为群组生成一个 Sender Key 并分发给所有群成员，后续消息使用该密钥加密即可，无需为每个接收方单独加密。这种设计在多设备场景下显著降低了加密运算的开销，同时保持了前向安全性。
对于安全敏感的应用场景，wacli 提供了环境变量WACLI_DEVICE_LABEL和WACLI_DEVICE_PLATFORM用于自定义设备标识，这在使用非标准设备接入时可能需要考虑。此外，项目明确声明這是一个第三方工具，使用 whatsmeow 实现的 WhatsApp Web 协议，与 WhatsApp 官方无关联。
工程实践与性能考量
从工程实现角度，wacli 采用 Go 语言构建，充分利用了 Go 的并发模型处理 WebSocket 长连接和消息队列。SQLite 的集成使用了 Go 标准的 database/sql 接口，配合 FTS5 扩展实现全文索引。对于媒体文件的下载，工具提供了独立的media download子命令，支持指定聊天 ID 和消息 ID 进行离线获取。
在持续运行方面，建议将 wacli 作为系统服务或后台进程运行，确保消息同步的持续性。诊断命令wacli doctor可用于排查连接问题和认证状态。对于群组管理，工具支持列出群组、重命名群组以及管理参与者等操作，基本覆盖了日常使用的核心场景。
wacli 项目展示了协议逆向工程在实际应用中的价值，通过开源社区的力量将原本封闭的 WhatsApp 协议转化为可编程的接口。其设计思路 —— 本地优先存储、全文搜索、多设备同步 —— 对于构建类似的即时通讯客户端具有参考意义。
资料来源：GitHub steipete/wacli 项目文档、Meta Engineering 关于 WhatsApp 多设备能力的技术博客