wacli

wacli 是一款专为命令行环境设计的 WhatsApp 管理工具 Skill，它通过封装开源 wacli CLI 工具的功能，为用户提供发送消息、同步历史记录和搜索聊天内容的自动化能力。该 Skill 本身为纯文档型资产，主要提供详细的命令使用指南和安全操作规范，实际功能执行完全依赖用户本地安装的 wacli 二进制文件。

核心用法涵盖完整的 WhatsApp 工作流管理。首次使用需通过 wacli auth 完成 QR 码登录和初始同步，建立本地数据缓存。日常操作中，用户可使用 wacli sync --follow 保持实时同步，利用 wacli chats list 查询联系人，或通过 wacli messages search 基于关键词、时间范围精准检索历史消息。对于消息发送，支持文本消息（wacli send text）和文件传输（wacli send file），既可用于一对一通信（格式为 <number>@s.whatsapp.net），也支持群组消息（格式为 <id>@g.us）。此外，wacli history backfill 功能允许按需回填特定聊天的历史记录。

显著优点体现在安全性与自动化能力的平衡。作为纯 Markdown 文档型 Skill，它不包含任何可执行代码，无注入漏洞或系统破坏性命令风险，所有操作均通过透明可审计的 CLI 指令完成。命令行界面适合批量处理和脚本集成，企业用户可将 WhatsApp 通信集成到现有工作流，如自动发送通知、备份聊天记录或构建客服机器人。数据本地存储（默认 ~/.wacli）确保敏感信息不离线，符合隐私合规要求。

潜在局限性主要包括技术门槛和依赖风险。用户需自行安装配置 wacli CLI 工具（支持 Homebrew 或 Go 安装），并具备一定的命令行操作基础。该 Skill 明确不适用于普通用户聊天场景，仅设计用于向第三方发送消息或历史记录管理。由于依赖外部工具，功能可用性受 wacli 项目维护状态影响，且 WhatsApp 官方 API 变更可能导致兼容性问题。此外，历史回填功能需要手机保持在线，且结果为尽力而为，不保证完整性。

适合目标群体主要是技术背景较强的用户和企业 IT 团队。开发者可利用其构建自动化通知系统，将 WhatsApp 集成到 CI/CD 流程或监控告警中；运营团队可通过批量消息功能进行客户触达；系统管理员可利用搜索和同步功能实现合规性备份。不适合普通终端用户日常聊天，也非低代码/无代码场景的理想选择。

使用风险需重点关注账户安全和数据隐私。wacli 工具需要访问完整的 WhatsApp 账户数据，包括聊天记录和联系人信息，虽然 Skill 本身不收集数据，但第三方工具的安全性需用户自行评估。发送消息前必须严格验证接收方号码（JID），避免误发敏感信息。依赖项更新滞后可能带来安全漏洞，建议定期通过官方渠道（brew 或 go install）更新 wacli。此外，频繁操作可能触发 WhatsApp 的反垃圾邮件机制，导致账户限制。