عن المشروع

Gancho — وتعني "خطاف" بالإسبانية — هو مكتبة مقتطفات منسقة وسجل للحافظة يعتمد على التخزين المحلي (local-first) ومرخص بموجب MIT لمنظومة Apple. يصفه ملف README بأنه في الإصدار العام v0.8.3 وهو قيد التطوير النشط للوصول إلى الإصدار 1.0، حيث يمثل macOS سطح الإنشاء الأساسي، مع تطبيقات لـ iPhone/iPad تدعم الإضافات، وبناء مخطط له لـ visionOS متوافق مع iPad، بينما يقتصر watchOS على العناصر المثبتة والعناصر الأخيرة. أما Android وWindows وLinux فهي مدرجة فقط كتحليلات مستقبلية دون التزام بالتنفيذ. تتم إدارة الالتقاط والخصوصية على macOS بواسطة مراقب للحافظة يستخدم استطلاعاً تكيفياً منخفض الطاقة يتوقف عند قفل الشاشة والوضع الخاص، ويمنع كتاباته الخاصة، ويميز عناصر Universal Clipboard ويحتفظ بالحمولات الغنية مثل النصوص وRTF وHTML والصور وعناوين URL للملفات. تمنع أنواع الحافظة المحددة كـ ConcealedType أو TransientType أو AutoGeneratedType عملية الالتقاط قبل قراءة أي محتوى، كما يتضمن التطبيق قائمة حظر مسبقة لمديري كلمات المرور والتطبيقات البنكية بالإضافة إلى إجراء "تجاهل النسخ التالي". يقوم كاشف على الجهاز بالبحث عن أرقام البطاقات (Luhn)، ومفاتيح AWS/Stripe/GitHub/Slack، ومفاتيح PEM وكلمات المرور المحتملة، مع عرض معاينات مقنعة ذات صلاحية قصيرة. أما في iOS وiPadOS وvisionOS، يكون الالتقاط مقصوداً فقط دون استطلاع خلفي للحافظة. ويؤكد المشروع أن محتوى الحافظة لا يُكتب أبداً في السجلات أو القياسات عن بُعد أو تقارير الأعطال أو التحليلات أو حزم الدعم. يستخدم التخزين GRDB/SQLite مع كتل أقراص معنونة بالمحتوى، وصور مصغرة كسولة، وقوائم بيانات وصفية فقط مقسمة إلى صفحات، وترقيات إصدارات، وإزالة تكرار مدركة للجهاز، وتصدير بتنسيقات JSON/CSV. يعتمد البحث على FTS5 مع أنماط المطابقة التامة والضبابية والتعبيرات النمطية (regex)، بالإضافة إلى فلاتر للنوع والتطبيق المصدر والتاريخ، مدعوماً بأداة اختبار أداء لـ 100 ألف عنصر. كما يدعم فهرس تضمين (embedding index) على الجهاز بأبعاد 512 ميزة "اسأل حافظتك" واقتراحات اللوحة التلقائية، بينما يظل بحث السجل الرئيسي معتمداً على FTS5. ويطبق محرك الاستبقاء صلاحية انتهاء عالمية وبحسب النوع، وانتهاء صلاحية تلقائي للمحتوى الحساس وتطهيراً في الخلفية، مع استثناء العناصر المثبتة. تطبيق macOS عبارة عن وكيل في شريط القائمة مع لوحة سجل عائمة قابلة لتغيير الحجم (Shift-Cmd-V)، وبحث عن طريق الكتابة يركز على لوحة المفاتيح، وفلاتر قابلة للتركيب، وعناوين قابلة للتعديل، ومعاينات حسب النوع، ومعاينة كاملة للمحتوى للقراءة فقط، وإعادة لصق عبر Cmd-V اصطناعي. تم تنفيذ العناصر المثبتة، واللوحات متعددة العضوية، ومكتبة موحدة للوحات والمقتطفات، بالإضافة إلى الإضافة الجماعية للمكدس واللوحة والحذف مع إمكانية التراجع، والتحديد المتعدد، وسحب مقاطع الملفات، وتبرع Spotlight المنسق مع تنقيح هيكلي، واستيراد سجل Maccy/CSV موجه مع معاينة للقراءة فقط وتحقق وإزالة تكرار ذرية وإلغاء. تم استبعاد Raycast صراحةً كمصدر للاستيراد لأن واجهة برمجة تطبيقات الحافظة الخاصة به تعرض ستة إدخالات أخيرة فقط، ولا يملك نسخه الاحتياطي المشفر مخطط فك تشفير موثق لطرف ثالث. يوفر تطبيق iPhone وiPad الالتقاط المقصود فقط من خلال زر حفظ، وUIPasteControl، وإضافة مشاركة (Share Extension) وApp Intents/Shortcuts، بالإضافة إلى إضافة لوحة مفاتيح تحتوي على السجل، وأدوات (widgets)، وعرض تقسيم iPad وتصفية التطبيق المصدر. تعمل حزمة الذكاء الاصطناعي على الجهاز بدون شبكة: مصنف tier-0 حتمي يتعرف على 17 نوعاً من المحتوى في أقل من 5 مللي ثانية، وعناوين Apple Intelligence، وOCR لقطات الشاشة، والفهرسة الدلالية، وإجراءات المطورين (Dev Actions) مثل فك تشفير JWT، وتنسيق JSON، وBase64، وتحليل URL، وتحويل الألوان، وتنسيقات UUID المعروضة أيضاً كـ App Intents، وSmart Paste لإعادة الكتابة/الترجمة/تنقيح معلومات الهوية الشخصية (PII)، والأسئلة والأجوبة المعتمدة على السجل، واقتراحات اللوحة التلقائية. ولكل مرحلة مفتاح تبديل خاص بها في شاشة الذكاء الاصطناعي. تستخدم المزامنة CKSyncEngine عبر قاعدة بيانات iCloud الخاصة بالمستخدم خلف حدود SyncEngine، مع حالة مزامنة مرئية. تشمل التكاملات واجهة سطر أوامر (gancho CLI)، وخادم MCP محلي اختياري مع منح صلاحيات لكل عميل قابلة للإلغاء والانتهاء، وسياق لوحة/زمني صريح، وأذونات قراءة/كتابة مستقلة وسجل وصول للبيانات الوصفية فقط، بالإضافة إلى أمر "حفظ التحديد" في VS Code. تعتمد تحقيق الأرباح على StoreKit 2 للشراء والاستعادة والصلاحيات مع جدار دفع سياقي وحدود للفئة المجانية؛ ويمكن لإصدار التحميل المباشر شراء وتفعيل وإعادة التحقق وإلغاء تفعيل ترخيص Pro عبر Lemon Squeezy دون تضمين سر دفع، ويفتح Pro ميزة مزامنة iCloud المشفرة. تظل التشخيصات المجهولة الاختيارية معطلة حتى الموافقة الصريحة، ويحتفظ إيصال النشاط في مركز الخصوصية بإجماليات محدودة لكل تطبيق على الجهاز لمدة 13 شهراً متدحرجة دون مزامنة أو تصدير. من الناحية الهندسية، يستخدم المشروع XcodeGen، وSwift 6 strict concurrency، وبوابة كتالوج نصوص ثنائية اللغة (إنجليزية/إسبانية)، ودعم إمكانية الوصول، وحزمة SwiftPM واحدة (GanchoKit) تحتوي على ثمانية منتجات مكتبية بالإضافة إلى CLI. تغطي CI عمليات البناء والاختبار والتدقيق، وحد أدنى مفروض لتغطية المصدر الإنتاجي، وأتمتة StoreKit متسلسلة وأداء القياس. يتطلب البناء macOS 15.4+ وXcode 26+ وXcodeGen، مع أهداف make موثقة للاختبارات وتثبيت أجهزة iOS والتغليف وضمان جودة الإصدار وفحوصات الموقع. ينسب ملف README الفضل إلى GRDB.swift وSQLCipher وKeyboardShortcuts وSauce وTelemetryDeck كأعمال مفتوحة المصدر أساسية. الترخيص: MIT، © 2026 Johnny Young.