مفكرة ريزن

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

يتطلب ريزن 0.7.0 أو أحدث.

ما الذي تفعله

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

خلايا الأوامر - أمر ريزن ومخرجاته
خلايا البرامج النصية - مقطع JavaScript يُشغَّل على الخادم عبر أنبوب ريزن
خلايا ماركداون - ملاحظات حرة

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

يمكن تصديرها واستيرادها كملفات مستقلة واحدة.

المكونات

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

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

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

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

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

قاعدة بسيطة:

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

لقطات الشاشة

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

واجهة الويب

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

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

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

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

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

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

تكامل الإضافة الأساسية لريزن لمفكرة ريزن

الشكل 5. تكامل الإضافة الأساسية لريزن، مما يتيح التفاعل مع المفكرة مباشرة من واجهة ريزن الطرفية. لقطة شاشة تكامل إضافة كتر 1

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

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

بناء الخادم

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-notebook-plugin/README.md.

بناء إضافة كتر

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

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

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

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

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

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

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

API

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

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

rizin-notebook

الأكثر شعبية