wechat-local-vault

Name: wechat-local-vault
Availability: InStock
Author: mcncarl

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

Ready to run

npx skills add https://github.com/mcncarl/yichen-skills --skill wechat-local-vault

💬 Prompt for ChatGPT / Claude Chat▼

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.