pycdc-studio

中文说明

Una interfaz gráfica de escritorio con Qt Widgets para explorar bytecode de Python usando pycdc / pycdas, inspeccionar resultados de descompilación nativa, importar la salida de Pyarmor oneshot y reintentar objetos de código no soportados con respaldo de IA.

La aplicación es compatible con entornos de escritorio Windows y Linux.

Capturas de pantalla

Área de trabajo principal

Respaldo de IA

Qué hace

• Abre archivos .pyc / .pyo directamente
• Arrastra una carpeta a la ventana y descubre recursivamente archivos de bytecode compatibles
• Importa un proyecto ofuscado con Pyarmor a través del flujo de trabajo oneshot incluido
• Muestra todos los archivos descubiertos juntos en el árbol izquierdo
• Inspecciona árboles de objetos de código para módulos, clases, funciones, lambdas y comprensiones
• Compara:
  • Combinado
  • Nativo
  • IA
• Ver metadatos y desensamblado por nodo
• Previsualiza el prompt exacto enviado al modelo de respaldo de IA
• Reintenta el nodo seleccionado actualmente con IA usando un botón de acción prominente o Ctrl+R

Estructura actual de la IU

• Izquierda: árbol de objetos de código
• Centro: vistas de código fuente combinado / nativo / IA
• Derecha: desensamblado / metadatos / prompt / registro

Respaldo de IA

La aplicación no envía todo el .pyc por defecto.

Construye un prompt a partir del objeto de código seleccionado actualmente, incluyendo:

• nombre calificado
• tipo de objeto
• vistas previas de names / varnames / consts
• error nativo
• desensamblado

Eso mantiene la reconstrucción de respaldo centrada en el nodo seleccionado en lugar de todo el archivo.

Integración con pycdc

La aplicación actualmente prefiere ejecutables locales junto al binario de la aplicación y buscará:

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

en el mismo directorio que el binario de pycdc-studio.

Puedes sobrescribirlos con variables de entorno:

• PYCDC_STUDIO_PYCDC
• PYCDC_STUDIO_PYCDAS

Importación de Pyarmor

La aplicación puede importar proyectos protegidos con Pyarmor delegando en Lil-House/Pyarmor-Static-Unpack-1shot.

Flujo de integración actual:

1. Ejecutar oneshot/shot.py en un directorio de proyecto Pyarmor seleccionado
2. Dejar que pyarmor-1shot genere .1shot.das y .1shot.cdc.py
3. Cargar esos archivos generados de vuelta en la interfaz de la zona de trabajo existente

Se espera que los paquetes de lanzamiento incluyan automáticamente la cadena de herramientas oneshot de Pyarmor y las dependencias de paquetes Python necesarias.

Para desarrollo local, el código actual primero busca archivos incluidos junto al paquete de la aplicación, y también admite un clon local en:

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

y espera que pyarmor-1shot / pyarmor-1shot.exe estén disponibles en el mismo directorio que shot.py.

También necesitas un entorno Python que pueda ejecutar shot.py, incluyendo pycryptodome.

Si tu estructura es diferente, aún puedes sobrescribirla con variables de entorno:

• PYCDC_STUDIO_PYARMOR_PYTHON
• PYCDC_STUDIO_PYARMOR_SHOT
• PYCDC_STUDIO_PYARMOR_PYTHONPATH
• PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT

Preparar la herramienta upstream para desarrollo local

Ejemplo:

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

Usarlo en la interfaz

1. Inicia pycdc-studio
2. Abre Archivo -> Importar proyecto Pyarmor...
3. Elige el directorio raíz que contiene los scripts ofuscados y pyarmor_runtime
4. Espera a que los archivos .1shot.* generados se importen a la zona de trabajo

Notas:

• El importador usa un directorio de salida temporal a menos que PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT esté configurado.
• El desensamblado es generalmente más fiable que el código fuente descompilado.
• Archivos como los paquetes de PyInstaller aún deben desempaquetarse antes de usar este flujo.
• Las compilaciones empaquetadas están diseñadas para funcionar sin configurar manualmente las variables de entorno de Pyarmor.

Configuración de IA

Antes de usar el respaldo de IA, abre Configuración y configura al menos:

• URL base
• Clave API
• Modelo

El cliente actual espera un endpoint de API compatible con OpenAI.

El diálogo de configuración almacena la configuración del proveedor con QSettings y recurre a variables de entorno cuando un campo está vacío.

Variables de entorno compatibles:

• PYCDC_STUDIO_AI_BASE_URL
• PYCDC_STUDIO_AI_API_KEY
• PYCDC_STUDIO_AI_MODEL
• PYCDC_STUDIO_AI_SYSTEM_PROMPT

Compilar

Requisitos:

• Qt 6 Widgets
• Qt Network
• CMake
• Compilador C++17

Ejemplo:

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

Uso

1. Inicia pycdc-studio
2. Abre un archivo .pyc / .pyo, o arrastra una carpeta a la ventana
3. O abre Archivo -> Importar proyecto Pyarmor... para un proyecto protegido con Pyarmor
4. Abre Configuración desde el menú superior y configura tu modelo de IA si deseas usar el respaldo de IA
5. Selecciona un archivo u objeto de código en el árbol
6. Inspecciona la salida nativa, desensamblado, metadatos y contexto del prompt
7. Usa Reintentar con IA en el nodo seleccionado si la descompilación nativa está incompleta o es incorrecta

Muestras de prueba

Casos de prueba más largos están incluidos en test/:

• workflow_orchestrator.py
• async_batch_runner.py
• plugin_config_resolver.py
• además de varias muestras más pequeñas

El repositorio rastrea solo las muestras fuente.

Para generar archivos .pyc locales para pruebas de arrastrar y soltar:

python test/compile_test_samples.py

Ese script escribe el bytecode compilado en test/__pycache__/.

Notas

Este proyecto aún es experimental.

La vista Combinado actual es un documento mixto honesto:

• fuente nativa cuando está disponible
• parches de respaldo de IA añadidos por objeto de código

Todavía no es un fusionador de código fuente en línea completo.

Licencia

Este proyecto se integra con pycdc / pycdas, cuyo proyecto upstream está licenciado bajo GPL-3.0.

• pycdc: GPL-3.0
• los paquetes de lanzamiento que incluyan pycdc / pycdas deben incluir el aviso GPL-3.0
• los paquetes de lanzamiento también registran el repositorio y commit de pycdc upstream incluido en THIRD_PARTY_NOTICES.txt

Consulta el proyecto upstream para los detalles completos de la licencia:

• zrax/pycdc