skills.rest
mcncarl
mcncarlCOMMUNITY
Explore all skills by this author →
GitHub

wechat-local-vault

Decrypt and query WeChat Mac 4.x local vault data with Python scripts.

1.8k|235|Updated Feb 11, 2026
Search Tags:#markdown#vault#wechat#privacy#export#decrypt#chat-history
One-click install
npx skills add https://github.com/mcncarl/yichen-skills --skill wechat-local-vault
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wechat-local-vault
Source: https://github.com/mcncarl/yichen-skills/tree/main/wechat-local-vault
Command: npx skills add https://github.com/mcncarl/yichen-skills --skill wechat-local-vault

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires zstandard, pycryptodome, frida, and includes scripts (resource) components.

What problem does it solve?

Managing and analyzing private local WeChat data stored in Mac vaults is tedious, error-prone, and privacy-sensitive. This skill provides a private, script-driven workflow to decrypt WeChat Mac 4.x databases and produce consumable outputs without exposing personal data.

Core Features & Use Cases

  • Full decrypt of WeChat Mac 4.x databases to plaintext vaults for offline analysis.
  • Incremental updates with state tracking to keep outputs current without reprocessing everything.
  • Unified CLI (decrypt, query, export, and digest) for end-to-end data access and reporting across chats and groups.
  • Generate group/digest reports to summarize conversations for audits or personal records.

Quick Start

Configure your environment and run decrypt_all_dbs.py to decrypt the local vault, then use vault_cli.py to explore data and export results.

Frequently Asked Questions about wechat-local-vault

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decrypt WeChat Mac 4.x local vault databases?▼

To decrypt WeChat Mac 4.x local vault databases, run the decrypt_all_dbs.py script to manage local keys and convert encrypted databases into plaintext vaults for offline analysis entirely on your local machine.

Can I export specific WeChat chat histories and media indices from a Mac?▼

Yes, you can export targeted WeChat chat histories and media indices by using the export_chat.py script, which queries the decrypted local vault to generate reports for individual chats and groups.

What's the best way to generate digest reports from WeChat conversations locally?▼

Generating digest reports from WeChat conversations locally is best handled by the wechat_digest.py script, which summarizes decrypted chats and group conversations for audits or personal records without exposing personal data.

Do I need to fully reprocess the WeChat vault every time I want to update exports?▼

No, you do not need to fully reprocess the WeChat vault every time; the workflow supports incremental updates with state tracking to keep your decrypted outputs and exports current efficiently.

Does this local WeChat decryption workflow protect my privacy?▼

Yes, this local WeChat decryption workflow protects your privacy by operating entirely on your local machine, ensuring private local data and decrypted chats are never exposed to external servers.

Related Skills

Explore More Data & Analytics Skills→
zhuyansenzhuyansen
636

wx-favorites-report

Decrypt WeChat Mac favorites databases and extract records into structured JSON.

Community
Advanced
cacheforge-aicacheforge-ai
10

feed-diet

Audit Hacker News and RSS feeds into categorized Markdown reports.

Official
Advanced
sungaoxiang-backendsungaoxiang-backend

evidence-wechat-chat-handler

Extract WeChat chat screenshots into grouped card_features by contact remark.

Community
Advanced
kkbig509kkbig509
1

sqlite

Query and modify local SQLite databases, including encrypted sqlcipher files.

Community
Intermediate