
تشغيل شيفرة ARM64 المحفوظة في Node أو في متصفح؛ وفحص بكسلات الصورة المفكوكة ترميزها والذاكرة المهيّأة.
شغّل الشيفرة الأصلية المحفوظة. أعد فتح حالتها المُهيّأة. تُغلّف Capsulith دوال ARM64 مختارة وعقود استدعائها والذاكرة المملوكة لها من أجل Node أو المتصفح. احتفظ بالتعليمات الأصلية واستأنف كائنًا مُهيّأً في عامل (worker) جديد، دون التطبيق الأصلي.
افتح منصة عمل الصور الأصلية واختر Load & run example. تعمل حالة QOI المُعدّة محليًا دون حساب أو خادم رفع أو ملف ثنائي أصلي أو مُصرّف.

يستخدم PNG بيانات RGBA المفكوكة عبر المتصفح كخط أساس صريح للمقارنة؛ أما المدخلات الخاصة بـ QOI فقط فلا تتوفر لها مقارنة مستقلة ببكسلات المصدر. الصور محدودة بـ 256 بكسل لكل بُعد و1 MiB. هذا عرض توضيحي لمكوّن أصلي مُعدّ بمصدر معروف، وليس برنامج ترميز جديدًا ولا استعادة صيغة شاملة. مصدر QOI الأصلي، والعقود، وضوابط أصلية/FFmpeg مستقلة، وأوامر Node المستقلة.
أحضر صورة PNG أو QOI صغيرة. يكتب المُرمّز الأصلي المُستخرج ملف QOI، ويُعيد مُفكّك ترميز أصلي منفصل بكسلاتها، ويمكنك فحص بايتات RGBA الفردية. احتفظ بتخصيص البكسلات المُهيّأ، وأغلق العامل، ثم استعده وحرّره في عامل جديد.
جرّب عرض الكائن في المتصفح دون مفاتيح واضغط Run lifecycle. ينفّذ التعليمات المُستخرجة الفعلية محليًا؛ ولا يستدعي خادمًا لتوليد النتائج.
نزّل حزمة Python wheel من الإصدار، ثم:
python3 -m pip install capsulith-0.3.1-py3-none-any.whl
capsulith studio
افتح http://127.0.0.1:6359. يحتفظ Studio بالدالة بمفكك ترميز LZ4 وعينات xxHash. افتح Object studio، واختر Open original LZ4 example، ثم Run lifecycle لإنشاء دفق مُجمَّع فعلي وضغطه وحفظ قاموس والتحقق من نقطة استعادة واستعادتها ومتابعته وتحريره. لا حاجة إلى مفتاح API أو خدمة مدفوعة. يلزم Python 3.10+ وCapstone للاستخراج؛ بينما ينفّذ المتصفح عبر محاكي WebAssembly المضمّن. يلزم Node 20+ فقط لـ CLI أو لاستدعاءات Node المصدَّرة.
يقبل Studio مكتبة dylib بصيغة ARM64 Mach-O، ويجرد دوالها، ويستخرج جذرًا محددًا، ويتيح لك تحرير المخازن المؤقتة ومعاملات السجلات والمدخلات العددية ونوع الإرجاع. يربط عرض التبعيات الدوال المساعدة/الاستيرادات بمواقع الاستدعاء الفعلية والتعليمات الأصلية. ترتبط أحداث التنفيذ بمنطقة الذاكرة المسماة والكود الأصلي. تُظهر عمليات التنفيذ المتوقفة أدلة جزئية دون ادعاء نتيجة ناجحة.
Export portable capsule ينزّل البايتات والعقد والمدخلات الحالية، ومشغّلات Node/المتصفح، والخلفية المثبّتة، وكامل مصدر الخلفية/نصوص البناء والتراخيص. فك الضغط وشغّل node run.cjs، أو قدّم ذلك المجلد عبر HTTP وافتح مشغّله المستقل في المتصفح. لا حاجة إلى Python أو Capstone أو الملف الثنائي الأصلي لتلك الاستدعاءات. تقبل واجهة API المصدَّرة مدخلات مختلفة، وتدعم الإلغاء، وتفرض الحدود المعلنة.
طرق LZ4 الأصلية، واستعادة الوصول إلى القاموس، والمقارنة الأصلية الدقيقة في Object Studio
يستورد Object Studio ملف JSON لوحدة مستخرجة أو يقرأ قطعة ARM64 Mach-O مملوكة لك مع طرق مسماة معلنة صراحةً. افحص الجذور والقطع والتبعيات الفعلية؛ خصّص مخازن مؤقتة مسماة للمستدعي من hex أو من ملف محلي؛ اختر طريقة وقدّم مراجع مناطق مُنمَّطة أو أعدادًا صحيحة. تُظهر خريطة الذاكرة المناطق المملوكة الفعلية والتهيئة، ببايتات خام معتمة بدلًا من حقول مُخمَّنة. تأتي قيم الإرجاع ونطاقات الوصول والعدادات والأحداث المحدودة من التعليمات الأصلية.
احفظ نقطة استعادة قبل عملية قد تحتاج إلى التراجع عنها. استعادة وحدة مطابقة تحافظ على عناوين الضيف ومعرّفات المناطق لكنها تنشئ هوية نسخة جديدة؛ أعد ربط المراجع بمعرّف المنطقة. تحرير المدخلات يبطل الأدلة القديمة، والخطأ أو الإلغاء يتطلب نقطة استعادة سابقة أو نسخة جديدة. تحرير الذاكرة الأصلي وتحرير مخزن المستدعي عمليتان منفصلتان صريحتان في دورة الحياة. لا يخمّن وقت التشغيل أبدًا ما إذا كانت المؤشرات الأصلية لا تزال تشير إلى مخزن مؤقت.
يستخدم مثال CLI ملفات من المستودع. تثبيت wheel أعلاه لا يضع examples/ أو runtime/ في دليل العمل الخاص بك. من دليل لا يحتوي على مجلد Capsulith موجود، استنسخ المستودع وشغّل الأوامر من جذره:
git clone https://github.com/nazeeh111/Capsulith.git
cd Capsulith
capsulith module examples/lz4/liblz4.dylib \
--methods examples/native-objects/methods.json --out stream.module.json
node runtime/object-cli.cjs examples/native-objects/start.json \
--module stream.module.json --checkpoint-out first.checkpoint.json
# The first Node process has ended. This command opens a fresh worker.
node runtime/object-cli.cjs examples/native-objects/continue.json \
--module stream.module.json --checkpoint first.checkpoint.json
capsulith export-module stream.module.json \
--checkpoint first.checkpoint.json --out stream-object.zip
اختر أسماء مخرجات جديدة؛ ترفض أوامر تصدير الوحدة ونقطة التحقق والكائن الكتابة فوق الملفات الموجودة. برامج التشغيل المرفقة خاصة بدورة حياة LZ4 الموثقة. تحتاج الوحدات العامة إلى طرقها وبرامج تشغيلها الخاصة المعلنة من قبل المستدعي.
يحتوي تصدير الكائن على وحدة التعليمات الأصلية، وبايتات نقطة التحقق المحتفظ بها الاختيارية، ومشغلات Node/المتصفح المستقلة، واستوديو الكائن، ومصدر وقت التشغيل والواجهة الخلفية المقابل ونصوص البناء، والتراخيص، وبيان ملف يحتوي على البايتات وSHA256 والأذونات. قدّم المجلد وافتح index.html لاستعادة نقطة التحقق المجمّعة دون نقاط نهاية API، أو شغّل node run.cjs your-operations.json --checkpoint checkpoint.json. لا حاجة إلى الملفات الثنائية الأصلية وحزم Python والمترجمات للتنفيذ. تتضمن نقطة التحقق بايتات المستدعي المحتفظ بها؛ افحصها قبل المشاركة. راجع واجهة برمجة تطبيقات الكائن وتنسيق التشغيل والمثال الأصلي.
يمكن لفاكك ترميز قديم أو مجموع تحقق أو روتين ثنائي معزول أن يصبح واجهة برمجة تطبيقات صغيرة قابلة لإعادة الاستخدام. يُظهر Capsulith أي البايتات والاعتماديات تنتقل معه، وأين يقرأ التنفيذ ويكتب، ولماذا لا يمكن استخراج ميزة عندما تتطلب حالة غير مدعومة.
capsulith inspect legacy.dylib
capsulith extract legacy.dylib --root _decode \
--contract decode-contract.json --out decode.capsule.json
capsulith run decode.capsule.json --inputs input.json
capsulith export decode.capsule.json --inputs input.json --out decoder.zip
اختيار الجذر يقبل أيضًا عنوان بداية دالة موثّقًا، مثل --root 0x440. الرمز المُصدَّر ليس نموذجًا أوليًا (prototype). أنت توفّر عقد الاستدعاء الفعلي؛ لا يستنتج Capsulith واجهة ABI (القواعد التي تضع الوسائط والقيم المُعادة في السجلات). يحدّد دليل وقت التشغيل المخازن المؤقتة، والأعداد الصحيحة 32/64 بت، واستيرادات الذاكرة وحدودها. examples/xxhash/contract.json مثال كامل بثلاث وسائط.
LC_FUNCTION_STARTS. قد تُجرَّد أسماء الدوال المساعدة الخاصة؛ يجب أن تبقى حدود الدوال.__const/__cstring للقراءة فقط، واستيرادات صريحة محدودة لـ memmove وmemcpy وmemset.malloc وbzero وfree، وبايتات كومة مملوكة ومهيّأة، ونقاط تفتيش مرتبطة بالكود عند حدود الطرق. لا يُستنتج أي تخطيط للكومة أو إعادة كتابة للمؤشرات.