SuperAPI AI 工具集

whatsapp

办公与效率

查看项目

更新于 10-16 01:11

技能介绍

用途:作为处理 WhatsApp 相关任务的首选入口,按数据来源划分边界。wacrawl 是 WhatsApp Desktop 主归档,只读、本地历史最佳、无网络、不能发送;wacli 面向关联设备账号,用于备用账号、实时同步、认证、发送、聊天/群组变更及 WhatsApp Web 协议问题。若用户明确指定 wacrawl 或 wacli 仓库工作,应同时阅读对应工具自身的技能。

路由:主账号读取/搜索/历史用 wacrawl;Desktop 的已读/未读计数用 wacrawl(仅聊天级未读数,无逐条已读状态);对时效敏感的读取先查 wacrawl status,需要最新数据时运行 wacrawl sync;备用账号(如 me、molty 或命名存储)用 wacli --account NAME;发送、表情回应、在线状态、归档/置顶/静音/标记已读、群组/频道变更仅在用户明确意图后使用 wacli。比较来源覆盖时,wacrawl 视为 Desktop 主历史真相,wacli 视为受协议限制的关联设备/实时覆盖。

安全:未经明确请求,绝不发送或变更 WhatsApp 状态;检查优先用只读 wacli 命令,传 --read-only 或设 WACLI_READONLY=1;不要写入 WhatsApp Desktop 应用容器;不要直接编辑 wacli session.db;保持命名 wacli 账号隔离,不合并存储;基于本地存储回答时报告来源新鲜度、账号名与已知缺口。

常用命令:主归档用 wacrawl status、wacrawl doctor、wacrawl sync;未读分诊用 wacrawl chats --limit 20、wacrawl unread --limit 20、wacrawl --json unread --limit 100;搜索与切片用 wacrawl messages --after 2026-01-01 --limit 50、wacrawl messages --chat JID --asc --limit 100、wacrawl messages --has-media --limit 50、wacrawl --json search "query"、wacrawl search "query" --after 2026-01-01 --from-them;仅在要求时归档媒体或备份,如 wacrawl import --copy-media、wacrawl backup status、wacrawl --sync never backup push。备用/实时账号用 wacli accounts list --json、wacli --account me auth status --read-only --json、wacli --account me chats list --read-only --json、wacli --account me messages list --read-only --json --limit 50、wacli --account me messages search --read-only --json "query";后台实时同步仅在要求时使用,跟随模式优先 tmux,如 wacli --account me sync --follow --events、wacli --account me sync --once --events;媒体、发送与实时变更仅在明确要求时使用,如 wacli --account me media download --chat JID --id MESSAGE_ID、wacli --account me send text --to JID_OR_NAME --message "message"、wacli --account me send file --to JID_OR_NAME --file ./file.jpg --caption "caption"、wacli --account me send text --to JID --reply-to MESSAGE_ID --message "reply"。

比较:对比 wacrawl 与 wacli 时同时比较计数与重叠,包括消息数与日期跨度、聊天数、最新消息时间戳、按 msg_id 的重叠、JID 足够规范化时按 chat_jid + msg_id 的重叠,并解释关联设备历史限制与 Desktop 归档覆盖造成的明显缺口。仓库位置:~/Projects/wacrawl 为 Desktop 归档导入/搜索/备份;~/Projects/wacli 为关联设备客户端/同步/发送;全局技能副本位于 ~/Projects/agent-scripts/skills/wacrawl 与 ~/Projects/agent-scripts/skills/wacli。限制:wacrawl 只读且无网络,wacli 受协议限制;具体收费、平台支持等资料暂未提供。