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:

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:

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:

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