pycdc-studio

Descrição em chinês

Uma interface de desktop Qt Widgets para explorar bytecode Python com pycdc / pycdas, inspecionar resultados nativos de descompilação, importar saída oneshot do Pyarmor e tentar novamente objetos de código não suportados com fallback de IA.

O aplicativo suporta ambientes de desktop Windows e Linux.

Capturas de tela

Área de trabalho principal

Fallback de IA

O que faz

• Abre arquivos .pyc / .pyo diretamente
• Arraste uma pasta para a janela e descubra recursivamente arquivos de bytecode suportados
• Importe um projeto ofuscado com Pyarmor através do fluxo de trabalho oneshot incluído
• Mostra todos os arquivos descobertos juntos na árvore à esquerda
• Inspecione árvores de objetos de código para módulos, classes, funções, lambdas e comprehensions
• Compare:
  • Merged
  • Native
  • AI
• Veja metadados e desmontagem por nó
• Pré-visualize o prompt exato enviado ao modelo de fallback de IA
• Tente novamente o nó atualmente selecionado com IA usando um botão de ação proeminente ou Ctrl+R

Estrutura atual da interface

• Esquerda: árvore de objetos de código
• Centro: visualizações de código fonte merged / native / AI
• Direita: desmontagem / metadados / prompt / log

Fallback de IA

O aplicativo não envia o .pyc inteiro por padrão.

Ele monta um prompt a partir do objeto de código atualmente selecionado, incluindo:

• nome qualificado
• tipo do objeto
• pré-visualizações de names / varnames / consts
• erro nativo
• desmontagem

Isso mantém a reconstrução com fallback focada no nó selecionado, em vez do arquivo inteiro.

Integração com pycdc

O aplicativo atualmente prefere executáveis locais próximos ao binário do aplicativo e procurará por:

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

no mesmo diretório que o binário do pycdc-studio.

Você pode sobrescrevê-los com variáveis de ambiente:

• PYCDC_STUDIO_PYCDC
• PYCDC_STUDIO_PYCDAS

Importação do Pyarmor

O aplicativo pode importar projetos protegidos por Pyarmor delegando a Lil-House/Pyarmor-Static-Unpack-1shot.

Fluxo de integração atual:

1. Execute oneshot/shot.py em um diretório de projeto Pyarmor selecionado
2. Deixe pyarmor-1shot gerar .1shot.das e .1shot.cdc.py
3. Carregue esses arquivos gerados de volta na interface de trabalho existente

Espera-se que os pacotes de lançamento incluam a ferramenta oneshot do Pyarmor e as dependências de pacotes Python necessárias automaticamente.

Para desenvolvimento local, o código atual primeiro procura por arquivos incluídos próximos ao pacote do aplicativo, e também suporta um clone local em:

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

e espera que pyarmor-1shot / pyarmor-1shot.exe esteja disponível no mesmo diretório que shot.py.

Você também precisa de um ambiente Python que possa executar shot.py, incluindo pycryptodome.

Se seu layout for diferente, você pode ainda sobrescrevê-lo com variáveis de ambiente:

• PYCDC_STUDIO_PYARMOR_PYTHON
• PYCDC_STUDIO_PYARMOR_SHOT
• PYCDC_STUDIO_PYARMOR_PYTHONPATH
• PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT

Preparar a ferramenta upstream para desenvolvimento local

Exemplo:

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

Usar na interface

1. Inicie pycdc-studio
2. Abra File -> Import Pyarmor Project...
3. Escolha o diretório raiz que contém os scripts ofuscados e pyarmor_runtime
4. Aguarde a importação dos arquivos .1shot.* gerados no workspace

Notas:

• O importador usa um diretório de saída temporário, a menos que PYCDC_STUDIO_PYARMOR_OUTPUT_ROOT esteja definido.
• A desmontagem é geralmente mais confiável que o código fonte descompilado.
• Arquivos como pacotes PyInstaller ainda precisam ser descompactados antes de usar este fluxo.
• As compilações empacotadas devem funcionar sem configurar manualmente as variáveis de ambiente do Pyarmor.

Configuração de IA

Antes de usar o fallback de IA, abra Settings e configure pelo menos:

• Base URL
• API Key
• Model

O cliente atual espera um endpoint de API compatível com OpenAI.

A caixa de diálogo de configurações armazena a configuração do provedor com QSettings e recorre a variáveis de ambiente quando um campo está vazio.

Variáveis de ambiente suportadas:

• PYCDC_STUDIO_AI_BASE_URL
• PYCDC_STUDIO_AI_API_KEY
• PYCDC_STUDIO_AI_MODEL
• PYCDC_STUDIO_AI_SYSTEM_PROMPT

Compilação

Requisitos:

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

Exemplo:

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

Uso

1. Inicie pycdc-studio
2. Abra um arquivo .pyc / .pyo, ou arraste uma pasta para a janela
3. Ou abra File -> Import Pyarmor Project... para um projeto protegido por Pyarmor
4. Abra Settings no menu superior e configure seu modelo de IA se quiser usar o fallback de IA
5. Selecione um arquivo ou objeto de código na árvore
6. Inspecione a saída nativa, desmontagem, metadados e contexto do prompt
7. Use Retry with AI no nó selecionado se a descompilação nativa estiver incompleta ou errada

Amostras de teste

Casos de teste mais longos estão incluídos em test/:

• workflow_orchestrator.py
• async_batch_runner.py
• plugin_config_resolver.py
• além de várias amostras menores

O repositório rastreia apenas as amostras fonte.

Para gerar arquivos .pyc locais para teste de arrastar e soltar:

python test/compile_test_samples.py

Esse script escreve o bytecode compilado em test/__pycache__/.

Notas

Este projeto ainda é experimental.

A visualização Merged atual é um documento misto honesto:

• fonte nativa quando disponível
• patches de fallback de IA anexados por objeto de código

Ainda não é um merger de fonte inline completo.

Licença

Este projeto integra com pycdc / pycdas, cujo projeto upstream é licenciado sob GPL-3.0.

• pycdc: GPL-3.0
• pacotes de lançamento que incluem pycdc / pycdas devem incluir o aviso GPL-3.0
• pacotes de lançamento também registram o repositório e commit do pycdc upstream incluído em THIRD_PARTY_NOTICES.txt

Veja o projeto upstream para detalhes completos da licença:

• zrax/pycdc