核心用法
whatsapp-utils 是一个面向 WhatsApp 自动化的轻量级工具集，通过 Node.js 脚本提供五项基础功能：
1. 号码格式化（format）：将本地格式的电话号码（如 (11) 99999-9999）转换为 WhatsApp 标准格式
2. 号码清洗（clean）：移除号码中的非数字字符，提取纯数字格式
3. 缓存信息（cache-info）：查看本地 WhatsApp 客户端缓存状态
4. 导出联系人（export-contacts）：批量导出通讯录数据
5. 生成消息ID（gen-id）：生成符合 WhatsApp 协议的消息标识符
所有命令通过 exec() 函数调用本地 Node.js 脚本执行，需在技能目录下运行。
显著优点
- 轻量专注：单一技能解决多个常见预处理需求，避免臃肿依赖
- 格式标准化：自动处理不同地区号码格式差异，降低人工清洗成本
- 离线可用：纯本地脚本执行，无需网络请求
潜在缺点与局限性
- 功能边界模糊："cache-info" 和 "export-contacts" 的具体实现细节未公开，实际输出格式不确定
- 无官方背书：非 Meta/WhatsApp 官方工具，协议兼容性存在风险
- 权限敏感：联系人导出功能可能触及隐私合规边界
- 缺乏文档：未说明输入校验、错误处理机制及返回值结构
适合人群
- 需要批量预处理电话号码的 WhatsApp 自动化开发者
- 构建内部通讯录同步工具的技术团队
- 已有 WhatsApp Web/MD 环境，需辅助工具链的用户
常规风险
| 风险项 | 说明 |
|--------|------|
| 隐私合规 | 联系人导出可能违反 GDPR/个人信息保护法规 |
| 账号安全 | 高频操作或异常缓存访问可能触发平台风控 |
| 数据一致性 | 号码格式化规则与 WhatsApp 服务端可能存在差异 |
| 供应链风险 | 脚本执行环境若被篡改，可导致数据泄露 |