Community生產力與協作github.com

steipete/whatsapp

WhatsApp 路由器:歷史記錄 / 搜尋 / 讀取 / 發送;支援 wacrawl 唯讀、wacli 即時操作。

whatsapp 是什麼?

此技能定義了一個清晰的 WhatsApp 工作流程路由,將職責區分為兩個主要工具:wacrawl(主要桌面歸檔,唯讀,可離線)與 wacli(連結裝置帳戶,用於次要帳號、即時同步、認證、發送及群組/頻道操作)。對於需要讀取主要帳號的完整本地歷史記錄的使用案例,技能會引導使用 wacrawl;而對於發送訊息、反應、已讀標記等會改變狀態的操作,則僅在使用者明確要求後才使用 wacli,並要求加入 `--read-only` 旗標或設定 `WACLI_READONLY=1` 環境變數以確保安全。技能在回答查詢時會強調回報來源的新鮮度、帳戶名稱及已知缺口。同時也提供了 wacrawl 與 wacli 的常用指令(如搜尋、同步、傳送)以及兩者之間的覆蓋範圍比較方法,涵蓋 Claude Code 等 AI agent 平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相關技能