（7169期）WhatsApp Contacts – WhatsApp 本地联系人速查工具

WhatsApp 本地联系人速查工具 基于 Baileys 库读取 WhatsApp 本地会话缓存中的联系人列表，支持搜索和详情查询，仅访问已交互过的联系人数据。 使用说明 核心用法 该技能通过封装 Node.js 脚本调用 Baileys 本地会话缓存，提供三种操作模式： list [n]：分页列出最近联系人，默认限制返回数量 search "关键词"：按姓名或手机号模糊搜索 get <手机号>：获取指定联系人的详细信息 执行环境需预置 Baileys 会话文件，脚本直接读取本地缓存数据库，无需实时连接 WhatsApp 服务器。 显著优点 零 API 成本：不调用 WhatsApp Business API 或 Cloud API，完全基于开源 Baileys 库实现 离线可用性：读取本地 SQLite/JSON 缓存，网络中断时仍可查询历史联系人 响应速度快：本地文件 IO 操作，延迟通常在毫秒级 隐私边界清晰：仅访问已交互联系人，不会抓取公开通讯录或未聊天用户 潜在缺点与局限性 数据不完整：仅限「已交互」联系人，大量未聊天号码无法检索 依赖会话状态：Baileys 会话失效或二维码重新扫描后需重新同步 无官方支持：Baileys 为第三方逆向工程库，存在协议变更导致功能中断风险 格式限制：返回数据为原始 WhatsApp ID 格式（如 5511999999999@s.whatsapp.net），需二次清洗 适合人群 已部署 Baileys 自建 WhatsApp 服务的开发者或运维人员 需要低成本批量查询客户联系记录的小微企业 自动化工作流中需要联系人元数据（如 pushName）作为判断条件的场景 常规风险 | 风险类型 | 说明 ||---------|------|| 会话劫持 | Baileys 凭据文件泄露可导致账号被盗发消息 || 数据残留 | 本地缓存可能包含已删除对话的联系人记录 || 协议违规 | 大规模自动化读取可能触发 WhatsApp 非官方客户端检测 || 依赖维护 | Baileys 更新滞后可能导致与新版本 WhatsApp 不兼容 | 建议定期清理会话文件、限制查询频率，并监控账号异常登录提醒。 原始说明 List, search, and lookup WhatsApp contacts from the Baileys session cache