عن المشروع

يقرأ wx-cli مباشرة قاعدة البيانات المحلية لـ WeChat على macOS، مما يتيح للمستخدمين ووكلاء الذكاء الاصطناعي الوصول إلى سجلات الدردشة وجهات الاتصال ودردشات المجموعات والرسائل الوسائطية. تبقى البيانات افتراضيًا على الجهاز المحلي، دون الحاجة إلى رفعها أو الاعتماد على تصدير سحابي. تشمل القدرات الأساسية: 1. فك تشفير قاعدة البيانات: التقاط استدعاءات PBKDF2 عبر LLDB hook لاستخراج المفتاح الأصلي، مع دعم فك التشفير الكامل والتدريجي، وتغطية جميع قواعد بيانات WeChat. 2. الاستعلام عن الرسائل والبحث فيها: الاستعلام عن الرسائل التاريخية حسب جهة الاتصال أو دردشة المجموعة أو النطاق الزمني أو نوع الرسالة؛ دعم البحث الشامل بالكلمات المفتاحية عبر جميع المحادثات؛ وإمكانية قراءة رسائل جميع المحادثات دفعة واحدة حسب النطاق الزمني (timeline)، وهو مناسب لاستكمال الذاكرة والمعالجة الدفعية. 3. الاشتراك في الوقت الفعلي: مراقبة الرسائل الجديدة بشكل مستمر من سطر الأوامر، أو دفع الرسائل الجديدة في الوقت الفعلي إلى الوكلاء والبرامج الأخرى عبر SSE (/api/v1/events). 4. التصدير ومعالجة الوسائط: يمكن تصدير المحادثات بصيغة JSON أو نص؛ دعم فك تشفير الصور، واستخراج الصوت (يتطلب ffmpeg)، وفك تشفير فيديوهات قناة الفيديو. 5. تكامل الوكلاء: يتضمن Agent Skill يمكن تثبيته عبر npx skills add، وبعد تثبيته في أدوات مثل 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، والاستعلام من قاعدة البيانات، وفك تشفير الوسائط، والمراقبة في الوقت الفعلي، وتحليل سياق الحساب، وإدارة مسارات المنصة، وذلك في crates مستقلة.