Como o Obituary funciona
A vida de um arquivo
- Registrar: atribua uma vida útil ao arquivo ou à pasta. O agente usa
obit add debug.log 2h; você pode escolher “Add to Obituary” no menu de contexto do Explorador de Arquivos. Veja O que é registrado. - Expirar:
obit listmostra quanto tempo resta. Antes do vencimento,obit extendprolonga o prazo eobit sparecancela o acompanhamento sem excluir o arquivo. - Enterrar: quando o prazo termina, o item vai para o cemitério (
obit graveyard), onde fica por sete dias por padrão. - Ressuscitar ou excluir permanentemente: durante a retenção,
obit resurrect <id>devolve o item ao lugar de origem sem sobrescrever nada. A exclusão permanente (obit purge) só ocorre depois desse prazo.
Não sabe se ainda vai precisar de algo? Use obit bury para enterrá-lo agora. Durante sete dias você poderá restaurá-lo como estava.
Onde fica o cemitério
O cemitério fica sempre na mesma unidade que o arquivo. Na unidade do diretório de dados, usa-se o cemitério desse diretório. Nas demais, usa-se a pasta oculta .obituary na raiz. Assim, o enterro é uma simples renomeação: é rápido e não corre o risco de mover só parte do conteúdo.
Você pode mudar o prazo de retenção nas configurações ou mandar os itens diretamente para a Lixeira do sistema. Nesse caso, restaure pela Lixeira; obit resurrect não se aplica:
[graveyard]
mode = "graveyard" # or "recycle": straight to the system Recycle Bin
retention_days = 7 # days the graveyard keeps thingsO arquivo de configuração é %APPDATA%\obituary\config.toml. obit config mostra os ajustes e obit config --create cria um arquivo comentado com os valores padrão.
Por que outros arquivos não são excluídos
- Só a limpeza definitiva do túmulo exclui permanentemente. Cada enterro cria uma pasta de túmulo exclusiva e registra o ID dessa pasta. Antes de excluir permanentemente ou ressuscitar, o Obituary verifica se a pasta ainda é a mesma, se contém exatamente um item e se o item é o objeto enterrado. Assim, nem um registro danificado nem um cemitério substituído por um link podem levar à exclusão de algo fora do cemitério.
- O item só é ressuscitado no local de origem. Se o nome estiver ocupado, nada é sobrescrito. O item volta ao lado, com um nome como
name (resurrected).ext; os dois são mantidos e o resultado mostra o caminho real. Uma pasta pai excluída é recriada. Se uma pasta pai virou uma junção ou link simbólico, se uma junção mudou de destino ou se a letra da unidade passou a apontar para outro volume, a operação é recusada e o túmulo permanece intacto. - O que conta é o arquivo, não o nome. Cada entrada guarda o número de série do volume e o ID do arquivo de 128 bits. Assim o Obituary reconhece um arquivo movido ou renomeado e não toca em outro que tenha ocupado o caminho antigo. A identidade é verificada de novo logo antes da exclusão. Arquivos com mais de um link físico são recusados.
- Caminhos protegidos. Raízes de unidades,
C:\Windows, Program Files, ProgramData, perfil do usuário, Área de Trabalho, Documentos, Downloads e pastas semelhantes, bem como suas pastas pai, são protegidos, inclusive quando redirecionados. É possível atribuir vida útil ao conteúdo dessas pastas, mas não às próprias pastas. - Repositórios Git. Se a pasta contiver
.gitem qualquer nível,obit addeobit buryexigem--force. A verificação se repete ao expirar. Se não puder ser concluída, o enterro é recusado. - Na dúvida, não exclui. Uma entrada só é descartada quando há confirmação de que o arquivo não existe mais. Em caso de acesso negado, volume desconectado ou erro semelhante, o Obituary tenta novamente. Os intervalos começam em um minuto e crescem até um dia. Após 12 falhas consecutivas, ele para e aguarda sua decisão. O motivo aparece em
obit liste em “Burials that failed” na página For you. Useobit extend <id> 1m(“Retry”) para tentar de novo ouobit spare <id>(“Stop tracking”) para deixar o item onde está. Antes de enterrar uma pasta grande, ele procura repositórios Git por até 30 segundos. Só enterra se a busca terminar sem encontrar nenhum. Se não terminar, tenta novamente mais tarde; uma pasta com repositório não é enterrada. - Todas as operações ficam registradas. Cada registro, extensão, cancelamento e exclusão entra no log de auditoria (
obit log).
Execução em segundo plano
Por padrão, obitd.exe inicia no login, fica na bandeja e enterra os itens na hora prevista, com precisão de segundos. O ícone da bandeja é sua única interface. Como alternativa, uma tarefa agendada do Windows executa obitd --once a cada cinco minutos e em cada login. Assim, mesmo que a bandeja seja fechada ou nunca tenha sido iniciada, os itens vencidos são enterrados e os túmulos cujo período de retenção terminou são excluídos permanentemente. Os hooks também executam uma verificação no início e no fim da sessão. Para fazer isso agora, use obit reap.
obit daemon enable # tray at login plus the fallback scheduled task (--dry-run lists what would be installed)
obit daemon status # current mode and the next expiry (--json)
obit daemon disable # remove the scheduled task and login start, and stop the running daemon (--dry-run previews)Consultas como list, graveyard, stats e log são somente leitura e nunca enterram nada.
Onde ficam os dados
%LOCALAPPDATA%\obituary contém store.json (registro), audit.jsonl (log de auditoria), obitd.log (log do daemon) e graveyard\ (cemitério desta unidade).
Para mudar os locais, use OBIT_HOME (dados), OBIT_CONFIG_DIR (configuração) e OBIT_USER_HOME (pasta pessoal do usuário).