FPV Viewer (f95zone-tools)
Resumo
O FPV Viewer é um componente local do projeto f95zone-tools, localizado em C:\Users\Yanbd\dev\f95zone-tools. Segundo o registro de execução de 2026-08-24, sua interface foi refatorada para servir dados por HTTP e acompanhar operações de scraping de forma progressiva.
Arquitetura registrada
fpv_viewer.bat: ponto de entrada com validação de pré-requisitos, inicialização do servidor, abertura do navegador, limpeza de cache e verificação de arquivos.scripts/fpv_viewer_server.py: servidor HTTP; cuida da migração do cache SQLite, validação de payloads, cabeçalhos anti-cache e estado inicial da interface.scripts/fpv_viewer_scraper.py: coleta HTTP com pool de conexões, tentativas de repetição, expressões regulares pré-compiladas e tratamento de remoções/DMCA.scripts/fpv_template.html: interface e filtros; recebe progresso por Server-Sent Events (SSE).scripts/fpv_viewer.py: wrapper de compatibilidade para o servidor.
DecisƵes e cuidados operacionais
- O cache SQLite deve preservar compatibilidade com dados anteriores por meio de migração automÔtica.
- HTML, JSON e SSE usam cabeçalhos anti-cache para reduzir a exibição de estado desatualizado no navegador.
- A coleta aceita a opção
threads; seu uso deve ser limitado conforme a capacidade do destino e os termos aplicÔveis. - Detecções de remoção ou DMCA são sinais de indisponibilidade do conteúdo, não evidência para tentar contornar controles de acesso.
Correção de carregamento e streaming (2026-10-12)
Um registro local de manutenção relata a correção de falhas que deixavam o viewer sem filtros pré-carregados e sem cards após uma coleta geral, apesar de o scraper obter resultados.
- O estado inicial da interface deve ser injetado antes da execução do JavaScript da aplicação; a injeção ao fim do
bodyfazia a aplicação inicializar categorias, redes e vĆdeos como listas vazias. - A rota SSE de coleta geral deve encaminhar o callback de pĆ”gina ao scraper e emitir eventos
page; o frontend monta cards a partir desses eventos, não apenas do evento finaldone. - A inicialização do servidor deve chamar o carregamento de dados persistidos para restaurar resultados e avaliações salvos.
- O filtro de duração precisa comparar unidades equivalentes: a duração parseada estÔ em segundos, enquanto a entrada do usuÔrio representa minutos.
- Quando o estado embutido estiver vazio, a interface deve ter fallback por REST para restaurar os dados disponĆveis.
Esses itens são decisões de manutenção registradas, não uma garantia de que a instalação local continua em conformidade; revalidar o repositório antes de alterações futuras.
Normalização dos filtros de estúdio e rede (2026-10-12)
Um segundo registro local de manutenção descreve a correção do caso em que combinar uma tag com a rede Adult Time retornava zero resultados, embora a coleta encontrasse vĆdeos correspondentes. A causa principal foi a comparação direta entre slugs selecionados pela interface e nomes exibidos pelos dados: por exemplo, adult-time nĆ£o coincidia com Adult Time.
- ComparaƧƵes de estĆŗdios, redes e performers devem normalizar os dois lados antes de testar inclusĆ£o, tratando hĆfens, espaƧos e capitalização de forma equivalente.
- Redes devem manter a classificação de
network, e não ser reduzidas asite, para que seus subcanais possam ser expandidos e filtrados. - A coleta paginada não deve encerrar na primeira pÔgina sem resultados para uma tag; deve tolerar pÔginas sem correspondências antes de concluir que não hÔ resultados.
- O resultado da coleta deve ser validado tanto no scraper quanto na filtragem do navegador, pois um resultado disponĆvel no backend pode ser removido silenciosamente pelo cliente.
O registro cita Adult Time e seu subcanal Pure Taboo apenas como caso de teste de classificação e normalização. Não registra acesso a conteúdo, credenciais nem mecanismo de contorno de controles.
Validação registrada
O relato de execução informa que py_compile foi aplicado aos trĆŖs módulos Python, o JavaScript extraĆdo do template passou em node --check, e o servidor foi testado localmente em http://127.0.0.1:8100 com endpoints de categorias, sites, perfis e subcanais de rede. Esta nota registra o resultado relatado; ela nĆ£o substitui uma nova validação no repositório quando houver manutenção.
Documentação relacionada no projeto
docs/fpv_viewer_audit.mddocs/fpv_viewer_refactor_log.mddocs/fpv_viewer_maintenance.md
RelaƧƵes no vault
Fontes
- Registro local de execução do knowledge-capture, lote
batch-93b44b0e937c4448bf55292dee0d7afe.json, consultado em 2026-08-24. - Registro local de manutenção do knowledge-capture, lote
batch-b1c1f7b8f5414288a2f0f7e906ee3611.json, consultado em 2026-10-12. - Registro local de manutenção do knowledge-capture, lote
batch-cbe8d264eb3c428696685cd8b1f42d90.json, consultado em 2026-10-12. - Código e documentação local referenciados em
C:\Users\Yanbd\dev\f95zone-tools(devem ser revalidados antes de decisƵes futuras). - Using server-sent events ā MDN Web Docs, consultado em 2026-08-24 ā referĆŖncia para a tecnologia SSE mencionada na arquitetura.
- sqlite3 ā DB-API 2.0 interface for SQLite databases ā Python documentation, consultado em 2026-08-24 ā referĆŖncia para o banco local mencionado no registro.