whatsapp

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 を 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。