इस प्रोजेक्ट के बारे में

wx-cli सीधे macOS पर WeChat के स्थानीय डेटाबेस को पढ़ता है, जिससे उपयोगकर्ता और AI Agent दोनों चैट रिकॉर्ड, संपर्क, समूह चैट और मीडिया संदेशों तक पहुँच सकते हैं। डेटा डिफ़ॉल्ट रूप से स्थानीय डिवाइस पर रहता है, किसी अपलोड या क्लाउड निर्यात पर निर्भरता की आवश्यकता नहीं होती। मुख्य क्षमताएँ शामिल हैं: 1. डेटाबेस डिक्रिप्शन: LLDB hook के माध्यम से PBKDF2 कॉल को कैप्चर करके मूल कुंजी निकालता है, पूर्ण डेटाबेस डिक्रिप्शन और इंक्रीमेंटल डिक्रिप्शन का समर्थन करता है, सभी WeChat डेटाबेस को कवर करता है। 2. संदेश क्वेरी और खोज: संपर्क, समूह चैट, समय सीमा, संदेश प्रकार के अनुसार ऐतिहासिक संदेशों की क्वेरी; सभी सत्रों में वैश्विक कीवर्ड खोज का समर्थन; समय सीमा के अनुसार एक बार में सभी सत्र संदेशों को पढ़ना (timeline), जो मेमोरी पूर्णता और बैच प्रोसेसिंग के लिए उपयुक्त है। 3. रीयल-टाइम सब्सक्रिप्शन: कमांड लाइन लगातार नए संदेशों की निगरानी करती है, या SSE (/api/v1/events) के माध्यम से नए संदेशों को Agent और अन्य प्रोग्रामों को रीयल-टाइम में पुश करती है। 4. निर्यात और मीडिया प्रोसेसिंग: सत्रों को JSON या टेक्स्ट में निर्यात किया जा सकता है; छवियों को डिक्रिप्ट करना, वॉइस निकालना (ffmpeg आवश्यक), वीडियो चैनल वीडियो को डिक्रिप्ट करना समर्थित है। 5. Agent एकीकरण: npx skills add के माध्यम से इंस्टॉल किए जा सकने वाले Agent Skill के साथ आता है, Claude Code, Codex, Cursor जैसे टूल इंस्टॉल के बाद सीधे wx-cli की क्षमताओं को समझ सकते हैं और कॉल कर सकते हैं। 6. REST API सेवा: लंबे समय तक चलने वाली सेवा पहले से खुले डेटाबेस का पुनः उपयोग करती है, sessions, contacts, messages, timeline, search, media, events जैसे एंडपॉइंट प्रदान करती है, token प्रमाणीकरण और दूरस्थ पहुँच का समर्थन करती है। सेवा चलने के दौरान क्वेरी कमांड स्वचालित रूप से API का पुनः उपयोग करती हैं। 7. गोपनीयता नियंत्रण: खाते के अनुसार निर्दिष्ट संपर्क, समूह चैट या विशिष्ट टैग वाले संपर्कों को छिपाया जा सकता है, क्वेरी और सब्सक्रिप्शन के दौरान स्वचालित रूप से फ़िल्टर किया जाता है (पूर्ण-पाठ खोज को छोड़कर)। प्लेटफ़ॉर्म आवश्यकताएँ macOS (arm64 / Apple Silicon), WeChat संस्करण 4.1.7 और उससे ऊपर हैं। कुंजी निष्कर्षण के लिए SIP (System Integrity Protection) बंद करना आवश्यक है, और DevToolsSecurity तथा डेवलपर समूह अनुमतियाँ सक्षम करनी होंगी। प्रोजेक्ट Rust में लिखा गया है, पूर्व-संकलित बाइनरी और स्रोत कोड संकलन दोनों इंस्टॉलेशन विधियाँ प्रदान करता है। प्रोजेक्ट संरचना में कोर डिक्रिप्शन लाइब्रेरी, कुंजी निष्कर्षण और भंडारण, CLI प्रवेश बिंदु, डेटाबेस क्वेरी, मीडिया डिक्रिप्शन, रीयल-टाइम निगरानी, खाता संदर्भ विश्लेषण और प्लेटफ़ॉर्म पथ प्रबंधन जैसे स्वतंत्र crate शामिल हैं।