مدقق فروقات ENV

مقارنة ملف env. الخاص بمرحلة التطوير مع الإنتاج، أو إعدادات النشر اليوم مع الأسبوع الماضي، بالنظر هي الطريقة التي تبدأ بها الانقطاعات الحقيقية: DATABASE_URL مفقود، PORT تغير بهدوء، مفتاح API تم تدويره في بيئة دون الأخرى. لصق الملفين في أداة مقارنة نصوص عامة لا يساعد كثيراً أيضاً — فهي تريك الأسطر المختلفة، وليس متغيرات البيئة التي تغيرت فعلاً، كما أنها تطبع كل قيمة سرية بشكل واضح لحظة مشاركتك النتيجة مع زميل.

هذه الأداة تحلل كلا الملفين بالطريقة التي يقرأ بها dotenv فعلاً — زوج واحد KEY=value في كل سطر، تجاهل تعليقات # والأسطر الفارغة، إزالة علامات الاقتباس المفردة أو المزدوجة عن القيم (مع فك ترميز \n فقط داخل علامات الاقتباس المزدوجة، تماماً كما تنص اتفاقية dotenv)، مع السماح ببادئة `export KEY=value` اختيارياً بالطريقة التي تستخدمها ملفات env المستوردة من الشل. يتحول كل ملف إلى خريطة نظيفة من المفتاح إلى القيمة، ثم تُقارن الخريطتان بالمفتاح: الموجود فقط في الملف أ 'محذوف'، الموجود فقط في الملف ب 'مُضاف'، الموجود في كليهما بقيمة مختلفة 'متغير'، والقيم المتطابقة 'غير متغير' وتُخفى افتراضياً ليظل الجدول مركزاً على ما اختلف فعلاً.

الميزة التي تجعل هذا آمناً للاستخدام الفعلي مع الأسرار الحقيقية هي الإخفاء التلقائي. كل قيمة تظهر في جدول الفروقات تُفحص مقابل إشارتين مستقلتين: هل يبدو اسم مفتاحها سراً (مطابقة غير حساسة لحالة الأحرف مع KEY, SECRET, TOKEN, PASSWORD, PRIVATE أو CREDENTIAL)، أو هل للقيمة نفسها إنتروبيا شانون مرتفعة — وهو نفس المقياس المعلوماتي النظري (-Σ p(c)·log2(p(c)) على أحرف القيمة) الذي يميز مفاتيح API والرموز وكلمات المرور العشوائية إحصائياً عن الكلمات العادية حتى عندما لا يعطي اسم المفتاح أي تلميح. أي من الإشارتين كافية لإخفاء القيمة إلى أول حرفين وآخر حرفين فقط، ويتم حساب ذلك بشكل مستقل للجانب القديم والجديد في كل صف متغير.

كل شيء — التحليل، المقارنة، تسجيل الإنتروبيا والإخفاء — يعمل بالكامل داخل متصفحك؛ لا الملفان ولا أي قيمة مستخرجة منهما تُرسل إلى أي مكان أبداً. هذا هو الضمان الصحيح لأداة مهمتها بأكملها هي النظر إلى ملفين يُحتمل بشدة أنهما يحتويان على بيانات اعتماد قواعد بيانات حقيقية ومفاتيح API وكلمات مرور جنباً إلى جنب.