Ir para o conteúdo

Primeiros passos

Espaço de trabalho e armazenamento

O diretório onde o Vukem Video guarda seus projetos, mídias e exportações, e como ele é protegido.

Última atualização:

O que você vai aprender#

  • o que é o espaço de trabalho e onde ele fica;
  • o que há dentro dele;
  • por que só um processo grava nele por vez.

A ideia#

Tudo o que o programa guarda fica em um único diretório, o espaço de trabalho. Ele é ~/.vukem-video, a menos que VUKEM_VIDEO_HOME diga outra coisa. Sua mídia original é copiada para ele uma única vez e guardada por conteúdo, então importar o mesmo arquivo duas vezes não adiciona nada, e apagar um projeto nunca apaga de surpresa a sua única cópia de um arquivo.

Text
<workspace>/
├── db.sqlite     projetos, histórico, tarefas
├── store/        os originais importados, por hash de conteúdo
├── artifacts/    arquivos derivados: proxies, miniaturas, picos de áudio
├── exports/      vídeos exportados: exports/<project id>/<job id>.mp4
├── frames/       cache de quadros renderizados
├── backups/      cópias do banco feitas antes de uma migração
└── logs/

O layout completo está na seção 9 do SDD-000, no repositório.

Um dono por vez#

Exatamente um processo é o dono do espaço de trabalho e grava nele: o vukem-video serve, ou uma sessão do vukem-video mcp quando nenhum servidor está rodando. Todos os outros comandos, o editor e os agentes falam com esse dono por HTTP na sua máquina. Um segundo processo que não consegue alcançar o dono falha com E_WORKSPACE_LOCKED, que pode ser repetido com segurança.

Erros comuns#

  • Copiar o espaço de trabalho enquanto um servidor está rodando. Pare o servidor antes, ou copie apenas exports/.
  • Esperar que a lixeira seja uma pasta. A lixeira é um estado no banco de dados; os arquivos continuam onde estão.

Próximos passos#