Skip to Content
DocumentaçãoMigration Guide

Guia de Atualização do Synkra AIOS

🌐 EN | PT | ES

Este guia ajuda você a atualizar entre versões do Synkra AIOS.

Sumário

  1. Compatibilidade de Versões
  2. Checklist Pré-Atualização
  3. Procedimentos de Backup
  4. Processo de Atualização
  5. Verificação Pós-Atualização
  6. Procedimentos de Rollback
  7. Solução de Problemas

Compatibilidade de Versões

Versão Atual

Synkra AIOS v4.2.11 (Versão Estável Atual)

Caminhos de Atualização

Da VersãoPara VersãoTipo de AtualizaçãoDificuldade
v4.3.xv4.2.11MenorBaixa
v4.0-4.2v4.2.11MenorMédia
v3.xv4.2.11MaiorAlta

Requisitos do Sistema

  • Node.js: 20.0.0 ou superior (recomendado)
  • npm: 10.0.0 ou superior
  • Git: 2.0.0 ou superior
  • Espaço em Disco: mínimo de 100MB de espaço livre

Checklist Pré-Atualização

Antes de atualizar, certifique-se de que você:

  • Fez backup de todo o seu projeto
  • Documentou as configurações personalizadas
  • Listou todos os agentes e workflows ativos
  • Exportou quaisquer dados críticos
  • Testou a atualização em um ambiente de desenvolvimento
  • Informou os membros da equipe sobre a manutenção planejada
  • Revisou as notas de lançamento para mudanças que quebram compatibilidade

Procedimentos de Backup

1. Backup Completo do Projeto

# Criar backup com timestamp
tar -czf aios-backup-$(date +%Y%m%d-%H%M%S).tar.gz \
  --exclude=node_modules \
  --exclude=.git \
  .
 
# Mover para local seguro
mv aios-backup-*.tar.gz ../backups/

2. Exportar Configuração

# Salvar configuração atual
cp .aios-core/config.json ../backups/config-backup.json
 
# Salvar componentes personalizados
cp -r .aios-core/agents/custom ../backups/custom-agents/
cp -r .aios-core/tasks/custom ../backups/custom-tasks/

3. Documentar Estado Atual

# Registrar versão atual
npm list @synkra/aios-core/core > ../backups/version-info.txt
 
# Listar arquivos personalizados
find .aios-core -name "*.custom.*" -type f > ../backups/custom-files.txt

Processo de Atualização

Opção 1: Atualização In-Place (Recomendada)

# 1. Parar quaisquer processos em execução
# Fechar todas as integrações de IDE e agentes ativos
 
# 2. Atualizar para a versão mais recente
npm install -g @synkra/aios-core@latest
 
# 3. Executar comando de atualização
aios upgrade
 
# 4. Verificar instalação
aios --version

Opção 2: Instalação Limpa

# 1. Remover instalação antiga
npm uninstall -g @synkra/aios-core
 
# 2. Limpar cache
npm cache clean --force
 
# 3. Instalar versão mais recente
npm install -g @synkra/aios-core@latest
 
# 4. Reinicializar projeto
cd your-project
aios init --upgrade

Opção 3: Atualização Específica do Projeto

# Atualizar dependências do projeto
cd your-project
npm update @synkra/aios-core/core
 
# Reinstalar dependências
npm install
 
# Verificar atualização
npm list @synkra/aios-core/core

Verificação Pós-Atualização

1. Verificar Instalação

# Verificar versão
aios --version
 
# Verificar componentes principais
aios verify --components
 
# Testar funcionalidade básica
aios test --quick

2. Testar Agentes

# Listar agentes disponíveis
aios list agents
 
# Testar ativação de agente
aios test agent aios-developer
 
# Verificar dependências dos agentes
aios verify --agents

3. Verificar Configuração

# Validar configuração
aios config validate
 
# Revisar log de atualização
cat .aios-core/logs/upgrade.log

4. Testar Workflows

# Listar workflows
aios list workflows
 
# Testar execução de workflow
aios test workflow basic-dev-cycle

Procedimentos de Rollback

Se você encontrar problemas após a atualização:

Rollback Rápido

# Restaurar do backup
cd ..
rm -rf current-project
tar -xzf backups/aios-backup-YYYYMMDD-HHMMSS.tar.gz
 
# Reinstalar versão anterior
npm install -g @synkra/aios-core@<previous-version>
 
# Verificar rollback
aios --version

Rollback Seletivo

# Restaurar componentes específicos
cp ../backups/config-backup.json .aios-core/config.json
cp -r ../backups/custom-agents/* .aios-core/agents/custom/
 
# Reinstalar dependências
npm install

Solução de Problemas

Problemas Comuns

Falha na Instalação

# Limpar cache do npm
npm cache clean --force
 
# Tentar com log detalhado
npm install -g @synkra/aios-core@latest --verbose
 
# Verificar permissões do npm
npm config get prefix

Agentes Não Carregam

# Reconstruir manifestos dos agentes
aios rebuild --manifests
 
# Verificar dependências dos agentes
aios verify --agents --verbose
 
# Verificar sintaxe dos agentes
aios validate agents

Erros de Configuração

# Validar configuração
aios config validate --verbose
 
# Redefinir para padrões (cuidado!)
aios config reset --backup
 
# Reparar configuração
aios config repair

Problemas na Camada de Memória

# Reconstruir índices de memória
aios memory rebuild
 
# Verificar integridade da memória
aios memory verify
 
# Limpar e reinicializar
aios memory reset

Obtendo Ajuda

Se você encontrar problemas não cobertos aqui:

  1. Verificar Logs: Revise .aios-core/logs/upgrade.log
  2. Issues no GitHub: github.com/SynkraAI/aios-core/issues 
  3. Comunidade Discord: discord.gg/gk8jAdXWmj 
  4. Documentação: diretório docs

Notas Específicas por Versão

Atualizando para v4.2

Principais Mudanças:

  • Capacidades aprimoradas do meta-agente
  • Desempenho melhorado da camada de memória
  • Recursos de segurança atualizados
  • Processo de instalação simplificado

Mudanças que Quebram Compatibilidade:

  • Nenhuma (compatível com versões anteriores a partir da v4.0+)

Novos Recursos:

  • Melhorias no meta-agente aios-developer
  • Assistente de instalação interativo
  • Ferramentas de monitoramento de desempenho

Descontinuações:

  • Sintaxe de comandos legados (ainda suportada com avisos)

Última Atualização: 2025-08-01 Versão Atual: v4.2.11

Meta Agent CommandsNpx Install