Guia de Desinstalação

🌐 EN | PT | ES

Este guia fornece instruções completas para desinstalar o Synkra AIOX do seu sistema.

Índice

Antes de Desinstalar
Desinstalação Rápida
Desinstalação Completa
Desinstalação Seletiva
Preservação de Dados
Remoção Limpa do Sistema
Resolução de Problemas na Desinstalação
Limpeza Pós-Desinstalação
Reinstalação

Antes de Desinstalar

Considerações Importantes

Aviso: Desinstalar o Synkra AIOX irá:

Remover todos os arquivos do framework
Excluir configurações de agentes (a menos que preservadas)
Limpar dados da camada de memória (a menos que backup seja feito)
Remover todos os workflows personalizados
Excluir logs e arquivos temporários

Checklist Pré-Desinstalação

Fazer backup de dados importantes
Exportar agentes e workflows personalizados
Salvar chaves de API e configurações
Documentar modificações personalizadas
Parar todos os processos em execução
Informar membros da equipe

Faça Backup dos Seus Dados

# Criar backup completo
npx aiox-core backup --complete

# Ou fazer backup manual dos diretórios importantes
tar -czf aiox-backup-$(date +%Y%m%d).tar.gz \
  .aiox/ \
  agents/ \
  workflows/ \
  tasks/ \
  --exclude=.aiox/logs \
  --exclude=.aiox/cache

Desinstalação Rápida

Usando o Desinstalador Integrado

A forma mais rápida de desinstalar o Synkra AIOX:

# Desinstalação básica (preserva dados do usuário)
npx aiox-core uninstall

# Desinstalação completa (remove tudo)
npx aiox-core uninstall --complete

# Desinstalação com preservação de dados
npx aiox-core uninstall --keep-data

Desinstalação Interativa

Para desinstalação guiada:

npx aiox-core uninstall --interactive

Isso solicitará:

O que manter/remover
Opções de backup
Confirmação para cada etapa

Desinstalação Completa

Etapa 1: Parar Todos os Serviços

# Parar todos os agentes em execução
*deactivate --all

# Parar todos os workflows
*stop-workflow --all

# Encerrar o meta-agent
*shutdown

Etapa 2: Exportar Dados Importantes

# Exportar configurações
*export config --destination backup/config.json

# Exportar agentes
*export agents --destination backup/agents/

# Exportar workflows
*export workflows --destination backup/workflows/

# Exportar dados de memória
*export memory --destination backup/memory.zip

Etapa 3: Executar o Desinstalador

# Remoção completa
npx aiox-core uninstall --complete --no-backup

Etapa 4: Remover Instalação Global

# Remover pacote npm global
npm uninstall -g aiox-core

# Remover cache do npx
npm cache clean --force

Etapa 5: Limpar Arquivos do Sistema

Windows

# Remover arquivos do AppData
Remove-Item -Recurse -Force "$env:APPDATA\aiox-core"

# Remover arquivos temporários
Remove-Item -Recurse -Force "$env:TEMP\aiox-*"

# Remover entradas do registro (se houver)
Remove-Item -Path "HKCU:\Software\Synkra AIOX" -Recurse

macOS/Linux

# Remover arquivos de configuração
rm -rf ~/.aiox
rm -rf ~/.config/aiox-core

# Remover cache
rm -rf ~/.cache/aiox-core

# Remover arquivos temporários
rm -rf /tmp/aiox-*

Desinstalação Seletiva

Remover Componentes Específicos

# Remover apenas agentes
npx aiox-core uninstall agents

# Remover apenas workflows
npx aiox-core uninstall workflows

# Remover camada de memória
npx aiox-core uninstall memory-layer

# Remover agente específico
*uninstall agent-name

Manter o Core, Remover Extensões

# Remover todos os plugins
*plugin remove --all

# Remover Squads
rm -rf Squads/

# Remover templates personalizados
rm -rf templates/custom/

Preservação de Dados

O Que Manter

Antes de desinstalar, identifique o que você quer preservar:

Agentes Personalizados

# Copiar agentes personalizados
cp -r agents/custom/ ~/aiox-backup/agents/

Workflows e Tasks

# Copiar workflows
cp -r workflows/ ~/aiox-backup/workflows/
cp -r tasks/ ~/aiox-backup/tasks/

Dados de Memória

# Exportar banco de dados de memória
*memory export --format sqlite \
  --destination ~/aiox-backup/memory.db

Configurações

# Copiar todos os arquivos de configuração
cp .aiox/config.json ~/aiox-backup/
cp .env ~/aiox-backup/

Código Personalizado

# Encontrar e fazer backup de arquivos personalizados
find . -name "*.custom.*" -exec cp {} ~/aiox-backup/custom/ \;

Script de Preservação

Crie preserve-data.sh:

#!/bin/bash
BACKUP_DIR="$HOME/aiox-backup-$(date +%Y%m%d-%H%M%S)"

echo "Criando diretório de backup: $BACKUP_DIR"
mkdir -p "$BACKUP_DIR"

# Função de backup
backup_if_exists() {
    if [ -e "$1" ]; then
        echo "Fazendo backup de $1..."
        cp -r "$1" "$BACKUP_DIR/"
    fi
}

# Backup de todos os dados importantes
backup_if_exists ".aiox"
backup_if_exists "agents"
backup_if_exists "workflows"
backup_if_exists "tasks"
backup_if_exists "templates"
backup_if_exists ".env"
backup_if_exists "package.json"

echo "Backup concluído em: $BACKUP_DIR"

Remoção Limpa do Sistema

Script de Limpeza Completa

Crie clean-uninstall.sh:

#!/bin/bash
echo "Desinstalação Completa do Synkra AIOX"
echo "================================="

# Confirmação
read -p "Isso removerá TODOS os dados do Synkra AIOX. Continuar? (y/N) " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
    exit 1
fi

# Parar todos os processos
echo "Parando todos os processos..."
pkill -f "aiox-core" || true
pkill -f "aiox-developer" || true

# Remover arquivos do projeto
echo "Removendo arquivos do projeto..."
rm -rf .aiox/
rm -rf agents/
rm -rf workflows/
rm -rf tasks/
rm -rf templates/
rm -rf Squads/
rm -rf node_modules/aiox-core/

# Remover arquivos globais
echo "Removendo arquivos globais..."
npm uninstall -g aiox-core

# Remover dados do usuário
echo "Removendo dados do usuário..."
rm -rf ~/.aiox
rm -rf ~/.config/aiox-core
rm -rf ~/.cache/aiox-core

# Limpar cache do npm
echo "Limpando cache do npm..."
npm cache clean --force

# Remover do package.json
echo "Atualizando package.json..."
npm uninstall aiox-core/core
npm uninstall aiox-core/memory
npm uninstall aiox-core/meta-agent

echo "Desinstalação concluída!"

Limpeza do Registro (Windows)

# Script PowerShell para limpeza no Windows
Write-Host "Limpando Synkra AIOX do Registro do Windows..."

# Remover do PATH
$path = [Environment]::GetEnvironmentVariable("PATH", "User")
$newPath = ($path.Split(';') | Where-Object { $_ -notmatch 'aiox-core' }) -join ';'
[Environment]::SetEnvironmentVariable("PATH", $newPath, "User")

# Remover chaves do registro
Remove-ItemProperty -Path "HKCU:\Environment" -Name "AIOX_*" -ErrorAction SilentlyContinue

# Remover associações de arquivo
Remove-Item -Path "HKCU:\Software\Classes\.aiox" -Recurse -ErrorAction SilentlyContinue

Write-Host "Limpeza do registro concluída!"

Resolução de Problemas na Desinstalação

Problemas Comuns

1. Permissão Negada

# Linux/macOS
sudo npx aiox-core uninstall --complete

# Windows (Executar como Administrador)
npx aiox-core uninstall --complete

2. Processo Ainda em Execução

# Forçar parada de todos os processos
# Linux/macOS
killall -9 node
killall -9 aiox-core

# Windows
taskkill /F /IM node.exe
taskkill /F /IM aiox-core.exe

3. Arquivos Bloqueados

# Encontrar processos usando os arquivos
# Linux/macOS
lsof | grep aiox

# Windows (PowerShell)
Get-Process | Where-Object {$_.Path -like "*aiox*"}

4. Remoção Incompleta

# Limpeza manual
find . -name "*aiox*" -type d -exec rm -rf {} +
find . -name "*.aiox*" -type f -delete

Desinstalação Forçada

Se a desinstalação normal falhar:

#!/bin/bash
# force-uninstall.sh
echo "Desinstalação forçada do Synkra AIOX..."

# Matar todos os processos relacionados
pkill -9 -f aiox || true

# Remover todos os arquivos
rm -rf .aiox* aiox* *aiox*
rm -rf agents workflows tasks templates
rm -rf node_modules/aiox-core
rm -rf ~/.aiox* ~/.config/aiox* ~/.cache/aiox*

# Limpar npm
npm cache clean --force
npm uninstall -g aiox-core

echo "Desinstalação forçada concluída!"

Limpeza Pós-Desinstalação

1. Verificar Remoção

# Verificar arquivos restantes
find . -name "*aiox*" 2>/dev/null
find ~ -name "*aiox*" 2>/dev/null

# Verificar pacotes npm
npm list -g | grep aiox
npm list | grep aiox

# Verificar processos em execução
ps aux | grep aiox

2. Limpar Variáveis de Ambiente

# Remover do .bashrc/.zshrc
sed -i '/AIOX_/d' ~/.bashrc
sed -i '/aiox-core/d' ~/.bashrc

# Remover de arquivos .env
find . -name ".env*" -exec sed -i '/AIOX_/d' {} \;

3. Atualizar Arquivos do Projeto

// Remover do package.json scripts
{
  "scripts": {
    // Remover estas entradas
    "aiox": "aiox-core",
    "meta-agent": "aiox-core meta-agent"
  }
}

4. Limpar Repositório Git

# Remover hooks git específicos do AIOX
rm -f .git/hooks/*aiox*

# Atualizar .gitignore
sed -i '/.aiox/d' .gitignore
sed -i '/aiox-/d' .gitignore

# Commitar remoção
git add -A
git commit -m "Remove Synkra AIOX"

Reinstalação

Após Desinstalação Completa

Se você quiser reinstalar o Synkra AIOX:

Aguardar a limpeza

# Garantir que todos os processos pararam
sleep 5

Limpar cache do npm
```
npm cache clean --force
```
Instalação limpa
```
npx aiox-core@latest init my-project
```

Restaurar a partir do Backup

# Restaurar dados salvos
cd my-project

# Restaurar configurações
cp ~/aiox-backup/config.json .aiox/

# Restaurar agentes
cp -r ~/aiox-backup/agents/* ./agents/

# Importar memória
*memory import ~/aiox-backup/memory.zip

# Verificar restauração
*doctor --verify-restore

Checklist de Verificação de Desinstalação

Obtendo Ajuda

Se você encontrar problemas durante a desinstalação:

Consulte a Documentação
- FAQ
- Resolução de Problemas
Suporte da Comunidade
- Discord: #uninstall-help
- GitHub Issues: Rotule com "uninstall"

Suporte de Emergência

# Gerar relatório de desinstalação
npx aiox-core diagnose --uninstall > uninstall-report.log

Lembre-se: Sempre faça backup dos seus dados antes de desinstalar. O processo de desinstalação é irreversível, e a recuperação de dados pode não ser possível sem backups adequados.

FilesExpand file tree

uninstallation.md

Latest commit

History