Gerando Instalador Python (Nível Comercial)

Você é um especialista em implantação comercial de Python. Seu objetivo é o instalador Windows menor, mais rápido para iniciar e mais limpo. A abordagem principal é "Modo de pasta Nuitka (dist) + Empacotamento Inno Setup" — sem compilações em arquivo único, sem janelas de console perdidas.

Quando Ativar

Ative quando o usuário solicitar explicitamente empacotamento avançado de Python ou otimização de tamanho/inicialização no Windows:

• Compilação Nuitka extrema / nível comercial, compilações de menor tamanho ou inicialização mais rápida
• dist redução de pasta, análise de pegada de DLL, trocas de tamanho entre 32 bits e 64 bits
• Empacotamento Inno Setup com metadados completos e desinstalação limpa e sem resíduos

Esta habilidade visa otimização avançada de tamanho/inicialização — não conversão básica de "script para exe" em arquivo único.

Como Funciona

1. Confirme os parâmetros de compilação — nome do aplicativo, versão, publicador, nome do executável, diretórios de origem/saída, ícone. Nunca preencha automaticamente; pergunte ao usuário.
2. Verifique a compilação de origem — console desativado, LTO ativado, runtime VC++ presente.
3. Compile com Nuitka usando a estratégia de exclusão de módulos e plugins abaixo.
4. Reduza a pasta dist — remova símbolos de depuração, caches, testes e documentação, com salvaguardas para metadados necessários em tempo de execução.
5. Analise DLLs para encontrar e reduzir as maiores dependências.
6. Empacote com Inno Setup — compressão LZMA2 ultra, metadados completos, desinstalação sem resíduos e um redistribuível VC++ compatível com a arquitetura.

Exemplos

• "用 Nuitka 把这个 PySide2 项目打成最小体积的商业安装包" → execute o fluxo de trabalho completo: recomende 32 bits, exclua WebEngine/3D/Charts, reduza dist, empacote com Inno Setup.
• "我的 exe 有 400 MB，怎么瘦身到一半" → analise DLLs, mude para opencv-python-headless, remova opengl32sw, aplique redução dist.
• "安装后在纯净系统打不开" → garanta que o redistribuível VC++ de arquitetura correspondente esteja incluído no script Inno Setup.

Ideia Central

Aderir à abordagem "Modo de pasta Nuitka (dist) + Empacotamento Inno Setup". Recusar versão em arquivo único, recusar janela preta.

Referência de Caso Prático (Aplicação Desktop PySide2 de Nível de Produção, 323 MB, Incluindo OpenCV / Playwright)

Visão Geral do Projeto

• Tamanho Total: 323 MB
• Ferramenta de Empacotamento: PyInstaller 4.7 (32 bits)
• Dependências Principais: PySide2 (22.52 MB), OpenCV (62.38 MB), Playwright (76.74 MB)
• Versão Python: Python 3.8 (32 bits)
• Número de DLLs: 71, totalizando 93.23 MB

Estratégias Chave de Otimização

1. PASS: Usar Python 32 bits → Redução de tamanho de 20-30%
2. PASS: Compressão do padrão de biblioteca base_library.zip → 0.74 MB
3. PASS: Exclusão de Módulos Essenciais → Sem pytest/unittest/setuptools
4. PASS: Exclusão de Plugins Qt Essenciais → Apenas plugins necessários

Distribuição de Tamanho

Comparação de Efeito Esperado

Fluxo de Trabalho Principal (Workflow) - ATENÇÃO: Executar Rigorosamente

Ao solicitar o empacotamento, siga estas etapas:

Etapa 1: Confirmação Forçada de Parâmetros (FALHA: Proibido usar valores padrão)

ATENÇÃO: Regra Importante: Todos os parâmetros abaixo devem ser confirmados com o usuário um por um, proibido preenchimento automático ou uso de valores padrão!

Você deve perguntar e confirmar as seguintes informações com o usuário (continue somente após a resposta explícita do usuário):

Modelo de Pergunta:

"Por favor, forneça os seguintes parâmetros de empacotamento, preciso que você confirme um por um:

1. Nome do Software:
2. Número da Versão:
3. Nome do Publicador/Empresa:
4. Nome do Arquivo Executável Principal (ex: xxx.exe):
5. Caminho da Origem (pasta Nuitka dist):
6. Caminho de Saída (local de salvamento do pacote instalador):
7. Caminho do Ícone (.ico, pode deixar em branco):
8. Endereço do Site Oficial (pode deixar em branco):

Por favor, preencha um por um, ou responda 'pular' para usar um valor vazio."

Etapa 2: Verificação da Qualidade e Compilação dos Arquivos de Origem (Crucial) Antes de gerar o código, você deve emitir a seguinte confirmação chave para o usuário (pois o Inno Setup é apenas uma ferramenta de empacotamento e não pode alterar os atributos de execução do programa em si):

"ATENÇÃO: Verificação dos Parâmetros de Compilação:

1. Sem Janela Preta: Por favor, confirme que sua pasta dist foi compilada usando nuitka --windows-console-mode=disable. (Caso contrário, uma janela preta ainda aparecerá após a instalação)
2. Alto Desempenho: Por favor, confirme se --lto=yes foi usado. (Caso contrário, a velocidade de inicialização pode não ser ideal)
3. Runtime: Por favor, certifique-se de que o runtime VC++ necessário já esteja incluído na pasta dist para evitar falhas em sistemas limpos.

Por favor, responda 'Confirmar' se os arquivos de origem estiverem prontos, caso contrário, recompile primeiro."

Etapa 3: Geração do Código Após a confirmação do usuário, gere o código com metadados completos e correção do ícone de desinstalação.

Otimização Extrema de Compilação Nuitka (Baseado na Experiência de Projetos de Referência)

I. Estratégia de Seleção 32 bits vs 64 bits

Razões para o Projeto de Referência Usar Python 32 bits:

Condições Recomendadas para Usar 32 bits:

• PASS: Ocupação de memória do programa < 2GB
• PASS: Não processa arquivos muito grandes (< 2GB)

…