Seu AB PostInstall, sem mistério.

Primeiros passos

O AB PostInstall organiza o que você quer fazer depois de instalar o Windows. Marcar um item apenas prepara a seleção; a execução começa pelo Play individual ou pela fila.

1. Abra AB PostInstall.exe em uma pasta local.
2. Escolha um perfil ou use Criar perfil.
3. Em Programas, marque os itens desejados e confira a aba Seleção.
4. Use Iniciar para revisar a fila; acompanhe os resultados no Monitor.

Conheça a interface

1. As capturas mostram o ambiente real; perfis, caminhos, números e estados são exemplos e podem variar.
2. Slogan, site e versão ficam no cabeçalho; Telegram e Donate abrem seus respectivos links. Tema e idioma ficam à direita.

Referência das funções

• Cabeçalho: site, Telegram e Donate abrem os links correspondentes. O livro abre a ajuda; os controles à direita minimizam, maximizam/restauram e fecham a janela. Os indicadores mostram CPU, memória, unidade, Windows e usuário do computador atual.
• Tema: escolha uma aparência no seletor. Personalizar permite alterar cores de fundo, painel, bordas, textos, destaque, foco, estados e níveis de acesso; Restaurar retorna à base do tema. Aplicar valida o contraste; Cancelar descarta o rascunho.
• Idioma: escolha PT, ES, EN ou uma tradução pessoal. Exportar modelo pede tag, nome e autor opcional e salva um JSON para traduzir. Carregar valida o JSON (até 2 MiB), mostra cobertura, idioma base e chaves ignoradas, pede confirmação e copia para Traducoes. Textos ausentes usam o idioma base; Ajuda explica o formato. Cancelar preserva o idioma atual.

Programas: Local, Extras e Online

Em Local, o AB PostInstall usa os arquivos configurados no catálogo. Em Online, consulta o catálogo AB Premium ou a fonte JSON escolhida para instalar os aplicativos pelo gerenciador de pacotes disponível.

1. Abra Programas e escolha uma sub-aba: Local, Extras ou Online.
2. Filtre por categoria ou use a pesquisa da sub-aba em que você está.
3. Leia o resumo e abra Info para detalhes. O ícone de link abre o site cadastrado quando houver.
4. Marque para a fila, ou use o Play da linha para executar somente aquele item.

Seu próprio catálogo Online

1. Na sub-aba Online, clique na engrenagem ao lado das sub-abas. Escolha AB Premium (padrão), Arquivo JSON local… ou Link HTTPS…. A marca indica a fonte atual; Ajuda explica o formato.
2. Use JSON UTF-8 no formato indicado em Ajuda, até 1 MB. Cada chave deve ser única, com letras, números, _ ou -. content é o nome e category a categoria; informe winget e/ou choco com IDs válidos. description e link HTTPS são opcionais; vários IDs são separados por vírgulas.
3. Não forneça comandos, argumentos ou scripts: não serão executados pelo catálogo. O link da fonte deve devolver diretamente JSON por HTTPS, sem login nem redirecionamentos.
4. JSON local também precisa de internet para instalar os pacotes. Mover o arquivo ou mudar a letra da unidade pode invalidar a fonte. Importar não marca nem instala aplicativos.
5. Uma falha conserva a fonte anterior. Ao trocar de catálogo, seleções da outra fonte podem ficar ausentes; revise a aba Seleção. Durante execução, só Ajuda fica disponível nesse menu.

{
  "sevenzip": {
    "content": "7-Zip",
    "category": "Utilitários",
    "description": "Compactador de arquivos",
    "link": "https://www.7-zip.org/",
    "winget": "7zip.7zip",
    "choco": "7zip"
  }
}

Referência das funções

• Pesquisa e filtros: abra a lupa, digite o nome ou texto procurado e revise os resultados antes de marcar. Categoria limita a lista; A–Z organiza a apresentação. O checkbox Todos marca/desmarca os itens elegíveis do contexto atual. Itens incompatíveis ou indisponíveis continuam sujeitos às regras de seleção.
• Ações da linha: checkbox prepara a fila; Info abre descrição e detalhes; Site abre o endereço do item; Play executa só o item e as dependências obrigatórias. O selo de acesso abre o link correspondente quando disponível. Em Local, escolha 32/64 bits quando permitido; a opção Usar arquitetura automática neste perfil remove a escolha manual.

Escolher e revisar itens

A caixa à esquerda inclui ou retira um item da fila. A aba Seleção reúne o que foi marcado em Programas, Extras e Otimizações.

• A caixa Todos marca os itens do contexto mostrado; desmarcá-la retira todos, incluindo o ponto de restauração inicial em Local. Confira a sub-aba e o filtro antes de usá-la.
• A–Z organiza a apresentação, não a ordem de execução.
• Quando existem variantes 32 e 64 bits, escolha a que corresponde ao item e ao sistema. O AB PostInstall não inventa argumentos de instalação.
• Itens indisponíveis ou incompatíveis precisam ser revistos antes da execução.

Uma fila, uma ordem

1. Local, Extras, Online e Otimizações compartilham a fila numerada. O ponto de restauração inicial, quando marcado, fica fixo na primeira posição.
2. Para reordenar, use as setas ao lado do número, arraste o item acima/abaixo de outro ou escolha Ordem, F2 ou duplo clique para informar a posição. As dependências obrigatórias são preservadas; a mudança fica bloqueada durante execução.
3. A ordem é salva no perfil. A caixa Todos marcada seleciona o contexto atual; desmarcada retira a seleção.

Referência das funções

• Dependências e conflitos: selecionar um item pode exigir outros ou pedir confirmação para remover incompatíveis. Leia a revisão apresentada. Salvar e Iniciar verificam os problemas da seleção; não basta arrastar para uma posição que viole dependências. O ponto de restauração inicial permanece primeiro.

Play, fila e Monitor

Play executa um item. Iniciar prepara a fila dos itens marcados. O Monitor acompanha progresso, mensagens, console integrado quando disponível e resultados.

1. Confira os itens selecionados e a opção Ao finalizar.
2. Clique em Iniciar e revise a prévia e os avisos antes do início.
3. Durante a fila, acompanhe o Monitor. Parar após o atual evita os próximos itens; Forçar encerramento é último recurso.
4. Leia o resultado de cada linha. Processo encerrado não significa, sozinho, instalação comprovada.

Revise antes da contagem terminar

1. A prévia da fila pode iniciar automaticamente após a contagem. Use Cancelar antes de ela terminar se precisar alterar a seleção. Iniciar agora antecipa a execução.
2. As capturas mostram uma execução real de exemplo, não uma garantia de resultado para outros pacotes ou computadores.
3. O console acompanha novas mensagens quando você está no fim. Ao rolar para cima, preserva a leitura e a seleção; volte ao fim para retomar o acompanhamento automático.

Referência das funções

• Monitor: título e subtítulo mostram a tarefa/situação; cartões e gráficos exibem CPU, RAM, discos e GPU disponíveis. Console registra a saída e permite selecionar/copiar texto e rolar. Detalhes abre o relatório da execução. Parar após atual aguarda a tarefa atual e evita as próximas; Forçar encerramento pode deixar a tarefa incompleta. Voltar retorna à lista quando permitido.
• Ao finalizar: Manter aberto, Fechar aplicativo, Reiniciar ou Desligar define o que acontece ao terminar a fila completa. Escolha antes de Iniciar. Play individual permanece aberto e não aplica essa ação final. Revise a prévia e a contagem; Cancelar evita iniciar e Iniciar agora antecipa.

Perfis: repetir sem remontar

Um perfil guarda escolhas, preferências de arquitetura, Extras e opções da fila. Ele não executa nada ao ser salvo.

1. Clique no ícone Criar perfil para preparar um novo rascunho. Selecione os itens; ao salvar, informe o nome e confirme.
2. Faça a seleção e use Salvar. Para uma cópia independente, use Salvar como….
3. Escolha o perfil no seletor superior quando quiser retomá-lo. Revise a lista antes de iniciar.

O perfil Padrão (referência) serve de base. Aceites de avisos irreversíveis podem ser guardados no perfil, conforme o fluxo do AB PostInstall; uma escolha nova ainda requer atenção.

Ícones e nome do perfil

1. Ao lado do seletor ficam os ícones Criar perfil, Salvar, Salvar como e Excluir perfil. Passe o cursor para ler a função. O Iniciar da fila fica no rodapé.
2. Criar perfil prepara um rascunho. Selecione os itens e use Salvar; informe o nome no diálogo centralizado. Uma entrada inválida mostra o erro no próprio diálogo e mantém o texto para correção.

Referência das funções

• Perfis: o seletor abre os salvos; Criar prepara um rascunho, Salvar grava as escolhas e Salvar como cria uma cópia com outro nome. Renomear altera o nome; a lixeira exclui o perfil após confirmação. O Padrão é referência protegida. Ao trocar ou fechar com alterações pendentes, responda à pergunta de salvar/descartar/cancelar.
• Importar perfil do MInstall: escolha o arquivo do MInstall e confira a prévia de correspondências, ausentes e ambiguidades. Normal importa os reconhecidos; Admin pode oferecer criar os ausentes. Só confirme após revisar. O arquivo de origem é preservado e a importação não executa instaladores.

Extras: tarefas além de programas

Extras reúne tarefas configuradas ou descobertas, como executáveis, scripts, arquivos de registro, cópias e ações de firewall.

• Marque um Extra para colocá-lo na fila ou use seu Play individual quando disponível.
• O resumo ajuda a identificar a tarefa; abra Info para a descrição completa, quando existir.
• Descobrir, selecionar ou editar um Extra não o executa.
• Arquivo ausente ou não confirmado não deve ser considerado pronto.

Onde está Extras?

1. Abra Programas e escolha a sub-aba Extras, entre Local e Online. A função continua a mesma; apenas a navegação mudou.
2. EXE, MSI, CMD e BAT mantêm suas janelas visíveis quando o próprio programa as oferece. REG pode ser silencioso. Confira a posição dos Extras na aba Seleção e leia o resultado no Monitor.

Referência das funções

• Extras: atualize a leitura da pasta e consulte Ajuda/Info para tipos, origem e diagnósticos. Editar permite Nome, Descrição, Argumentos, pasta de trabalho, automação INI, destino de cópia e política de conflitos quando aplicáveis. Restaure dados herdados ou confira Personalizações de Extras. A fila usa a ordem central em Seleção; opções antigas de momento não definem mais a execução.
• Um Extra pode executar um arquivo ou copiar conteúdo, conforme seu tipo. Para cópia, confira destino e política ignorar/perguntar/substituir. A automação INI define as instruções automáticas do Extra. Confira o resultado de cada tarefa no Monitor.

Adicionar um arquivo por arraste

Em Programas → Local ou Programas → Extras, arraste um arquivo válido para a lista ou use Adicionar arquivo… no menu contextual.

1. Solte um arquivo .exe, .msi, .cmd, .bat ou .reg. Pastas não entram nesse fluxo.
2. Ao soltar, escolha a cópia para a unidade do AB PostInstall. A cópia é recomendada para portabilidade.
3. Revise o editor já preenchido: nome tratado, caminho, comando, versão e ícone quando detectáveis. Em Programas, também é possível criar categoria e subcategoria.
4. Aplique no editor e salve a alteração principal. O item novo fica apenas cadastrado, não selecionado nem executado.

Cadastro e caminhos portáteis

1. No catálogo padrão, soltar um arquivo mostra um aviso: crie um novo perfil ou use Admin para adicionar itens.
2. Em um perfil pessoal ou Admin, arraste um arquivo válido em Local/Extras. A camada verde leva à escolha de cópia e ao editor; sair cancela o gesto.
3. Copiar é recomendado; Manter original existe só em Local. Campos de caminho usam {AppDir} dentro da pasta de programas configurada ou {Disk} na mesma unidade, inclusive sem copiar. Outra unidade mantém caminho absoluto. Um EXE pode depender de arquivos vizinhos que não são copiados automaticamente.
4. Aplicar e Salvar apenas cadastram. O item não é selecionado nem executado automaticamente. Se Windows bloquear o arraste entre níveis de elevação, use Adicionar arquivo no menu contextual.

Atualizar arquivos, não instalar programas

A aba Atualização consulta versões e substitui arquivos elegíveis. Isso é diferente de executar seus instaladores.

1. Clique em Verificar atualizações para consultar a API.
2. Compare versão local e remota e marque as linhas de programas elegíveis.
3. Use Atualizar (N). O AB PostInstall prepara downloads por HTTPS e verifica tamanho e SHA-256 quando publicados.
4. Confira a solicitação de administrador, o resultado e qualquer orientação de recuperação.

Os arquivos oficiais do aplicativo e do catálogo são tratados separadamente das receitas opcionais. Verificar consulta; não instala programas e não muda seu perfil.

Referência das funções

• Fontes pessoais: JSON UTF-8 até 1 MiB e 4096 entradas, com ID Local existente, arquitetura x86/x64/any e URL HTTPS direta, sem login/redirecionamento. Elas atualizam somente instaladores Local; não atualizam o aplicativo, catálogo oficial, Extras ou Online. Vínculos manuais prevalecem para o mesmo ID/arquitetura. Não forneça comandos ou destinos no JSON; o destino vem do catálogo e deve ficar dentro da pasta de programas configurada. A escolha só é salva após validar; erro preserva a fonte anterior.
• Config de Atualização: escolha AB Premium, JSON local ou link HTTPS para JSON. Links diretos cadastra, edita ou remove vínculos de instaladores Local por item e arquitetura; informe URL HTTPS, versão e SHA-256 quando disponíveis e confira o destino. Sem versão não há comparação; sem hash não há SHA-256 de referência. Remover vínculo preserva o arquivo existente. Ajuda mostra o formato.
• Verificar consulta a fonte; revise versão, arquitetura, destino e situação de cada linha. Marque as permitidas e use Atualizar. Durante preparação/aplicação, acompanhe os estados e ações disponíveis; ao concluir, confira falhas e resultados. Atualizar instaladores baixa arquivos, não instala programas. A atualização do próprio AB PostInstall usa o auxiliar UpdateAB para substituir/reabrir o aplicativo.

{
  "schema_version": 1,
  "items": [
    {
      "item_id": "ID-LOCAL",
      "architecture": "x64",
      "download_url": "https://example.com/setup.exe",
      "version": "1.2.3"
    }
  ]
}

Quando o WinGet não estiver disponível

A sub-aba Online pode indicar a ausência do WinGet e oferecer Instalar/reparar WinGet. Esse comando usa o reparo que também aparece em Otimizações.

1. Leia o aviso e execute o reparo pelo botão da sub-aba Online, se desejar.
2. Acompanhe o resultado no Monitor. Depois, tente o Play ou a fila novamente.
3. Em execução automática por parâmetros, o AB PostInstall faz esse preparo sem abrir uma pergunta no meio da fila e registra o aviso no Monitor.

Quando algo não funciona

Um item não inicia

Confirme se o arquivo existe, a arquitetura e o Windows são compatíveis e os argumentos foram testados. O Monitor distingue falha de iniciar, falha do processo e resultado ainda não confirmado.

Online não instala

Verifique conexão, WinGet/Chocolatey e os detalhes do pacote. O console integrado mostra a saída quando o gerenciador pode fornecê-la.

O antivírus alerta

Não desative a proteção por impulso. Confira origem, hash publicado e a mensagem exata; procure orientação antes de repetir.

Perfil ou catálogo sumiu

Confirme qual cópia de AB PostInstall.exe você abriu e onde estão ABpos.toml e Perfis. A estrutura mínima pode ter sido criada em outra pasta.

Referência das funções

• Indicadores e mensagens: passe o cursor sobre ícones para consultar a função, nível de acesso, disponibilidade ou situação dos Termos de Uso quando exibida. Estado indisponível significa que a informação não pôde ser verificada. Detalhes de Atualização e Monitor ajudam a distinguir acesso, rede, arquivo ausente e falha da tarefa; o fechamento de um processo não comprova sucesso.

Otimizações com controle

A aba Otimizações reúne ajustes de registro, serviços, energia, rede, aplicativos e manutenção. Selecionar não aplica: Play executa um item, e Iniciar reúne os marcados na fila.

• Mínimo, Padrão e Avançado são predefinições de seleção. Revise o que foi marcado; consentimentos já dados para uma predefinição não precisam reaparecer ao voltar a ela na mesma sessão.
• Todos mostra o catálogo completo; não marca todos os itens. Atuais consulta ajustes já identificáveis no sistema.
• Use a busca para localizar nome, descrição ou edição em todo o catálogo. O botão de configuração de certos itens, como DNS, mostra a escolha atual.
• Quando houver ação inversa segura, escolha Aplicar ou Desfazer antes do Play. Nem toda remoção de aplicativo/dados é reversível.

Referência das funções

• Otimizações: selecione a sub-aba, categoria e pesquisa. Mínimo/Padrão/Avançado são predefinições de seleção; Todos os ajustes mostra o catálogo e Atuais consulta os estados detectáveis. Na linha escolha Aplicar/Desfazer ou Remover/Reinstalar AppX quando disponíveis; engrenagem configura parâmetros como DNS e NTP. Info explica efeitos, avisos e disponibilidade. Salve ação e parâmetros no perfil; marque para a fila ou use Play.
• Antes de executar um ajuste, consulte Info para conferir sua disponibilidade e os requisitos do computador. Estado desconhecido não significa que o ajuste está desativado. Um Desfazer disponível não garante recuperação de arquivos ou preferências anteriores; confira o aviso específico.

Catálogo completo de otimizações

Abra os grupos para conhecer os ajustes e seus efeitos. Use Info no aplicativo para conferir requisitos e disponibilidade antes de executar.

Otimização AB Recomendada

Selecione a Otimização AB Recomendada para preparar os ajustes sugeridos. Confira cada item e desmarque o que não quiser aplicar antes de iniciar.

A recomendação inclui seus ajustes próprios de serviços e organização do ambiente, além de selecionar ações equivalentes já existentes. O plano de energia correspondente é selecionado quando disponível. A desativação do UAC é um item opcional separado, com aviso próprio.

O Easy Context Menu só é copiado quando o utilitário já está no local definido; não é baixado por essa recomendação. Alterações de atalhos e arquivos devem ser conferidas no Monitor.

Ponto de Restauração Inicial

O item Criar Ponto de Restauração Inicial pode entrar na seleção antes de outras ações. Ele tenta criar uma referência de recuperação do Windows.

1. Confira se a proteção do sistema está ativa e se há espaço suficiente.
2. Coloque a criação antes de alterações relevantes.
3. Leia o resultado no Monitor. Se a criação falhar, o AB PostInstall registra o motivo e a fila prossegue, conforme a política definida.

Modo Admin e catálogo

Modo Normal organiza escolhas pessoais. Modo Admin edita o catálogo compartilhado, com impacto potencial sobre vários perfis.

1. Faça cópia do ABpos.toml antes de uma edição ampla.
2. Use o menu contextual para criar, editar, duplicar ou excluir itens, categorias e subcategorias.
3. No editor, revise nome, resumo, descrição, caminhos, arquitetura, compatibilidade, argumentos e relações.
4. Aplicar modifica o rascunho. Salvar catálogo grava as mudanças. Fechar antes disso pode descartá-las.

O botão Sugerir modo silencioso… analisa parte de um EXE/MSI local sem executá-lo. A sugestão ainda precisa ser testada no instalador real. O ID aparece no editor e não deve ser reinterpretado como versão do programa.

Campos do editor

1. Os botões + permitem criar Categoria e Subcategoria em Local; Extras mantém a organização pelas pastas. Abrir… seleciona o instalador ou ícone.
2. Comando e Argumentos têm funções diferentes. Confira compatibilidade do Windows e arquitetura. Detecção x86 e x64 pode apontar para locais distintos; selecionar um arquivo não comprova que os argumentos estão corretos.

Referência das funções

• Ocultar: no menu contextual de um perfil editável, oculte item, subcategoria ou categoria. Itens ocultos permite conferir e restaurar a visibilidade. Ocultar não desinstala nem apaga o instalador. O perfil padrão bloqueia personalizações; crie um perfil ou use Admin para editar o catálogo compartilhado.
• Criar, Editar/F2 e Duplicar abrem um rascunho de item. Excluir/Delete depende do modo e da origem: Normal permite excluir objetos criados no perfil; Admin altera o catálogo. Categorias e subcategorias permite organizar os grupos. Aplicar muda o rascunho; Salvar grava no perfil ou catálogo conforme o modo.
• Restaurar dados do catálogo remove substituições pessoais do item. Personalizações / conflitos compara base anterior, base atual e valor local; permite revisar substituições ou remover objetos locais. Depois de atualizar o catálogo, confira entradas indisponíveis e conflitos antes de salvar.
• Editor: revise Nome, Resumo, Descrição, Edição, Categoria, Subcategoria, instalador, ícone, versão, Atualizável, Comando, Argumentos, URL, arquiteturas e Windows compatíveis. Caminhos/detecção gerais e específicos x86/x64 têm funções distintas; os específicos prevalecem na arquitetura correspondente. Versão identifica o instalador; edição identifica o nível do item.
• Ferramentas do editor: Abrir escolhe instalador/ícone; Localizar instalação pesquisa programas instalados; Selecionar arquivo instalado ajuda a preencher a detecção. Relações define Selecionar junto e Incompatível com. Macros lista variáveis; caminhos antigos e Limpar caminhos ajudam a revisar a portabilidade. Sugerir silencioso propõe argumentos: revise e teste antes de executar. Cancelar preserva os valores anteriores.

Abrir por parâmetros

Um perfil pode ser indicado por nome, ID curto ou caminho completo. O parâmetro /tN inicia a fila após N segundos, entre 0 e 3600.

AB PostInstall.exe perfil10.toml /t10
AB PostInstall.exe "E:\Perfis\Instalacao Inicial.toml" /t0
AB PostInstall.exe /edit perfil10.toml

• /perfil perfil explicita o perfil; /new abre criação; /edit [perfil] abre edição; /max maximiza.
• Coloque caminhos com espaços entre aspas. Perfil externo vale somente para essa execução.
• Na abertura manual, a fila pede elevação administrativa antes de começar. Em implantação automática por parâmetros, o processo iniciador deve já executar o AB PostInstall com acesso de administrador.

Referência das funções

• Use o nome real do executável entre aspas: "AB PostInstall.exe" perfil10.toml /t10. Perfil por nome, ID curto ou /perfil é aceito; caminho completo abre um .toml externo apenas nesta sessão. /new cria rascunho; /edit [perfil] abre edição local; /max maximiza. /t0 até /t3600 controla a contagem e não combina com /new ou /edit.

Pastas, caminhos e portabilidade

O manual pode ser copiado sozinho. Já o AB PostInstall, seu catálogo, perfis e instaladores cadastrados precisam permanecer em uma estrutura coerente.

Campos específicos aceitam {arch} para a arquitetura textual. Referências antigas como {Root} e {Patch} permanecem por compatibilidade, mas não são a escolha para novos cadastros. {arch} não é expandido em comandos arbitrários.

Escolher as pastas

1. O aplicativo inicia diretamente com Programas e Programas/Perfis ao lado do executável. Para mudar os destinos, use o ícone Configurar pastas entre Idioma e Ajuda.
2. Escolha a pasta dos programas. A pasta Perfis ficará dentro dela. AppDir, Disk e Perfis mostram os caminhos enquanto você digita. Caminhos em outra unidade dependem daquela unidade estar disponível.
3. Confira os caminhos exibidos. Salvar não move nem renomeia os arquivos existentes. Cancelar mantém a configuração anterior.

Referência das funções

• Configurar pastas: o aplicativo inicia diretamente usando Programas e Programas/Perfis ao lado do executável. Para alterar os locais, use o ícone entre Idioma e Ajuda. Digite ou escolha a pasta dos programas; Perfis acompanha essa pasta. Os valores AppDir, Disk e Perfis são exibidos enquanto você digita. {AppDir} usa a pasta dos programas; {Disk} usa a unidade do executável. ABpos.toml e UpdateAB.exe ficam ao lado de AB PostInstall.exe. Salvar não move arquivos. Confira os caminhos antes de confirmar; Cancelar preserva a configuração. A troca fica bloqueada durante operações em andamento.