How wangk-ask/wecom-reader works
wecom-reader extracts a key from the running WeCom client, decrypts local databases, then exposes conversation, message, search, contact and export workflows through a Python API, CLI and Web UI. The graph separates acquisition/decryption from SQLite-backed domain queries and user interfaces. The excerpts show the key verification and query implementations, and explicit UI-to-reader calls; some reader internals are omitted, so only relationships established by the index or README are shown. MCP, export and parser directories contain no sampled runtime implementation.
Main entry points: reader.py WeComReader API · key_extract.py Key Extraction · decrypt.py AES Decryption · cli.py CLI
Components 12
Key and Decryption
- Key Extraction
wecom_reader/crypto/key_extract.py - AES Decryption
wecom_reader/crypto/decrypt.py
Local Data Queries
- Session Queries
wecom_reader/db/session.py - Message Queries
wecom_reader/db/message.py - Contact Queries
wecom_reader/db/contact.py
Reader API
- WeComReader API
wecom_reader/reader.py
User Interfaces
- CLI
wecom_reader/cli.py - Web UI and API
wecom_reader/web.py
Other components
- User
- WXWork.exe
- Encrypted Databases
- Decrypted Databases
Connections 18
- WXWork.exe → Key Extraction: provides memory
README.md - Encrypted Databases → Key Extraction: scans databases
wecom_reader/crypto/key_extract.py - Key Extraction → AES Decryption: verifies keys
wecom_reader/crypto/key_extract.py - User → WeComReader API: initializes
README.md - WeComReader API → Key Extraction: extracts keys
README.md - WeComReader API → AES Decryption: decrypts databases
README.md - Encrypted Databases → AES Decryption: input pages
README.md - AES Decryption → Decrypted Databases: writes databases
README.md - Decrypted Databases → Session Queries: session queries
wecom_reader/db/session.py - Decrypted Databases → Message Queries: message queries
wecom_reader/db/message.py - Decrypted Databases → Contact Queries: contact queries
wecom_reader/db/contact.py - WeComReader API → Session Queries: queries sessions
wecom_reader/reader.py - WeComReader API → Message Queries: queries messages
wecom_reader/reader.py - WeComReader API → Contact Queries: queries contacts
wecom_reader/reader.py - User → CLI: runs commands
wecom_reader/cli.py - CLI → WeComReader API: calls API
wecom_reader/cli.py - User → Web UI and API: uses browser
README.md - Web UI and API → WeComReader API: calls API
wecom_reader/web.py