pycdc-studio

चीनी निर्देश

pycdc / pycdas के साथ पायथन बाइटकोड की खोज, मूल डीकंपाइलेशन परिणामों की जांच, Pyarmor वनशॉट आउटपुट आयात करने और AI फ़ॉलबैक के साथ असमर्थित कोड ऑब्जेक्ट्स को पुनः प्रयास करने के लिए एक Qt Widgets डेस्कटॉप UI।

एप्लिकेशन विंडोज और लिनक्स डेस्कटॉप वातावरण दोनों का समर्थन करता है।

स्क्रीनशॉट

मुख्य कार्यक्षेत्र

AI फ़ॉलबैक

यह क्या करता है

• .pyc / .pyo फ़ाइलों को सीधे खोलें
• एक फ़ोल्डर को विंडो में खींचें और समर्थित बाइटकोड फ़ाइलों को पुनरावर्ती रूप से खोजें
• बंडल वनशॉट वर्कफ़्लो के माध्यम से एक Pyarmor-ऑब्फस्केटेड प्रोजेक्ट आयात करें
• सभी खोजी गई फ़ाइलों को बाएं पेड़ में एक साथ दिखाएं
• मॉड्यूल, क्लास, फ़ंक्शन, लैम्ब्डा और कॉम्प्रिहेंशन के लिए कोड ऑब्जेक्ट ट्री का निरीक्षण करें
• तुलना करें:
  • मर्ज्ड
  • नेटिव
  • AI
• प्रति-नोड मेटाडेटा और डिसअसेंबली देखें
• AI फ़ॉलबैक मॉडल को भेजे गए सटीक प्रॉम्प्ट का पूर्वावलोकन करें
• एक प्रमुख एक्शन बटन या Ctrl+R का उपयोग करके वर्तमान में चयनित नोड को AI के साथ पुनः प्रयास करें

वर्तमान UI संरचना

• बाएं: कोड ऑब्जेक्ट ट्री
• केंद्र: मर्ज्ड / नेटिव / AI स्रोत दृश्य
• दाएं: डिसअसेंबली / मेटाडेटा / प्रॉम्प्ट / लॉग

AI फ़ॉलबैक

एप्लिकेशन डिफ़ॉल्ट रूप से पूरी .pyc नहीं भेजता है।

यह वर्तमान में चयनित कोड ऑब्जेक्ट से एक प्रॉम्प्ट बनाता है, जिसमें शामिल हैं:

• योग्य नाम
• वस्तु प्रकार
• नाम / वरनाम / कॉन्स्ट पूर्वावलोकन
• मूल त्रुटि
• डिसअसेंबली

यह पूरी फ़ाइल के बजाय चयनित नोड पर फ़ॉलबैक पुनर्निर्माण को केंद्रित रखता है।

pycdc एकीकरण

एप्लिकेशन वर्तमान में एप्लिकेशन बाइनरी के बगल में स्थानीय निष्पादन योग्य को प्राथमिकता देता है और खोजेगा:

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

pycdc-studio एप्लिकेशन बाइनरी के समान निर्देशिका में।

आप उन्हें पर्यावरण चर के साथ ओवरराइड कर सकते हैं:

• PYCDC_STUDIO_PYCDC
• PYCDC_STUDIO_PYCDAS

Pyarmor आयात

एप्लिकेशन Lil-House/Pyarmor-Static-Unpack-1shot को डेलिगेट करके Pyarmor-संरक्षित प्रोजेक्ट आयात कर सकता है।

वर्तमान एकीकरण प्रवाह:

1. चयनित Pyarmor प्रोजेक्ट निर्देशिका पर oneshot/shot.py चलाएँ
2. pyarmor-1shot को .1shot.das और .1shot.cdc.py उत्पन्न करने दें
3. उन उत्पन्न फ़ाइलों को मौजूदा कार्यक्षेत्र UI में वापस लोड करें

रिलीज़ पैकेज Pyarmor वनशॉट टूलचेन और आवश्यक पायथन पैकेज निर्भरताओं को स्वचालित रूप से बंडल करने की उम्मीद है।

स्थानीय विकास के लिए, वर्तमान कोड पहले एप्लिकेशन पैकेज के बगल में बंडल फ़ाइलों की तलाश करता है, और इस पर स्थानीय क्लोन का भी समर्थन करता है:

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

और अपेक्षा करता है कि pyarmor-1shot/pyarmor-1shot.exe shot.py के समान निर्देशिका में उपलब्ध हो।

आपको एक पायथन वातावरण की भी आवश्यकता है जो 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

UI में इसका उपयोग करें

1. pycdc-studio लॉन्च करें
2. फ़ाइल -> Pyarmor प्रोजेक्ट आयात करें... खोलें
3. वह रूट निर्देशिका चुनें जिसमें ऑब्फस्केटेड स्क्रिप्ट और pyarmor_runtime शामिल हैं
4. उत्पन्न .1shot.* फ़ाइलों के कार्यक्षेत्र में आयात होने की प्रतीक्षा करें

नोट्स:

• इम्पोर्टर एक अस्थायी आउटपुट निर्देशिका का उपयोग करता है जब तक कि PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT सेट न हो।
• डिसअसेंबली आमतौर पर डीकंपाइल स्रोत से अधिक विश्वसनीय है।
• इस प्रवाह का उपयोग करने से पहले PyInstaller बंडल जैसे आर्काइव को अभी भी अनपैक करने की आवश्यकता है।
• पैकेज्ड बिल्ड Pyarmor पर्यावरण चर को मैन्युअल रूप से कॉन्फ़िगर किए बिना काम करने के लिए हैं।

AI कॉन्फ़िगरेशन

AI फ़ॉलबैक का उपयोग करने से पहले, सेटिंग्स खोलें और कम से कम कॉन्फ़िगर करें:

• बेस URL
• API कुंजी
• मॉडल

वर्तमान क्लाइंट एक 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 compiler

उदाहरण:

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

उपयोग

1. pycdc-studio लॉन्च करें
2. .pyc/.pyo फ़ाइल खोलें, या विंडो में एक फ़ोल्डर खींचें
3. या Pyarmor-संरक्षित प्रोजेक्ट के लिए फ़ाइल -> Pyarmor प्रोजेक्ट आयात करें... खोलें
4. यदि आप AI फ़ॉलबैक का उपयोग करना चाहते हैं तो शीर्ष-स्तरीय मेनू से सेटिंग्स खोलें और अपना AI मॉडल कॉन्फ़िगर करें
5. पेड़ में एक फ़ाइल या कोड ऑब्जेक्ट चुनें
6. मूल आउटपुट, डिसअसेंबली, मेटाडेटा और प्रॉम्प्ट संदर्भ का निरीक्षण करें
7. यदि मूल डीकंपाइलेशन अधूरा या गलत है तो चयनित नोड पर AI के साथ पुनः प्रयास करें का उपयोग करें

परीक्षण नमूने

लंबे परीक्षण मामले test/ के अंतर्गत शामिल हैं:

• workflow_orchestrator.py
• async_batch_runner.py
• plugin_config_resolver.py
• और कई छोटे नमूने

रिपॉजिटरी केवल स्रोत नमूनों को ट्रैक करता है।

ड्रैग-एंड-ड्रॉप परीक्षण के लिए स्थानीय .pyc फ़ाइलें उत्पन्न करने के लिए:

python test/compile_test_samples.py

वह स्क्रिप्ट संकलित बाइटकोड को test/__pycache__/ में लिखती है।

नोट्स

यह प्रोजेक्ट अभी प्रायोगिक है।

वर्तमान मर्ज्ड दृश्य एक ईमानदार मिश्रित दस्तावेज़ है:

• जब उपलब्ध हो तो मूल स्रोत
• प्रति कोड ऑब्जेक्ट AI फ़ॉलबैक पैच जोड़े गए

यह अभी तक एक पूर्ण इनलाइन स्रोत मर्जर नहीं है।

लाइसेंस

यह प्रोजेक्ट pycdc/pycdas के साथ एकीकृत होता है, जिसका अपस्ट्रीम प्रोजेक्ट GPL-3.0 के तहत लाइसेंस प्राप्त है।

• pycdc: GPL-3.0
• रिलीज़ पैकेज जो pycdc/pycdas को बंडल करते हैं, उनमें GPL-3.0 नोटिस शामिल होना चाहिए
• रिलीज़ पैकेज बंडल किए गए अपस्ट्रीम pycdc रिपॉजिटरी और कमिट को THIRD_PARTY_NOTICES.txt में भी रिकॉर्ड करते हैं

पूर्ण लाइसेंस विवरण के लिए अपस्ट्रीम प्रोजेक्ट देखें:

• zrax/pycdc