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의 앱 컨테이너에 쓰지 마세요.
waclisession.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.