Rizin Notebook

مفكرة لتحليل الثنائيات باستخدام rizin. احتفظ بالملاحظات والأوامر والبرامج النصية منظمة حسب كل ثنائي.

يتطلب rizin 0.7.0 أو أحدث.

ما تفعله

كل صفحة من المفكرة مرتبطة بثنائي واحد. تخزّن الثنائي نفسه، وتجزئته SHA-256، وقائمة من الخلايا:

خلايا الأوامر - أمر rizin ومخرجاته
خلايا البرامج النصية - مقتطف JavaScript يتم تشغيله على الخادم مقابل أنبوب rizin
خلايا الترميز (Markdown) - ملاحظات حرة

تُخزَّن الصفحات كملفات .rznb فردية (قواعد بيانات SQLite) في ~/.rizin-notebook/. يمكن تصديرها واستيرادها كملفات فردية مكتفية ذاتياً.

المكونات

خادم Go (rizin-notebook) - التطبيق الرئيسي. يقدم واجهة ويب، ويعرض واجهة برمجة تطبيقات REST بتنسيق protobuf + JSON، ويخزن كل شيء في ملفات .rznb الخاصة بكل صفحة.
rizin-notebook-plugin - إضافة جوهرية لـ rizin (C). تضيف أوامر NB إلى rizin بحيث يمكنك التفاعل مع المفكرة من صدفة rizin.
cutter-notebook-plugin - إضافة Cutter (C++/Qt6). تضيف لوحة Plugins -> Notebook وقائمة إلى Cutter.

الإضافات اختيارية. يعمل خادم Go بشكل مستقل مع متصفح فقط.

ملاحظة التوافق

خادم Go مستقل عن المنصة. تعتمد الإضافات على إصدار Rizin الذي تم بناؤها ضده.

إذا كان إصدارا rizin المستقل و Cutter مزودين بإصدارات Rizin مختلفة على جهازك، قم ببناء rz_notebook مرة لكل منهما. يمكن لكلا البناءين التحدث إلى نفس الخادم ومشاركة نفس بيانات .rznb.

قاعدة بسيطة:

خادم واحد
بناء rz_notebook واحد لكل إصدار Rizin قيد الاستخدام
إضافة Cutter واحدة إذا كنت تريد لوحة Cutter

لقطات الشاشة

لقطات شاشة المشروع منظمة تحت docs/images/.

واجهة الويب

الشكل 1. عرض الصفحة الرئيسية (مع بحث يعتمد على الخلية والنطاق، يدعم أوضاعاً متعددة.) صفحة إعدادات مفكرة Rizin

الشكل 2. صفحة الإعدادات لتكوين البيئة واختصارات لوحة المفاتيح والسلوك من جانب الخادم. اقتراحات الإكمال التلقائي لأوامر Rizin في واجهة الويب للمفكرة

اقتراحات الإكمال التلقائي لأوامر Rizin في واجهة الويب للمفكرة

الشكل 3. الإكمال التلقائي للأوامر في وحدة التحكم على الويب، مما يساعد في اكتشاف أوامر Rizin وإكمالها بسرعة. نافذة بحث وتعليمات الأوامر في واجهة الويب للمفكرة

نافذة بحث وتعليمات الأوامر في واجهة الويب للمفكرة

الشكل 4. نافذة تعليمات وبحث مدمجة للأوامر لاستكشاف وصف الأوامر والوسائط.

تكامل الإضافات

تكامل الإضافة الجوهرية لـ Rizin مع مفكرة Rizin

الشكل 5. تكامل الإضافة الجوهرية لـ Rizin، مما يتيح التفاعل مع المفكرة مباشرة من صدفة Rizin. لقطة شاشة لتكامل إضافة Cutter 1

الشكل 6. عرض تكامل إضافة Cutter يظهر تجربة المفكرة داخل واجهة Cutter. لقطة شاشة لتكامل إضافة Cutter 2

الشكل 7. عرض إضافي لسير عمل إضافة Cutter يوضح استخدامات محتملة للمفكرة.

بناء الخادم

go build -o rizin-notebook .

قم بتضمين سلسلة الإصدار أثناء عمليات البناء للإصدار:

go build -ldflags "-X main.NBVERSION=$(git rev-parse --short HEAD)" -o rizin-notebook .

التشغيل

./rizin-notebook

يفتح على http://127.0.0.1:8000/ افتراضياً.

العلامات:

-bind 127.0.0.1:8000    العنوان والمنفذ للاستماع
-root /                  بادئة مسار URL
-notebook /path/to/data  دليل البيانات (الافتراضي: ~/.rizin-notebook)
-debug-assets /path      تحميل القوالب من القرص بدلاً من المدمجة
-debug                   تفعيل سجلات طلبات HTTP

قم بتعيين RIZIN_PATH لتجاوز مسار ثنائي rizin المستخدم لتنفيذ الأنبوب.

بناء إضافة rizin

انظر rizin-notebook-plugin/README.md.

بناء إضافة Cutter

انظر cutter-notebook-plugin/README.md.

إذا كان Cutter يوزع Rizin مدمجاً خاصاً به، فيجب بناء إضافة rz_notebook التي تم تحميلها بواسطة Cutter ضد نفس إصدار Rizin المضمن.

تخزين البيانات

كل صفحة هي ملف .rznb في دليل البيانات. وهو قاعدة بيانات SQLite تحتوي على:

بيانات تعريف الصفحة (العنوان، اسم الملف الأصلي، مفتاح تخزين الثنائي، تجزئة SHA-256)
الخلايا (النوع، المحتوى، المخرجات، الطوابع الزمنية)
كتلة الثنائي نفسها
إعدادات خاصة بالصفحة (مفتاح/قيمة)

يحتفظ الخادم بفهرس catalog.db لإدراج سريع عبر جميع الصفحات.

في التشغيل الأول، يقوم الخادم تلقائياً بترحيل أي صفحات من تنسيق notebook.db الشامل الأقدم إلى التنسيق الفردي .rznb.

واجهة برمجة التطبيقات (API)

جميع أوامر إضافة NB تستخدم واجهة برمجة تطبيقات protobuf (Content-Type: application/x-protobuf). المخطط موجود في proto/notebook.proto.

واجهة برمجة تطبيقات JSON موازية على /api/v1/json/... تُستخدم بواسطة إضافة Cutter وواجهة المستخدم في المتصفح.

rizin-notebook

الأكثر شعبية