pycdc-studio

中文说明

واجهة رسومية سطح مكتب مبنية على Qt Widgets لاستكشاف بايت كود بايثون باستخدام pycdc / pycdas، وفحص نتائج فك التجميع الأصلية، واستيراد مخرجات Pyarmor oneshot، وإعادة محاولة كائنات الكود غير المدعومة باستخدام التراجع عن طريق AI.

يدعم التطبيق بيئات سطح المكتب لنظامي Windows و Linux.

لقطات الشاشة

مساحة العمل الرئيسية

التراجع باستخدام AI

ما يفعله

• يفتح ملفات .pyc / .pyo مباشرة
• يسحب مجلدًا إلى النافذة ويكتشف بشكل متكرر ملفات البايت كود المدعومة
• يستورد مشروعًا مشوشًا باستخدام Pyarmor من خلال سير العمل المرفق oneshot
• يعرض جميع الملفات المكتشفة معًا في الشجرة اليسرى
• يفحص أشجار كائنات الكود للوحدات، والفئات، والدوال، واللامبدا، والتفهمات
• يقارن:
  • Merged
  • Native
  • AI
• يعرض بيانات التعريف ورمز التفكيك لكل عقدة
• يعرض الاستفسار الدقيق المرسل إلى نموذج التراجع AI
• يعيد محاولة العقدة المحددة حاليًا باستخدام AI عبر زر إجراء بارز أو Ctrl+R

هيكل الواجهة الحالي

• اليسار: شجرة كائنات الكود
• الوسط: مناظر المصدر المدمج / الأصلي / AI
• اليمين: رمز التفكيك / البيانات الوصفية / الاستفسار / السجل

التراجع باستخدام AI

لا يرسل التطبيق ملف .pyc بأكمله افتراضيًا.

يبني استفسارًا من كائن الكود المحدد حاليًا، يتضمن:

• الاسم المؤهل
• نوع الكائن
• معاينات الأسماء / أسماء المتغيرات / الثوابت
• الخطأ الأصلي
• رمز التفكيك

يحافظ ذلك على إعادة بناء التراجع مركزة على العقدة المحددة بدلاً من الملف بأكمله.

تكامل pycdc

يفضل التطبيق حاليًا الملفات القابلة للتنفيذ المحلية بجانب التطبيق الثنائي وسيبحث عن:

• pycdc.exe
• pycdc
• pycdas.exe
• pycdas

في نفس دليل تطبيق pycdc-studio الثنائي.

يمكنك تجاوزها باستخدام متغيرات البيئة:

• PYCDC_STUDIO_PYCDC
• PYCDC_STUDIO_PYCDAS

استيراد Pyarmor

يمكن للتطبيق استيراد المشاريع المحمية بواسطة Pyarmor عن طريق تفويض المهمة إلى Lil-House/Pyarmor-Static-Unpack-1shot.

سير العمل الحالي للتكامل:

1. تشغيل oneshot/shot.py على دليل مشروع Pyarmor محدد
2. السماح لـ pyarmor-1shot بتوليد ملفات .1shot.das و .1shot.cdc.py
3. تحميل تلك الملفات المولدة مرة أخرى في واجهة مساحة العمل الحالية

من المتوقع أن تقوم حزم الإصدارات بتضمين سلسلة أدوات Pyarmor oneshot وتبعيات حزمة Python المطلوبة تلقائيًا.

للتطوير المحلي، يبحث الكود الحالي أولاً عن الملفات المرفقة بجانب حزمة التطبيق، ويدعم أيضًا نسخة مستنسخة محلية في:

• external/Pyarmor-Static-Unpack-1shot/oneshot/shot.py

ويتوقع أن يكون pyarmor-1shot / pyarmor-1shot.exe متاحًا في نفس دليل shot.py.

تحتاج أيضًا إلى بيئة Python يمكنها تشغيل shot.py، بما في ذلك pycryptodome.

إذا كان تخطيطك مختلفًا، فلا يزال بإمكانك تجاوزه باستخدام متغيرات البيئة:

• PYCDC_STUDIO_PYARMOR_PYTHON
• PYCDC_STUDIO_PYARMOR_SHOT
• PYCDC_STUDIO_PYARMOR_PYTHONPATH
• PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT

تحضير الأداة العلوية للتطوير المحلي

مثال:

git clone https://github.com/Lil-House/Pyarmor-Static-Unpack-1shot external/Pyarmor-Static-Unpack-1shot
cmake -S external/Pyarmor-Static-Unpack-1shot/pycdc -B external/Pyarmor-Static-Unpack-1shot/build
cmake --build external/Pyarmor-Static-Unpack-1shot/build --config Release
cmake --install external/Pyarmor-Static-Unpack-1shot/build --config Release
python -m pip install pycryptodome

استخدامه في الواجهة

1. شغّل pycdc-studio
2. افتح File -> Import Pyarmor Project...
3. اختر الدليل الجذر الذي يحتوي على النصوص المشوشة و pyarmor_runtime
4. انتظر حتى يتم استيراد ملفات .1shot.* المولدة إلى مساحة العمل

ملاحظات:

• يستخدم المستورد دليل إخراج مؤقت ما لم يتم تعيين PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT.
• رمز التفكيك بشكل عام أكثر موثوقية من المصدر المُفكك.
• لا يزال يتعين فك ضغط الأرشيفات مثل حزم PyInstaller قبل استخدام هذا التدفق.
• الإصدارات المبنية مخصصة للعمل دون تكوين متغيرات بيئة Pyarmor يدويًا.

تكوين AI

قبل استخدام التراجع عن طريق AI، افتح Settings وقم بتكوين على الأقل:

• Base URL
• API Key
• Model

يتوقع العميل الحالي نقطة نهاية متوافقة مع OpenAI API.

يقوم مربع حوار الإعدادات بتخزين تكوين المزود باستخدام QSettings ويلجأ إلى متغيرات البيئة عندما يكون الحقل فارغًا.

متغيرات البيئة المدعومة:

• PYCDC_STUDIO_AI_BASE_URL
• PYCDC_STUDIO_AI_API_KEY
• PYCDC_STUDIO_AI_MODEL
• PYCDC_STUDIO_AI_SYSTEM_PROMPT

البناء

المتطلبات:

• Qt 6 Widgets
• Qt Network
• CMake
• مترجم C++17

مثال:

cmake -S . -B build
cmake --build build

الاستخدام

1. شغّل pycdc-studio
2. افتح ملف .pyc / .pyo، أو اسحب مجلدًا إلى النافذة
3. أو افتح File -> Import Pyarmor Project... لمشروع محمي باستخدام Pyarmor
4. افتح Settings من القائمة العلوية وقم بتكوين نموذج AI الخاص بك إذا كنت ترغب في استخدام التراجع عن طريق AI
5. حدد ملفًا أو كائن كود في الشجرة
6. افحص المخرجات الأصلية، ورمز التفكيك، والبيانات الوصفية، وسياق الاستفسار
7. استخدم Retry with AI على العقدة المحددة إذا كان فك التجميع الأصلي غير كامل أو خاطئ

عينات الاختبار

يتم تضمين حالات اختبار أطول تحت test/:

• workflow_orchestrator.py
• async_batch_runner.py
• plugin_config_resolver.py
• بالإضافة إلى عدة عينات أصغر

يتتبع المستودع فقط عينات المصدر.

لتوليد ملفات .pyc محلية لاختبار السحب والإفلات:

python test/compile_test_samples.py

يقوم ذلك البرنامج النصي بكتابة البايت كود المُجمَّع في test/__pycache__/.

ملاحظات

لا يزال هذا المشروع تجريبيًا.

عرض Merged الحالي هو مستند مختلط صريح:

• المصدر الأصلي عند توفره
• تصحيحات التراجع عن AI ملحقة لكل كائن كود

لم يصبح بعد أداة دمج مصدر مضمنة كاملة.

الترخيص

يتكامل هذا المشروع مع pycdc / pycdas، الذي تم ترخيص مشروعه العلوي بموجب GPL-3.0.

• pycdc: GPL-3.0
• يجب أن تتضمن حزم الإصدارات التي ترفق pycdc / pycdas إشعار GPL-3.0
• تسجل حزم الإصدارات أيضًا مستودع pycdc العلوي المرفق والالتزام في THIRD_PARTY_NOTICES.txt

راجع المشروع العلوي للحصول على تفاصيل الترخيص الكاملة:

• zrax/pycdc