wacli 是一个面向 WhatsApp 的命令行工具（CLI），主要用于两类任务：向其他人发送 WhatsApp 消息，以及搜索或同步 WhatsApp 历史记录。它并非用于普通用户聊天——如果用户正在 WhatsApp 上与助手对话，ThinkFleetBot 会自动路由这些会话，此时不应调用 wacli，除非用户明确要求联系第三方。
用途
wacli 仅在用户明确要求向他人发送 WhatsApp 消息，或要求同步/搜索 WhatsApp 历史时使用。普通用户聊天不需要该工具。
安全要求
使用 wacli 发送消息时，需要明确的收件人和消息文本；发送前应确认收件人和消息内容；如果任何信息存在歧义，应先提出澄清问题。
认证与同步
可通过以下命令完成认证与同步：
- wacli auth（QR 登录 + 初始同步）
- wacli sync --follow（持续同步）
- wacli doctor
查找聊天与消息
可使用以下命令查找聊天和消息：
- wacli chats list --limit 20 --query "name or number"
- wacli messages search "query" --limit 20 --chat <jid>
- wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31
历史回填
可使用以下命令回填历史记录：
- wacli history backfill --chat <jid> --requests 2 --count 50
发送消息
支持发送文本、群组消息和文件：
- 文本：wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
- 群组：wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."
- 文件：wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"
注意事项
- 存储目录：~/.wacli（可用 --store 覆盖）。
- 解析输出时使用 --json 获取机器可读结果。
- 回填需要手机在线；结果为尽力而为。
- 常规用户聊天不需要 WhatsApp CLI；它用于向其他人发送消息。
- JID 格式：直接聊天形如 <number>@s.whatsapp.net；群组形如 <id>@g.us（可用 wacli chats list 查找）。