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。