الواجهة هي خمس مساحات عمل — نظرة عامة، بايتات، أنماط، كود، والكل — فوق نفس التحديد. تحليل ثابت فقط: العينات تُحلل، ولا تُنفذ أبدًا.

لقطات الشاشة

اللوحات

مُنتجة بنفس الكود الذي ترسم به الواجهة، مباشرة من سطر الأوامر — أعد توليدها بـ python docs/make_plates.py.

نفس البايتات، رقم واحد مختلف. لهذا يوجد مقترح الخطوة: خطوة الصف الخاطئة تحول الصورة الفوتوغرافية إلى ضوضاء قطرية، فتستنتج أنه لا توجد صورة فوتوغرافية.

ARCHITECTURE.md هو كيف يتم تجميعها: ما يُشحن، العلامة التجارية التي يرثها كل سطح، الاتفاقيات التي يجب أن يتبعها أي شاشة جديدة، والقيود المتعمدة. SECURITY.md هو الموقف الأمني.

بدء سريع

تشغيل الخادم

يطبع عنوان URL يحتوي رمز جلسة — افتحه. كل مسار /api يتطلب الرمز، لأن "يستمع فقط على localhost" ليس دفاعًا ضد صفحة ويب في تبويب آخر، تصل إلى 127.0.0.1 مثل أي أصل آخر. SECURITY.md يحتوي المنطق.

الوصول إلى الملفات محصور في --root (الافتراضي: دليل العمل)، لذا تُرفض المسارات خارجه.

الحدود

كل الأربعة لها علم ومتغير بيئة، وكل الأربعة موجودة لمنع مستدعي محلي من استهلاك أكثر مما قصدت. الافتراضات مختارة لجهاز محمول؛ ارفعها إذا كان جهازك أكبر.

التحليلات مخزنة تحت ~/.cache/binviz (أو $BINVIZ_CACHE)، بمفتاح تجزئة المحتوى، لذا إعادة فتح ملف ثنائي فورية. ارفع --max-cache إذا كنت تفضل الاحتفاظ بالمزيد؛ ذاكرة التخزين المؤقت آمنة للحذف يدويًا في أي وقت — أسوأ حالة هي أن إعادة الفتح التالية تعيد التحليل.

أعلام أخرى: --token لتثبيت رمز عبر عمليات إعادة التشغيل (مفيد مع وكيل تطوير Vite، الذي يقرأ BINVIZ_TOKEN)، --port، --cache، و--no-auth لـ CI. --no-auth يطبع لافتة تخبرك بما أطفأه؛ لا تستخدمه على جهاز تشاركه.

نافذة سطح المكتب

نفس الخادم، نفس الرمز، نفس تقييد --root مثل binviz serve — الفرق الوحيد هو ما يعرضه. بدون تثبيت pywebview، يفتح binviz app متصفحك بدلاً من ذلك.

يطبع عنوان URL الذي يخدم عليه، عمدًا: تغليف الواجهة في نافذة لا يزيل مستمع الشبكة، بل يسهل فقط نسيان وجوده. المستمع مصادق عليه في كلتا الحالتين، ولا يوجد --no-auth على binviz app.

تعرض النافذة وظيفة واحدة بالضبط للصفحة — منتقي ملفات أصلي — ولا شيء آخر. انظر src/binviz/app.py لمعرفة لماذا تلك القائمة قصيرة كما هي.

بناء تطبيق مستقل

الإصدارات تشحن عجلة ولا شيء آخر. برنامج Python مجمد غير موقع يضم capstone وlief ويوجد لتشريح الملفات الثنائية المضغوطة هو بالضبط الملف الشخصي الذي تخطئ فيه SmartScreen وهجمات AV — لذا بدلاً من شحن واحد، يحمل المستودع ما تحتاجه لبنائه بنفسك، مما يتجاوز توقيع الكود تمامًا.

توقع ~100 ميجابايت، يهيمن عليها numpy وlief. إنها حزمة onedir، وليست ملفًا واحدًا ذاتي الاستخراج: أطلق dist/binviz/binviz.exe (أو انقر نقرًا مزدوجًا) لنافذة سطح المكتب، أو أعطه أي أمر فرعي — dist/binviz/binviz.exe triage sample.exe — لأن البناء المجمد هو CLI كامل، وليس النافذة فقط.

خطوة التجهيز ليست اختيارية. web/dist يعيش خارج حزمة Python، لذا تخطيها ينتج تطبيقًا تفتح نافذته على JSON 404؛ يرفض spec البناء بدلاً من السماح بذلك بصمت.

على macOS نفس الأمر ينتج أيضًا dist/Striate.app، بعلامة تجارية من packaging/icons/icon.icns. لم يُشغل أي منهما على Mac — انظر ARCHITECTURE.md §5.

--root لا يزال افتراضيًا إلى دليل العمل، لذا ملف تنفيذي بنقر مزدوج محصور في المجلد الذي يبدأ فيه — وهو عادةً مجلد التطبيق نفسه. اضبط "بدء في" للاختصار، أو أطلقه بـ --root DIR.

ملف تنفيذي بنقر مزدوج يطلب بيانات اعتماد. بدون وسائط، يشغل البناء المجمد binviz app --auth local، وهو الفرق الوحيد عن افتراضي العجلة نفسه بعدم وجود شاشة تسجيل دخول. الاثنان يجيبان على سؤالين مختلفين: binviz app المكتوب في طرفية هو بالفعل فعل متعمد من مالك الجلسة، بينما النقر المزدوج لا يثبت شيئًا — إنه مسار الإطلاق الوحيد بدون طرفية، بدون أمر مكتوب وبدون قرار تقييد خلفه. طلب بيانات الاعتماد هو كيف تقول النافذة بصوت عالٍ ما كانت الطرفية ستقوله. شغّل binviz passwd أولاً لتعيين واحدة، أو مرر --auth none صراحةً لتخطيها؛ أي شيء تقدمه في سطر الأوامر يظل يفوز.

تسجيل الدخول

افتراضيًا لا توجد شاشة تسجيل دخول ولا شيء للنسخ: الخادم يصك رمز جلسة ويحقنه في الصفحة التي يخدمها، لذا فتح http://127.0.0.1:8000/ يعمل فقط بينما كل استدعاء API لا يزال مصادقًا عليه.

على جهاز تشاركه، شغّل شاشة تسجيل الدخول:

إذا تخطيت binviz passwd، أول تسجيل دخول يطالب بالتثبيت — لافتة بدء التشغيل تحذر من ذلك، لأن من يصل إلى المنفذ أولاً يصبح الحساب.

ملف تنفيذي مجمد بنقر مزدوج يشغل --auth local لنفسه؛ انظر بناء تطبيق مستقل لمعرفة لماذا يختلف هذا الافتراضي عن العجلة.

شاشة تسجيل الدخول ليست حدود الأمان؛ فحص الرمز على كل مسار /api هو. أي شيء على الجهاز يمكنه تخطي النموذج واستدعاء API مباشرة، وهذا بالضبط سبب وجود الرمز. انظر SECURITY.md.

الأمان

binviz يفتح ملفات اختارها مهاجم — هذه هي الوظيفة، وليست حالة حافة، وأداة تحليل أولي حيث تحليل البرامج الضارة يعرض المحلل للخطر هو أسوأ فشل متاح. العينات تُحلل، ولا تُنفذ أبدًا. ما يُفعل بالباقي:

ضد ملف ثنائي عدائي

• التحليل يتدهور بدلاً من أن يفشل: ملف ثنائي لا يستطيع LIEF فهمه يتراجع إلى نموذج خام، لذا العينة التالفة التي تريد النظر إليها أكثر ما زالت قابلة للفحص.
• كل ربط مقيد بـ EOF، وما قُص يُبلغ في تحذيرات النموذج بدلاً من تصحيحه بصمت.
• فك الترميز لا يمكن أن يحلق إلى الأبد — المسح يحد عند 1M تعليمة ويحمل مجموعة زيارات، لذا قفزة إلى الذات تنتهي بنيويًا بدلاً من مهلة. استرداد جدول القفز يحد عند 256 إدخالًا.
• مسارات التخزين المؤقت لا يمكن اجتيازها: id في كل مسار /api/{id}/… يجب أن يكون بالضبط 64 حرفًا سداسيًا قبل استخدامه لبناء مسار.
• الملفات الكبيرة تتدفق بدلاً من التخزين المؤقت، لذا ملف أكبر من RAM بطيء بدلاً من انهيار نفاد الذاكرة.

ضد متصفح عدائي — التهديد الذي لا يعالجه "يستمع فقط على localhost"، لأن صفحة في تبويب آخر تصل إلى 127.0.0.1 مثل أي أصل آخر:

• كل مسار /api يتطلب رمزًا. يُصك عند بدء التشغيل ويُحقن في الصفحة، لذا لا يُلصق شيء يدويًا ولا يُترك أي مسار مفتوحًا.
• شاشة تسجيل الدخول ليست حدود الأمان — فحص الرمز هو. يمكن تخطي النموذج؛ لا يمكن تخطي الرمز.
• الوصول إلى الملفات محصور في --root، الذي افتراضيًا إلى دليل العمل. تُرفض المسارات خارجه.
• قائمة سماح Host وCORS ضيقة، لذا الأصل الذي يحتاج الوصول هو الوحيد الذي يحصل عليه.
• البيانات الوصفية الثنائية لا يمكن أن تصبح سكربت: السلاسل المرفوعة من عينة — أسماء الأقسام، الرموز — تمر عبر هارب واحد، مدعوم بـ CSP.
• الطلبات محدودة ومتحقق منها — حجم الرفع، حجم التخزين المؤقت، أبعاد الصورة النقطية وتزامن التحليل كلها لها سقوف (انظر الحدود).

نافذة سطح المكتب لا تزيل مستمع الشبكة، بل تسهل فقط نسيانه. لذا لا يوجد --no-auth على binviz app، وجسر js_api يعرض طريقة واحدة بالضبط — pick_file()، التي لا تأخذ وسائط وتُرجع مسارًا عبر نفس تقييد --root. يفشل اختبار إذا ظهرت طريقة ثانية أبدًا.

بيانات الاعتماد لـ --auth local هي ملخصات scrypt مكتوبة بوضع 0600؛ binviz لا يخزن كلمة مرور نصية.

SECURITY.md يحتوي نموذج التهديد، المنطق وراء كل ضابط، ما لم يُفعل عمدًا بعد، وكيفية الإبلاغ عن ثغرة بشكل خاص.

الترخيص

MIT — انظر LICENSE.

المجموعة تعبر تجميع عينات ELF بـ zig cc، لذا لا حاجة لأدوات Linux على Windows/macOS — العينات تُحلل، ولا تُنفذ أبدًا.