whatsapp 是做什麼的?
請將此作為 WhatsApp 工作的第一站。保持來源的邊界清晰:
wacrawl:主要的 WhatsApp Desktop 歸檔工具。唯讀、最佳的本地歷史記錄、無網路需求、無法發送。wacli:連結裝置帳戶。用於次要帳號、即時同步、認證、發送、聊天/群組變更以及 WhatsApp Web 協定相關問題。
如果使用者具體提到 wacrawl 或 wacli 的專案工作,請一併讀取該工具的專屬技能。
路由
- 主要 WhatsApp 的讀取/搜尋/歷史記錄:使用
wacrawl。 - 來自 WhatsApp Desktop 的已讀/未讀計數:使用
wacrawl;它提供聊天層級的未讀計數,而非每則訊息的已讀狀態。 - 對新鮮度敏感的主要讀取:檢查
wacrawl status;在需要當前資料時執行wacrawl sync。 - 次要帳號(例如
me、molty或已命名的儲存庫):使用wacli --account NAME。 - 發送、反應、在線狀態、封存/釘選/靜音/標記已讀、群組/頻道變更:僅在使用者明確提出意圖後使用
wacli。 - 比較來源間的覆蓋範圍:將
wacrawl視為主要歷史記錄的桌面歸檔真相,將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 "訊息"
wacli --account me send file --to JID_OR_NAME --file ./file.jpg --caption "說明"
wacli --account me send text --to JID --reply-to MESSAGE_ID --message "回覆"
比較
在比較 wacrawl 與 wacli 時,請比較兩者的計數與重疊:
- 訊息計數與日期範圍
- 聊天計數
- 最新訊息的時間戳
- 透過
msg_id重疊 - 在 JID 已充分正規化時透過
chat_jid + msg_id重疊 - 以連結裝置歷史限制相對於桌面歸檔覆蓋範圍來解釋明顯的缺口
專案路徑
~/Projects/wacrawl:桌面歸檔匯入器/搜尋/備份。~/Projects/wacli:連結裝置客戶端/同步/發送。- 全域技能複本:
~/Projects/agent-scripts/skills/wacrawl與~/Projects/agent-scripts/skills/wacli。