هل سبق لك أن أردت نقل ملف من لابتوبك إلى جوالك بسرعة، دون الحاجة إلى كابل USB أو رفع الملف إلى سحابة؟ ShadowCat هو مشروع مفتوح المصدر جديد ظهر في Show HN على Hacker News، يتيح لك نقل الملفات عبر رموز QR مباشرة من المتصفح. الفكرة بسيطة: تختار ملفاً، يتحول إلى رابط، ويُعرض كرمز QR، ثم تمسحه بهاتفك لتحميل الملف. لا تطبيقات إضافية، لا حسابات، ولا إعدادات معقدة.

في هذا الدليل، سنشرح لك ما هو ShadowCat، لمن يفيد، وكيف تجربه خطوة بخطوة (مع العلم أن README غير واضح تماماً، لذا سنعتمد على هيكل المشروع التقريبي). سنذكر الأخطاء الشائعة، وحدود الاستخدام، والبدائل. الهدف: أن تقرر بنفسك هل هذا المشروع يستحق وقتك أم لا.

ما هو ShadowCat؟ شرح بسيط

ShadowCat هي أداة مفتوحة المصدر تعمل في المتصفح، تسمح لك بتحويل أي ملف إلى رابط قصير، ثم عرضه كرمز QR. يمكن لأي شخص في نفس الشبكة (أو عبر الإنترنت إذا كان الخادم عاماً) مسح الرمز وتحميل الملف. لا تحتاج إلى تثبيت تطبيق على هاتفك، فقط ماسح QR (معظم الكاميرات تدعمه).

من يحتاج ShadowCat؟ ومن لا؟

يناسب:

• مطور يريد نقل ملفات إعدادات بين أجهزته بسرعة.
• صاحب مشروع صغير يريد مشاركة كتالوج أو عرض سعري مع عميل في نفس المكان.
• صانع محتوى يريد توزيع ملفات على جمهوره في ورشة عمل دون رفع للسحابة.

لا يناسب:

• من يحتاج نقل ملفات كبيرة (أكثر من 100MB) – الأداء غير مضمون.
• من يريد أماناً عالياً – النقل عبر HTTP غير مشفر (إلا إذا أضفت HTTPS بنفسك).
• من يريد تخزين دائم – الملفات تختفي عند إيقاف الخادم.

المميزات الرئيسية

• مفتوح المصدر: يمكنك فحص الكود وتعديله.
• يعمل في المتصفح: لا حاجة لتثبيت برامج.
• نقل عبر QR: مريح للأجهزة المحمولة.
• خفيف: لا يحتاج موارد كبيرة.

المتطلبات قبل البدء

• Node.js (إصدار 14 أو أحدث) و npm.
• متصفح حديث (Chrome, Firefox, Edge).
• اتصال شبكة (محلي أو إنترنت) بين الأجهزة.
• ماسح QR (معظم الهواتف تدعمه في الكاميرا).

خطوات التركيب والتشغيل (تقريبية)

ملاحظة: README المشروع غير واضح، لذا الخطوات التالية تقريبية بناءً على هيكل مشروع Node.js نموذجي. قد تختلف حسب التحديثات.

1. استنساخ المستودع: git clone https://github.com/unprovable/ShadowCat.git
2. الدخول إلى المجلد: cd ShadowCat
3. تثبيت الاعتماديات: npm install
4. إعداد متغيرات البيئة (انظر القسم التالي).
5. تشغيل الخادم: npm start أو node server.js (حسب اسم الملف الرئيسي).
6. فتح المتصفح على http://localhost:PORT (المنفذ الافتراضي غالباً 3000).

شرح ملف .env (إن وجد)

إذا كان المشروع يستخدم ملف .env، فقد يحتوي على:

• PORT: منفذ الخادم (مثل 3000).
• MAX_FILE_SIZE: الحد الأقصى لحجم الملف (بالبايت).
• UPLOAD_DIR: مجلد رفع الملفات المؤقتة.

أنشئ ملف .env في جذر المشروع واملأ القيم المناسبة. مثال:

PORT=3000
MAX_FILE_SIZE=10485760
UPLOAD_DIR=./uploads

كيف تنقل ملفاً عبر QR؟

1. شغّل الخادم كما في الخطوات السابقة.
2. افتح المتصفح على العنوان المحلي.
3. اختر ملفاً من جهازك (مثلاً PDF صغير).
4. سيظهر رمز QR على الشاشة.
5. امسح الرمز بهاتفك (استخدم كاميرا الهاتف أو تطبيق ماسح QR).
6. سيبدأ التحميل على هاتفك.

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي/الخليجي

• نقل ملف PDF صغير من اللابتوب إلى الجوال: مثلاً، عقد إيجار أو فاتورة، بدلاً من إرسالها بالبريد الإلكتروني.
• مشاركة رابط تحميل سريع مع زميل في العمل: في اجتماع، يمكنك عرض QR على الشاشة ويمسحه زميلك لتحميل الملف فوراً.
• استخدام في ورشة عمل تقنية: توزيع ملفات الإعدادات أو الشيفرات على المشاركين دون الحاجة لسحابة.

هل يستحق ShadowCat التجربة؟ تقييم صادق

المشروع واعد لكنه في مرحلة مبكرة جداً. README غير واضح، ونقص التوثيق قد يعيق المبتدئين. إذا كنت تحب تجربة أدوات جديدة ولديك خبرة بسيطة في Node.js، فجرّبه. لكن لا تتوقع أداة ناضجة. التقييم: 3/5 – جيد للتجربة، لكن ليس للإنتاج.

بدائل ShadowCat

أسئلة شائعة

هل ShadowCat آمن لنقل الملفات الحساسة؟

غير موصى به، لأن النقل عبر HTTP غير مشفر. إذا كنت بحاجة لأمان، استخدم HTTPS بنفسك أو اختر أداة مشفرة.

ما حجم الملف الأقصى الذي يمكن نقله؟

غير محدد في README، لكن افتراضياً قد يكون محدوداً بذاكرة الخادم. جرب ملفات صغيرة (أقل من 10MB).

هل يعمل على جميع المتصفحات؟

يفترض أن يعمل على المتصفحات الحديثة التي تدعم WebRTC وQR.

هل أحتاج إلى اتصال إنترنت؟

لا، إذا كان الخادم والشبكة محليين. لكن إذا أردت مشاركة عبر الإنترنت، فتحتاج إلى خادم عام.

كيف أحدث المشروع؟

استخدم git pull في مجلد المشروع، ثم npm install لتحديث الاعتماديات.

هل يوجد دعم للغة العربية؟

لا، الواجهة باللغة الإنجليزية. لكن يمكنك تعديل الكود لإضافة العربية.

ما الفرق بين ShadowCat وأدوات مثل Snapdrop؟

Snapdrop ينقل الملفات مباشرة بين الأجهزة عبر WebRTC، بينما ShadowCat يحول الملف إلى رابط وQR، مما يسمح بنقل غير متزامن (المرسل يولد QR، المستقبل يمسحه لاحقاً).