[MarkSant]

Três lacunas no intervalo entre o duplo-clique e a primeira análise. A
investigação corrigiu a premissa de duas delas.

1. O ícone parecia morto por ~4 s

Não era o benchmark. De logs/analysis.log de uma execução real:

Instante	Evento
22:42:12	application.starting
22:42:15	benchmark.running_first_time
22:42:15	benchmark.completed — duration_s: 0.2

O vão está antes do benchmark. O splash era criado na linha 138 de
app_runner, depois do bloco de imports das linhas 122–135. Dois custos
com cara de import comum estavam na frente dele:

• from zebtrack.utils import set_seed — zebtrack.utils importa torch em
  corpo de módulo, ~1,1 s (medido com python -X importtime).
• o bloco di_registrations — puxa ultralytics, cv2 e matplotlib por cima do
  torch, ~3 s.

O splash agora é construído logo após i18n.install(), antes dos dois.
tests/core/test_app_runner_splash_ordering.py fixa a ordem, não a
duração: uma asserção de tempo seria instável e não diria por que regrediu.

2. O benchmark não media nada — e cacheava isso

As etapas 3–5 são guardadas por if video_path and model_path and profile.openvino_available. Numa instalação nova openvino_model_cache/ não
existe, então _find_openvino_model() devolvia None e todas eram
puladas: 0,2 s no total, recomendando CPU a 0.0 FPS — resultado que ia para
o cache e nunca mais era recalculado.

Agora converte um modelo para OpenVINO antes de medir (nova etapa 2 de 7). Não
é sobrecarga: é trabalho que a aplicação pagaria de qualquer forma no primeiro
uso real do OpenVINO. Um resultado que ainda assim não mediu nada é marcado
inconclusivo e não vai para o cache.

As 7 etapas também ganharam tempo mínimo em tela. Elas sempre foram enviadas
ao splash — a fiação estava certa — mas várias terminam em milissegundos e eram
pintadas e sobrescritas dentro do mesmo quadro, então a sequência só existia no
log.

Ancorei também em repo_root() os três caminhos que eram relativos ao CWD
(get_benchmark_cache_path, _find_test_video, _find_openvino_model): pelo
atalho concordavam por sorte — o .lnk fixa WorkingDirectory — mas de outro
diretório --reset apagava um arquivo e o app escrevia outro.

3. A instalação trazia 4 dos 6 pesos

A razão registrada no código era circular: os generalistas ficavam de fora do
download porque WeightManager não sabia descobri-los — a varredura pegava
só best_*_lateral.pt e best_*_topdown.pt, então eles caíam em weights/ e
nunca apareciam no catálogo. O defeito real era a lacuna de descoberta;
corrigida (discover_weights() varre best_*.pt), o download deixou de
precisar modelá-la. --all continua aceito e agora não muda nada.

Um generalista nunca toma um slot padrão — os especialistas são treinados
para um ângulo de câmera específico, e um modelo lateral numa cena de topo não
devolve nada.

4. Nenhuma orientação inicial

O painel de configuração de modelos não tinha entrada de menu nenhuma: era
alcançável só por um botão dentro da visão de projeto. A única tela que o
operador precisa antes da primeira análise era a que ele não conseguia achar.

Nova janela de primeiros passos depois da principal, que lê o hardware
detectado em vez de dar conselho genérico ("use OpenVINO se não tiver NVIDIA"
é verdade e inútil para quem não sabe o que tem). Mais Configurações →
Definições de modelo... e Ajuda → Primeiros passos....

A caixa "não mostrar novamente" grava apenas ui.show_welcome via
write_local_override() — nunca save_settings, que congelaria a árvore
inteira de defaults em config.local.yaml.

Release

Versão para 7.1.0, CHANGELOG e docs/releases/RELEASE_NOTES_v7.1.0.md.
weights_manifest.json continua apontando para v7.0.0 de propósito: esse
release está publicado e já carrega os seis pesos com os tamanhos exatos do
manifesto, então fetch-weights funciona no instante do merge, sem depender de
publicar o v7.1.0.

Verificação

• pytest -q — 6751 passed, 4 skipped
• pytest -m gui -n0 — 1224 passed
• ruff check . e mypy . — limpos (907 arquivos)
• mutation_check --changed-since origin/main — 8/8 (100%), sem sobreviventes
• pre-commit run --all-files — verde
• Traduções pt_BR anexadas à mão (26 entradas) e verificadas em runtime, não só compiladas

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 67.29858% with 69 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/zebtrack/utils/hardware_benchmark.py	24.44%	34 Missing ⚠️
src/zebtrack/core/app_runner.py	53.57%	13 Missing ⚠️
src/zebtrack/ui/gui.py	10.00%	9 Missing ⚠️
src/zebtrack/ui/dialogs/welcome_dialog.py	93.81%	6 Missing ⚠️
src/zebtrack/ui/splash_screen.py	33.33%	6 Missing ⚠️
src/zebtrack/ui/components/menu_manager.py	75.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!