What problem does it solve?
It lets you analyze an already-decrypted, user-authorized Windows WeChat (Weixin) SQLite snapshot locally without touching the running client, extracting keys, decrypting databases, or using the network, while enforcing strict safety boundaries on paths, sidecars, and output locations.
Core Features & Use Cases
- Snapshot Validation: Verifies required databases, manifest with a canonical UUIDv4 snapshot_id, compatible Msg_<32hex> message tables, and rejects WAL/SHM/journal sidecars, symlinks, junctions, and UNC paths.
- Chat Listing and Querying: Lists conversations with snapshot-scoped anonymous chat IDs, then runs history, keyword search, and date-range queries with row, byte, and limit budgets.
- Markdown Export: Exports selected conversations to Markdown in a default local directory, with explicit confirmation required for external paths or overwrites.
- Use Case: You have a checkpointed plaintext snapshot of your own WeChat data and want to search one conversation for a keyword and export it as Markdown without any risk of modifying the original data.
Quick Start
Ask the assistant to validate the snapshot at your chosen path and then list its chats using the snapshot_reader script with the --snapshot flag.
