O que file-archive-organizer faz?
Organize uma pasta local/pessoal bagunçada em uma árvore de diretórios clara lendo o conteúdo dos arquivos (não apenas os nomes). Use quando o usuário soltar uma pilha de arquivos ou pastas e pedir para 整理/归类/分类 (organizar/classificar/categorizar), especialmente com repetição ao longo do tempo. Abrange visualização de conteúdo para docx/xlsx/pptx/PDF/.doc legado, identificação em lote de imagens, prática de simulação (dry-run) com tabela de reversão e armadilhas específicas do Windows (aninhamento shutil.move, rmdir em área restrita, perícia de lixeira).
Como funciona
- Leitura de conteúdo – Em vez de confiar apenas em extensões ou nomes, a habilidade extrai metadados e texto de arquivos do Office (docx, xlsx, pptx, .doc), PDFs e identifica imagens em lote.
- Simulação (dry-run) – Antes de mover qualquer arquivo, uma simulação é executada e uma tabela de reversão é gerada, listando todas as operações propostas.
- Execução reversível – Após aprovação, a organização é executada. Um log completo é mantido para auditoria e possível reversão manual.
- Cuidados com Windows – Tratamento especial para:
shutil.moveem diretórios aninhados (evita travamentos)rmdirem áreas restritas (sandbox)- Recuperação forense de arquivos na lixeira
Plataformas suportadas
- Windows (recomendado)
- macOS
- Linux
Exemplo de uso
# Simulação (dry-run) de organização
organize --dry-run --source /caminho/pasta-baguncada --target /caminho/pasta-organizada
# Execução real
organize --execute --source /caminho/pasta-baguncada --target /caminho/pasta-organizada
Variáveis de ambiente
ORGANIZER_DRY_RUN– Define se a simulação é o padrão (true/false)ORGANIZER_LOG_PATH– Caminho para o arquivo de log
Recursos
Nota: Sempre execute uma simulação antes da organização real para evitar perda acidental de dados.